2006-03-07 16:43:59 -05:00
|
|
|
<?php
|
2008-05-25 11:50:15 -04:00
|
|
|
/**
|
2020-07-30 15:14:03 -04:00
|
|
|
* A pseudo-cron daemon for scheduling WordPress tasks.
|
2017-08-20 00:37:45 -04:00
|
|
|
*
|
2020-07-30 15:14:03 -04:00
|
|
|
* WP-Cron is triggered when the site receives a visit. In the scenario
|
2017-08-20 00:37:45 -04:00
|
|
|
* where a site may not receive enough visits to execute scheduled tasks
|
|
|
|
* in a timely manner, this file can be called directly or via a server
|
2020-07-30 15:14:03 -04:00
|
|
|
* cron daemon for X number of times.
|
2017-08-20 00:37:45 -04:00
|
|
|
*
|
|
|
|
* Defining DISABLE_WP_CRON as true and calling this file directly are
|
|
|
|
* mutually exclusive and the latter does not rely on the former to work.
|
2008-05-25 11:50:15 -04:00
|
|
|
*
|
|
|
|
* The HTTP request to this file will not slow down the visitor who happens to
|
2020-07-30 15:14:03 -04:00
|
|
|
* visit when a scheduled cron event runs.
|
2008-05-25 11:50:15 -04:00
|
|
|
*
|
|
|
|
* @package WordPress
|
|
|
|
*/
|
|
|
|
|
2017-11-30 18:11:00 -05:00
|
|
|
ignore_user_abort( true );
|
2008-05-25 11:50:15 -04:00
|
|
|
|
2022-07-04 23:14:14 -04:00
|
|
|
if ( ! headers_sent() ) {
|
|
|
|
header( 'Expires: Wed, 11 Jan 1984 05:00:00 GMT' );
|
|
|
|
header( 'Cache-Control: no-cache, must-revalidate, max-age=0' );
|
|
|
|
}
|
|
|
|
|
Docs: Revise comments using “we” in WordPress root directory files.
This updates some inline comments to better match the guidelines and recommendations set forth in the make/core and make/docs handbooks:
> In general, use second person in your documentation. Second person depicts a friendly tone, with a perfect focus on the reader. In addition to this, directly addressing the reader helps avoid passive voice; thereby preventing unwanted confusion.
> ...
> the word “we” should be avoided (...) unless its made very clear which group is speaking.
Includes:
* Replacing first-person usage of "we" with second person point of view.
* Making small clarification adjustments where the voice is much too casual or lacks clear context, especially for non-native English speakers.
References:
* [https://make.wordpress.org/docs/style-guide/language-grammar/grammatical-person/ Style Guide: Grammatical person]
* [https://make.wordpress.org/docs/handbook/documentation-team-handbook/handbooks-style-and-formatting-guide/ Handbooks & HelpHub Style and Formatting Guide]
* [https://make.wordpress.org/core/handbook/best-practices/post-comment-guidelines/#style-and-substance Post & Comment Guidelines: Style and Substance]
Follow-up to [2176], [3430], [4676], [6009], [7991], [12688], [12762], [26008], [28978], [44488], [44962], [51979], [53131], [53132], [53156], [53131], [54200].
Props ironprogrammer, costdev, jorbin, SergeyBiryukov.
See #57052.
Built from https://develop.svn.wordpress.org/trunk@54866
git-svn-id: http://core.svn.wordpress.org/trunk@54418 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2022-11-23 10:43:13 -05:00
|
|
|
// Don't run cron until the request finishes, if possible.
|
2024-07-05 06:12:16 -04:00
|
|
|
if ( function_exists( 'fastcgi_finish_request' ) ) {
|
2019-01-08 20:07:39 -05:00
|
|
|
fastcgi_finish_request();
|
2022-07-04 23:14:14 -04:00
|
|
|
} elseif ( function_exists( 'litespeed_finish_request' ) ) {
|
|
|
|
litespeed_finish_request();
|
2019-01-08 20:07:39 -05:00
|
|
|
}
|
|
|
|
|
2017-11-30 18:11:00 -05:00
|
|
|
if ( ! empty( $_POST ) || defined( 'DOING_AJAX' ) || defined( 'DOING_CRON' ) ) {
|
2009-02-07 08:32:34 -05:00
|
|
|
die();
|
2017-11-30 18:11:00 -05:00
|
|
|
}
|
2009-02-07 08:32:34 -05:00
|
|
|
|
2008-05-25 11:50:15 -04:00
|
|
|
/**
|
Docs: Revise comments using “we” in WordPress root directory files.
This updates some inline comments to better match the guidelines and recommendations set forth in the make/core and make/docs handbooks:
> In general, use second person in your documentation. Second person depicts a friendly tone, with a perfect focus on the reader. In addition to this, directly addressing the reader helps avoid passive voice; thereby preventing unwanted confusion.
> ...
> the word “we” should be avoided (...) unless its made very clear which group is speaking.
Includes:
* Replacing first-person usage of "we" with second person point of view.
* Making small clarification adjustments where the voice is much too casual or lacks clear context, especially for non-native English speakers.
References:
* [https://make.wordpress.org/docs/style-guide/language-grammar/grammatical-person/ Style Guide: Grammatical person]
* [https://make.wordpress.org/docs/handbook/documentation-team-handbook/handbooks-style-and-formatting-guide/ Handbooks & HelpHub Style and Formatting Guide]
* [https://make.wordpress.org/core/handbook/best-practices/post-comment-guidelines/#style-and-substance Post & Comment Guidelines: Style and Substance]
Follow-up to [2176], [3430], [4676], [6009], [7991], [12688], [12762], [26008], [28978], [44488], [44962], [51979], [53131], [53132], [53156], [53131], [54200].
Props ironprogrammer, costdev, jorbin, SergeyBiryukov.
See #57052.
Built from https://develop.svn.wordpress.org/trunk@54866
git-svn-id: http://core.svn.wordpress.org/trunk@54418 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2022-11-23 10:43:13 -05:00
|
|
|
* Tell WordPress the cron task is running.
|
2008-05-25 11:50:15 -04:00
|
|
|
*
|
|
|
|
* @var bool
|
|
|
|
*/
|
2017-11-30 18:11:00 -05:00
|
|
|
define( 'DOING_CRON', true );
|
2006-03-07 16:43:59 -05:00
|
|
|
|
2017-11-30 18:11:00 -05:00
|
|
|
if ( ! defined( 'ABSPATH' ) ) {
|
2010-03-17 00:39:50 -04:00
|
|
|
/** Set up WordPress environment */
|
2020-02-06 01:33:11 -05:00
|
|
|
require_once __DIR__ . '/wp-load.php';
|
2009-02-07 08:32:34 -05:00
|
|
|
}
|
|
|
|
|
2023-05-30 14:48:19 -04:00
|
|
|
// Attempt to raise the PHP memory limit for cron event processing.
|
|
|
|
wp_raise_memory_limit( 'cron' );
|
|
|
|
|
2015-03-17 19:38:27 -04:00
|
|
|
/**
|
|
|
|
* Retrieves the cron lock.
|
|
|
|
*
|
|
|
|
* Returns the uncached `doing_cron` transient.
|
|
|
|
*
|
|
|
|
* @ignore
|
|
|
|
* @since 3.3.0
|
|
|
|
*
|
2017-07-25 08:56:43 -04:00
|
|
|
* @global wpdb $wpdb WordPress database abstraction object.
|
|
|
|
*
|
2022-04-28 05:49:16 -04:00
|
|
|
* @return string|int|false Value of the `doing_cron` transient, 0|false otherwise.
|
2015-03-17 19:38:27 -04:00
|
|
|
*/
|
2011-09-09 15:59:44 -04:00
|
|
|
function _get_cron_lock() {
|
2013-09-06 14:10:09 -04:00
|
|
|
global $wpdb;
|
2011-09-09 15:59:44 -04:00
|
|
|
|
|
|
|
$value = 0;
|
2021-08-03 11:15:57 -04:00
|
|
|
if ( wp_using_ext_object_cache() ) {
|
2014-05-13 00:39:14 -04:00
|
|
|
/*
|
|
|
|
* Skip local cache and force re-fetch of doing_cron transient
|
|
|
|
* in case another process updated the cache.
|
|
|
|
*/
|
2011-09-09 15:59:44 -04:00
|
|
|
$value = wp_cache_get( 'doing_cron', 'transient', true );
|
|
|
|
} else {
|
|
|
|
$row = $wpdb->get_row( $wpdb->prepare( "SELECT option_value FROM $wpdb->options WHERE option_name = %s LIMIT 1", '_transient_doing_cron' ) );
|
2017-11-30 18:11:00 -05:00
|
|
|
if ( is_object( $row ) ) {
|
2011-09-09 15:59:44 -04:00
|
|
|
$value = $row->option_value;
|
2017-11-30 18:11:00 -05:00
|
|
|
}
|
2011-09-09 15:59:44 -04:00
|
|
|
}
|
|
|
|
|
|
|
|
return $value;
|
|
|
|
}
|
|
|
|
|
2019-01-08 16:49:49 -05:00
|
|
|
$crons = wp_get_ready_cron_jobs();
|
|
|
|
if ( empty( $crons ) ) {
|
2009-02-07 08:32:34 -05:00
|
|
|
die();
|
2017-11-30 18:11:00 -05:00
|
|
|
}
|
2006-11-20 21:48:12 -05:00
|
|
|
|
2019-01-09 03:37:51 -05:00
|
|
|
$gmt_time = microtime( true );
|
|
|
|
|
2015-05-25 02:25:25 -04:00
|
|
|
// The cron lock: a unix timestamp from when the cron was spawned.
|
|
|
|
$doing_cron_transient = get_transient( 'doing_cron' );
|
2011-09-09 15:59:44 -04:00
|
|
|
|
2019-11-15 03:59:01 -05:00
|
|
|
// Use global $doing_wp_cron lock, otherwise use the GET lock. If no lock, try to grab a new lock.
|
2011-09-09 15:59:44 -04:00
|
|
|
if ( empty( $doing_wp_cron ) ) {
|
2017-11-30 18:11:00 -05:00
|
|
|
if ( empty( $_GET['doing_wp_cron'] ) ) {
|
2011-09-09 15:59:44 -04:00
|
|
|
// Called from external script/job. Try setting a lock.
|
2017-11-30 18:11:00 -05:00
|
|
|
if ( $doing_cron_transient && ( $doing_cron_transient + WP_CRON_LOCK_TIMEOUT > $gmt_time ) ) {
|
2011-09-09 15:59:44 -04:00
|
|
|
return;
|
2017-11-30 18:11:00 -05:00
|
|
|
}
|
2019-06-22 07:12:51 -04:00
|
|
|
$doing_wp_cron = sprintf( '%.22F', microtime( true ) );
|
|
|
|
$doing_cron_transient = $doing_wp_cron;
|
2011-09-09 15:59:44 -04:00
|
|
|
set_transient( 'doing_cron', $doing_wp_cron );
|
|
|
|
} else {
|
2017-11-30 18:11:00 -05:00
|
|
|
$doing_wp_cron = $_GET['doing_wp_cron'];
|
2011-09-09 15:59:44 -04:00
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2015-05-25 02:25:25 -04:00
|
|
|
/*
|
|
|
|
* The cron lock (a unix timestamp set when the cron was spawned),
|
|
|
|
* must match $doing_wp_cron (the "key").
|
|
|
|
*/
|
2020-01-08 19:55:05 -05:00
|
|
|
if ( $doing_cron_transient !== $doing_wp_cron ) {
|
2011-09-09 15:59:44 -04:00
|
|
|
return;
|
2017-11-30 18:11:00 -05:00
|
|
|
}
|
2011-09-09 15:59:44 -04:00
|
|
|
|
|
|
|
foreach ( $crons as $timestamp => $cronhooks ) {
|
2017-11-30 18:11:00 -05:00
|
|
|
if ( $timestamp > $gmt_time ) {
|
2008-09-18 03:09:38 -04:00
|
|
|
break;
|
2017-11-30 18:11:00 -05:00
|
|
|
}
|
2008-05-25 11:50:15 -04:00
|
|
|
|
2011-09-09 15:59:44 -04:00
|
|
|
foreach ( $cronhooks as $hook => $keys ) {
|
2008-09-18 03:09:38 -04:00
|
|
|
|
2011-09-09 15:59:44 -04:00
|
|
|
foreach ( $keys as $k => $v ) {
|
2008-09-18 03:09:38 -04:00
|
|
|
|
|
|
|
$schedule = $v['schedule'];
|
|
|
|
|
2019-06-22 09:43:52 -04:00
|
|
|
if ( $schedule ) {
|
2022-09-20 11:44:38 -04:00
|
|
|
$result = wp_reschedule_event( $timestamp, $schedule, $hook, $v['args'], true );
|
|
|
|
|
|
|
|
if ( is_wp_error( $result ) ) {
|
|
|
|
error_log(
|
|
|
|
sprintf(
|
|
|
|
/* translators: 1: Hook name, 2: Error code, 3: Error message, 4: Event data. */
|
|
|
|
__( 'Cron reschedule event error for hook: %1$s, Error code: %2$s, Error message: %3$s, Data: %4$s' ),
|
|
|
|
$hook,
|
|
|
|
$result->get_error_code(),
|
|
|
|
$result->get_error_message(),
|
|
|
|
wp_json_encode( $v )
|
|
|
|
)
|
|
|
|
);
|
|
|
|
|
|
|
|
/**
|
2024-08-02 15:40:16 -04:00
|
|
|
* Fires if an error happens when rescheduling a cron event.
|
2022-09-20 11:44:38 -04:00
|
|
|
*
|
|
|
|
* @since 6.1.0
|
|
|
|
*
|
|
|
|
* @param WP_Error $result The WP_Error object.
|
|
|
|
* @param string $hook Action hook to execute when the event is run.
|
|
|
|
* @param array $v Event data.
|
|
|
|
*/
|
|
|
|
do_action( 'cron_reschedule_event_error', $result, $hook, $v );
|
|
|
|
}
|
2006-09-13 19:54:15 -04:00
|
|
|
}
|
2008-09-18 03:09:38 -04:00
|
|
|
|
2022-09-20 11:44:38 -04:00
|
|
|
$result = wp_unschedule_event( $timestamp, $hook, $v['args'], true );
|
|
|
|
|
|
|
|
if ( is_wp_error( $result ) ) {
|
|
|
|
error_log(
|
|
|
|
sprintf(
|
|
|
|
/* translators: 1: Hook name, 2: Error code, 3: Error message, 4: Event data. */
|
|
|
|
__( 'Cron unschedule event error for hook: %1$s, Error code: %2$s, Error message: %3$s, Data: %4$s' ),
|
|
|
|
$hook,
|
|
|
|
$result->get_error_code(),
|
|
|
|
$result->get_error_message(),
|
|
|
|
wp_json_encode( $v )
|
|
|
|
)
|
|
|
|
);
|
|
|
|
|
|
|
|
/**
|
2024-08-02 15:40:16 -04:00
|
|
|
* Fires if an error happens when unscheduling a cron event.
|
2022-09-20 11:44:38 -04:00
|
|
|
*
|
|
|
|
* @since 6.1.0
|
|
|
|
*
|
|
|
|
* @param WP_Error $result The WP_Error object.
|
|
|
|
* @param string $hook Action hook to execute when the event is run.
|
|
|
|
* @param array $v Event data.
|
|
|
|
*/
|
|
|
|
do_action( 'cron_unschedule_event_error', $result, $hook, $v );
|
|
|
|
}
|
2011-09-09 15:59:44 -04:00
|
|
|
|
2013-09-06 16:52:10 -04:00
|
|
|
/**
|
|
|
|
* Fires scheduled events.
|
|
|
|
*
|
2015-01-12 19:51:21 -05:00
|
|
|
* @ignore
|
2013-09-06 16:52:10 -04:00
|
|
|
* @since 2.1.0
|
|
|
|
*
|
|
|
|
* @param string $hook Name of the hook that was scheduled to be fired.
|
2014-04-25 03:54:21 -04:00
|
|
|
* @param array $args The arguments to be passed to the hook.
|
2013-09-06 16:52:10 -04:00
|
|
|
*/
|
2017-11-30 18:11:00 -05:00
|
|
|
do_action_ref_array( $hook, $v['args'] );
|
2008-09-18 03:09:38 -04:00
|
|
|
|
2011-09-09 15:59:44 -04:00
|
|
|
// If the hook ran too long and another cron process stole the lock, quit.
|
2020-01-08 19:55:05 -05:00
|
|
|
if ( _get_cron_lock() !== $doing_wp_cron ) {
|
2011-09-09 15:59:44 -04:00
|
|
|
return;
|
2017-11-30 18:11:00 -05:00
|
|
|
}
|
2006-03-07 16:43:59 -05:00
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
2006-11-20 21:48:12 -05:00
|
|
|
|
2020-01-08 19:55:05 -05:00
|
|
|
if ( _get_cron_lock() === $doing_wp_cron ) {
|
2011-09-09 15:59:44 -04:00
|
|
|
delete_transient( 'doing_cron' );
|
2017-11-30 18:11:00 -05:00
|
|
|
}
|
2011-09-09 15:59:44 -04:00
|
|
|
|
2008-09-18 03:09:38 -04:00
|
|
|
die();
|