YurunPHP 1.3新加入了定時任務的功能，它可以定時執行一些操作，擁有高度自由的觸發時間配置功能。當然這個定時是不一定準時的，下面會有說明。如果需要極其準確的定時任務，請使用Linux下的Cron或者Windows的計劃任務功能。 > YurunPHP定時任務功能不推薦執行時間較長的任務！ ### 原理解析 當用戶訪問時，判斷上次執行時間和當前時間是否滿足再次調用的條件，滿足則調用，不滿足則不調用。YurunPHP框架使用文件鎖，保證同時只有一個請求會執行定時任務。預防并發同時執行、惡意攻擊的情況。 ### 配置方法 #### 自動觸發 在項目的Config目錄下創建task.php文件，復制下面的內容 ~~~ return array( 'List' => array(), // 任務列表 'Status' => false, // 是否開啟自動檢測，默認為false 'ExecPercent' => 1, // 觸發概率，0-1代表0%-100%，默認為1 'OnlyOnce' => false, // 是否只執行一個任務就結束，防止一個請求執行時間過長導致失敗。默認為false ); ~~~ 如果需要自動觸發需要在init.php中編寫如下代碼 ~~~ Event::register('YURUN_APP_LOAD_COMPLETE',function(){ // 啟用任務 Task::init(); }); ~~~ #### 手動觸發 在任意地方執行下面的語句 ~~~ Task::exec(); ~~~ ### 任務開發 1.在項目目錄下創建Task文件夾 2.在Task文件夾下創建TestTask.class.php 3.在TestTask.class.php中為以下代碼 ~~~ <?php class TestTask extends TaskBase { public static $name = '任務名稱'; public static function exec() { // TODO: 任務操作 } } ~~~ 4.在配置文件task.php的List下加入 ~~~ 'Test' => array( // 觸發事件條件1 array( 'StartTime' => 0, 'StopTime' => 0, 'Mode' => 0, 'Month' => 0, 'Day' => 0, 'Week' => 0, 'Hour' => 0, 'Minute' => 0, 'Second' => 0, 'Seconds' => 0, ), // 觸發事件條件2 array( 'StartTime' => 0, 'StopTime' => 0, 'Mode' => 0, 'Month' => 0, 'Day' => 0, 'Week' => 0, 'Hour' => 0, 'Minute' => 0, 'Second' => 0, 'Seconds' => 0, ), ), ~~~ 上面的觸發條件有需要可以無限增加，條件參數說明看下表： | 參數名 | 說明 | | --- | --- | | StartTime | 時間戳。任務允許執行的開始時間。可不設置。 | | StopTime | 時間戳。任務允許執行的結束時間。可不設置。 | | Mode | 條件判斷模式。可不設置。看下面一個表格。 | | Month | 幾月。可不設置。 | | Day | 幾日。可不設置。 | | Week | 星期幾，周一-周日=1-7。可不設置。 | | Hour | 小時。可不設置。 | | Minute | 分鐘。可不設置。 | | Second | 秒數。可不設置。 | | Seconds | 間隔多少秒執行，Mode為MODE_SECOND時有效。 | #### Mode可選值表： | 參數名 | 說明 | | --- | --- | | Task::MODE_SECOND | 按秒執行 | | Task::MODE_EVERY_YEAR | 按每年執行 | | Task::MODE_EVERY_MONTH | 按每月執行 | | Task::MODE_EVERY_WEEK | 按每周執行 | | Task::MODE_EVERY_DAY | 按每日執行 | | Task::MODE_EVERY_HOUR | 按每小時執行 |