PHP 本身是無法創(chuàng)建定時(shí)任務(wù)的，但是 WordPress 自帶了一個(gè)偽定時(shí)任務(wù)（Cron） API，非常的方便好用，包括 WordPress 本身的定時(shí)發(fā)布文章都依賴于這個(gè) API

WP Cron 是什么? 是 WordPress 一套定時(shí)觸發(fā)機(jī)制, 可以循環(huán)安排任務(wù)執(zhí)行. 如: 定時(shí)發(fā)布新文章, 定期檢測版本等功能都是通過這個(gè)來實(shí)現(xiàn)的.

WP Cron 可以為我們實(shí)現(xiàn)什么? 我們可以循環(huán)更新和提交網(wǎng)站數(shù)據(jù), 節(jié)日定期向讀者發(fā)送賀卡或者表單 ...

它的原理就是將創(chuàng)建的定時(shí)任務(wù)存儲(chǔ)到數(shù)據(jù)庫里，當(dāng)有人訪問的時(shí)候就去判斷一下是否到時(shí)間需要執(zhí)行這個(gè)定時(shí)任務(wù)，如果到時(shí)間則執(zhí)行。

因?yàn)檫@種原理，所以執(zhí)行的時(shí)間可能會(huì)有一些偏差，但隨著網(wǎng)站的瀏覽量攀升和網(wǎng)絡(luò)爬蟲的不斷訪問，會(huì)讓定時(shí)任務(wù)執(zhí)行的時(shí)間越來越準(zhǔn)確。

WP-Cron 效率不高, 但還是很方便好用的, 整理了一下相關(guān)函數(shù)的使用方法如下.

函數(shù)

wp_get_schedule

通過勾子別名, 獲取預(yù)定安排的勾子. 成功時(shí)返回循環(huán)周期類別 (hourly, twicedaily, daily, ...), 失敗時(shí)返回 false.

<?php wp_get_schedule( $hook, $args ) ?>

$hook: 勾子別名
$args: 勾子對應(yīng)函數(shù)的參數(shù)數(shù)組 (可選)

wp_get_schedules

WordPress 默認(rèn)支持的循環(huán)周期類別有 hourly, twicedaily 和 daily. 通過該函數(shù)我們可以獲取所有這些循環(huán)周期數(shù)組.

<?php wp_get_schedules() ?>

在默認(rèn)情況下, 由以上方法獲得的數(shù)組對象如下.

array(
 'hourly' => array(
 'interval' => 3600,
 'display' => 'Once Hourly'
 ),
 'twicedaily' => array(
 'interval' => 43200,
 'display' => 'Twice Daily'
 ),
 'daily' => array(
 'interval' => 86400,
 'display' => 'Once Daily'
 )
)

我們可以向 cron_schedules 過濾器添加更多的類型. 添加例子如下:

add_filter('cron_schedules', 'cron_add_weekly'); 
function cron_add_weekly( $schedules )
{
 // Adds once weekly to the existing schedules.
 $schedules['weekly'] = array(
 'interval' => 604800, // 1周 = 60秒 * 60分鐘 * 24小時(shí) * 7天
 'display' => __('Once Weekly')
 );
 return $schedules;
}
wp_next_scheduled

通過勾子別名, 獲取預(yù)定安排的下一個(gè)運(yùn)行時(shí)刻, 以整型返回. 常用于判斷是否已經(jīng)做了預(yù)定安排.

<?php $timestamp = wp_next_scheduled( $hook, $args ); ?>

$hook: 勾子別名
$args: 勾子對應(yīng)函數(shù)的參數(shù)數(shù)組 (可選)

wp_schedule_event

按周期循環(huán)預(yù)定安排一個(gè) WordPress 勾子, 在預(yù)定時(shí)間觸發(fā)勾子對應(yīng)的函數(shù).

<?php wp_schedule_event($timestamp, $recurrence, $hook, $args); ?>

$timestamp: 時(shí)間 (整型)
$recurrence: 循環(huán)周期類別 (hourly, twicedaily, daily, ...)
$hook: 勾子別名
$args: 勾子對應(yīng)函數(shù)的參數(shù)數(shù)組 (可選)

wp_reschedule_event

按周期循環(huán)重新預(yù)定安排一個(gè) WordPress 勾子. 但我發(fā)現(xiàn)這個(gè)方法不能正常使用, Codex 寫得很草, 如果哪位清楚知道怎么使用, 請告知一下.

wp_unschedule_event

通過預(yù)定時(shí)間和勾子別名, 取消預(yù)定的安排.

<?php wp_unschedule_event($timestamp, $hook, $args ); ?>
$timestamp: 時(shí)間 (整型)
$hook: 勾子別名
$args: 勾子對應(yīng)函數(shù)的參數(shù)數(shù)組 (可選)

wp_clear_scheduled_hook

通過勾子別名, 移除預(yù)定安排的勾子.

<?php wp_clear_scheduled_hook( $hook ); ?>
$hook: 勾子別名

wp_schedule_single_event

預(yù)定安排一個(gè) WordPress 勾子, 在預(yù)定時(shí)間觸發(fā)勾子對應(yīng)的函數(shù). 與 wp_schedule_event 不同的是該方法的只安排一次觸發(fā), 不存在循環(huán)預(yù)定.

<?php wp_schedule_single_event($timestamp, $hook); ?>

$timestamp: 時(shí)間 (整型)
$args: 勾子對應(yīng)函數(shù)的參數(shù)數(shù)組 (可選)

從上面的函數(shù)可用的參數(shù)來看，我們就可以整理出以下幾個(gè)常用的參數(shù)：

參數(shù)

$timestamp

（整數(shù)）（必須）第一次執(zhí)行此定時(shí)任務(wù)的時(shí)間，需要傳一個(gè)時(shí)間戳，一般情況下都是當(dāng)場執(zhí)行，但不能用 time() 函數(shù)，而是用 WordPress 的時(shí)間函數(shù) current_time()。

默認(rèn)值：None

$recurrence

（字符串）（必須）執(zhí)行頻率。每隔多長時(shí)間執(zhí)行一次。可以填寫 hourly （每小時(shí)執(zhí)行一次）、twicedaily （每天執(zhí)行兩次，也就是 12 小時(shí)執(zhí)行一次）和 daily （24 小時(shí)執(zhí)行一次）。

默認(rèn)值：None

$hook

（字符串）（必須）執(zhí)行的鉤子。在執(zhí)行定時(shí)任務(wù)的時(shí)候會(huì)調(diào)用這個(gè)鉤子，往這個(gè)鉤子掛在函數(shù)即可實(shí)現(xiàn)定時(shí)執(zhí)行函數(shù)。
默認(rèn)值：None

$args

（數(shù)組）（可選）傳遞的參數(shù)，會(huì)被傳遞到掛載到定時(shí)鉤子的函數(shù)里的參數(shù)。

默認(rèn)值：None

返回值

（布爾 | null）如果添加成功則返回 null，不成功則返回 False

例子

if( !wp_next_scheduled( 'test' ) ) wp_schedule_event( current_time( 'timestamp' ), 'twicedaily', 'test' );

首先使用 wp_next_scheduled() 函數(shù)判斷是否已經(jīng)創(chuàng)建，如果沒創(chuàng)建則創(chuàng)建一個(gè)定時(shí)任務(wù)。

把需要執(zhí)行的代碼掛載到 test 鉤子上就行了。

最新評論