云策 WordPress 开发者社区

函数文档

wp_doing_cron()

查看官方原文 ↗
💡 云策文档标注

概述

wp_doing_cron() 函数用于判断当前请求是否为 WordPress 的 cron 请求。它返回布尔值，并可通过 'wp_doing_cron' 过滤器进行自定义。

关键要点

  • 函数返回 true 表示当前是 WordPress cron 请求，否则返回 false。
  • 内部基于 DOING_CRON 常量定义进行判断，并应用 'wp_doing_cron' 过滤器。
  • 该函数自 WordPress 4.8.0 版本引入，常用于插件或主题开发中控制 cron 相关逻辑。

代码示例

if ( wp_doing_cron() ) {
    // 执行 cron 任务相关代码
} else {
    // 执行非 cron 请求的代码
}
📄 原文内容

Determines whether the current request is a WordPress cron request.

Return

bool True if it’s a WordPress cron request, false otherwise.

Source

function wp_doing_cron() {
	/**
	 * Filters whether the current request is a WordPress cron request.
	 *
	 * @since 4.8.0
	 *
	 * @param bool $wp_doing_cron Whether the current request is a WordPress cron request.
	 */
	return apply_filters( 'wp_doing_cron', defined( 'DOING_CRON' ) && DOING_CRON );
}

View all references View on Trac View on GitHub

Hooks

apply_filters( ‘wp_doing_cron’, bool $wp_doing_cron )

Filters whether the current request is a WordPress cron request.

Uses Description
apply_filters()wp-includes/plugin.php

Calls the callback functions that have been added to a filter hook.
Used by Description
Plugin_Upgrader::active_before()wp-admin/includes/class-plugin-upgrader.php

Turns on maintenance mode before attempting to background update an active plugin.
Plugin_Upgrader::active_after()wp-admin/includes/class-plugin-upgrader.php

Turns off maintenance mode after upgrading an active plugin.
Plugin_Upgrader::deactivate_plugin_before_upgrade()wp-admin/includes/class-plugin-upgrader.php

Deactivates a plugin before it is upgraded.
WP_Upgrader::maintenance_mode()wp-admin/includes/class-wp-upgrader.php

Toggles maintenance mode for the site.
get_core_checksums()wp-admin/includes/update.php

Gets and caches the checksums for the given version of WordPress.
_unzip_file_ziparchive()wp-admin/includes/file.php

Attempts to unzip an archive using the ZipArchive class.
_unzip_file_pclzip()wp-admin/includes/file.php

Attempts to unzip an archive using the PclZip library.
wp_version_check()wp-includes/update.php

Checks WordPress version against the newest version.
wp_update_plugins()wp-includes/update.php

Checks for available updates to plugins based on the latest versions hosted on WordPress.org.
wp_update_themes()wp-includes/update.php

Checks for available updates to themes based on the latest versions hosted on WordPress.org.

Show 5 moreShow less

Changelog

Version Description
4.8.0 Introduced.