wp_reschedule_event
函数
wp_reschedule_event ( $timestamp, $recurrence, $hook, $args = array(), $wp_error = false )
- 参数
-
-
(int)
$timestamp
Unix timestamp (UTC) for when the event was scheduled.- Required: 是
-
(string)
$recurrence
How often the event should subsequently recur. See wp_get_schedules() for accepted values.- Required: 是
-
(string)
$hook
Action hook to execute when the event is run.- Required: 是
-
(array)
$args
Optional. Array containing arguments to pass to the hook’s callback function. Each value in the array is passed to the callback as an individual parameter. The array keys are ignored. Default empty array.- Required: 否
- Default: array()
-
(bool)
$wp_error
Optional. Whether to return a WP_Error on failure. Default false.- Required: 否
- Default: false
-
(int)
- 返回值
-
- (bool|WP_Error) True if event successfully rescheduled. False or WP_Error on failure.
- 定义位置
-
-
wp-includes/cron.php
, line 338
-
wp-includes/cron.php
- 引入
- 2.1.0
- 弃用
- –
Reschedules a recurring event.
Mainly for internal use, this takes the UTC timestamp of a previously run
recurring event and reschedules it for its next run.
To change upcoming scheduled events, use wp_schedule_event() to
change the recurrence frequency.
function wp_reschedule_event( $timestamp, $recurrence, $hook, $args = array(), $wp_error = false ) { // Make sure timestamp is a positive integer. if ( ! is_numeric( $timestamp ) || $timestamp interval ) ) { $interval = $scheduled_event->interval; } } $event = (object) array( 'hook' => $hook, 'timestamp' => $timestamp, 'schedule' => $recurrence, 'args' => $args, 'interval' => $interval, ); /** * Filter to preflight or hijack rescheduling of a recurring event. * * Returning a non-null value will short-circuit the normal rescheduling * process, causing the function to return the filtered value instead. * * For plugins replacing wp-cron, return true if the event was successfully * rescheduled, false or a WP_Error if not. * * @since 5.1.0 * @since 5.7.0 The `$wp_error` parameter was added, and a `WP_Error` object can now be returned. * * @param null|bool|WP_Error $pre Value to return instead. Default null to continue adding the event. * @param stdClass $event { * An object containing an event's data. * * @type string $hook Action hook to execute when the event is run. * @type int $timestamp Unix timestamp (UTC) for when to next run the event. * @type string $schedule How often the event should subsequently recur. * @type array $args Array containing each separate argument to pass to the hook's callback function. * @type int $interval The interval time in seconds for the schedule. * } * @param bool $wp_error Whether to return a WP_Error on failure. */ $pre = apply_filters( 'pre_reschedule_event', null, $event, $wp_error ); if ( null !== $pre ) { if ( $wp_error && false === $pre ) { return new WP_Error( 'pre_reschedule_event_false', __( 'A plugin prevented the event from being rescheduled.' ) ); } if ( ! $wp_error && is_wp_error( $pre ) ) { return false; } return $pre; } // Now we assume something is wrong and fail to schedule. if ( 0 == $interval ) { if ( $wp_error ) { return new WP_Error( 'invalid_schedule', __( 'Event schedule does not exist.' ) ); } return false; } $now = time(); if ( $timestamp >= $now ) { $timestamp = $now + $interval; } else { $timestamp = $now + ( $interval - ( ( $now - $timestamp ) % $interval ) ); } return wp_schedule_event( $timestamp, $recurrence, $hook, $args, $wp_error ); }
声明:本站所有文章,如无特殊说明或标注,均为本站原创发布。任何个人或组织,在未征得本站同意时,禁止复制、盗用、采集、发布本站内容到任何网站、书籍等各类媒体平台。如若本站内容侵犯了原著者的合法权益,可联系我们进行处理。