定時任務

開發者執行定時任務會通過 Linux 的 Crontab 去實現，不方便去管理。EasySwoole 提供了根據 Linux 下 Crontab 規則的定時任務，最小粒度為1分鐘。

創建一個定時任務

需要定義一個定時任務類實現 \EasySwoole\Crontab\JobInterface 接口。

定義執行規則

public function crontabRule(): string
{
    // 定義執行規則 根據Crontab來定義
    return '*/1 * * * *';
}

定義 Crontab 名稱

public function jobName(): string
{
    // 定時任務的名稱
    return 'CustomCrontab';
}

定義執行邏輯

public function run()
{
    // 定時任務的執行邏輯

    // 開發者可投遞給task異步處理
    TaskManager::getInstance()->async(function (){
        // todo some thing
    });
}

定義異常捕獲

public function onException(\Throwable $throwable)
{
    // 捕獲run方法內所拋出的異常
}

注冊 Crontab

在 EasySwoole 框架全局的 mainServerCreate 事件（即項目根目錄的 EasySwooleEvent.php 文件的 mainServerCreate 方法中）中進行定時任務注冊。

public static function mainServerCreate(EventRegister $register)
{
    // 配置定時任務
    $crontabConfig = new \EasySwoole\Crontab\Config();

    // 1.設置執行定時任務的 socket 服務的 socket 文件存放的位置，默認值為 當前文件所在目錄
    // 這里設置為框架的 Temp 目錄
    $crontabConfig->setTempDir(EASYSWOOLE_TEMP_DIR);

    // 2.設置執行定時任務的 socket 服務的名稱，默認值為 'EasySwoole'
    $crontabConfig->setServerName('EasySwoole');

    // 3.設置用來執行定時任務的 worker 進程數，默認值為 3
    $crontabConfig->setWorkerNum(3);

    // 4.設置定時任務執行出現異常的異常捕獲回調
    $crontabConfig->setOnException(function (\Throwable $throwable) {
        // 定時任務執行發生異常時觸發（如果未在定時任務類的 onException 中進行捕獲異常則會觸發此異常回調）
    });

    // 創建定時任務實例
    $crontab = \EasySwoole\EasySwoole\Crontab\Crontab::getInstance($crontabConfig);

    // 注冊定時任務
    $crontab->register(new \App\Crontab\CustomCrontab());
}

完整使用示例代碼

在 EasySwoole 中使用

1.定義定時任務類，新增 \App\Crontab\CustomCrontab 文件，文件內容如下：

<?php

namespace App\Crontab;

use EasySwoole\Crontab\JobInterface;

class CustomCrontab implements JobInterface
{
    public function jobName(): string
    {
        // 定時任務的名稱
        return 'CustomCrontab';
    }

    public function crontabRule(): string
    {
        // 定義執行規則 根據 Crontab 來定義
        // 這里是每分鐘執行 1 次
        return '*/1 * * * *';
    }

    public function run()
    {
        // 定時任務的執行邏輯

        // 相當于每分鐘打印1次時間戳，這里只是參考示例。
        echo time();
    }

    public function onException(\Throwable $throwable)
    {
        // 捕獲 run 方法內所拋出的異常
    }
}

2.注冊定時任務，在 EasySwoole 框架全局的 mainServerCreate 事件（即項目根目錄的 EasySwooleEvent.php 文件的 mainServerCreate 方法中）中進行定時任務注冊，如下所示：

<?php

namespace EasySwoole\EasySwoole;

use App\Crontab\CustomCrontab;
use EasySwoole\EasySwoole\AbstractInterface\Event;
use EasySwoole\EasySwoole\Swoole\EventRegister;
use EasySwoole\EasySwoole\Crontab\Crontab;

class EasySwooleEvent implements Event
{
    public static function initialize()
    {
        date_default_timezone_set('Asia/Shanghai');
    }

    public static function mainServerCreate(EventRegister $register)
    {
        ###### 注冊一個定時任務 ######
        // 配置定時任務
        $crontabConfig = new \EasySwoole\Crontab\Config();

        // 1.設置執行定時任務的 socket 服務的 socket 文件存放的位置，默認值為 當前文件所在目錄
        // 這里設置為框架的 Temp 目錄
        $crontabConfig->setTempDir(EASYSWOOLE_TEMP_DIR);

        // 2.設置執行定時任務的 socket 服務的名稱，默認值為 'EasySwoole'
        $crontabConfig->setServerName('EasySwoole');

        // 3.設置用來執行定時任務的 worker 進程數，默認值為 3
        $crontabConfig->setWorkerNum(3);

        // 4.設置定時任務執行出現異常的異常捕獲回調
        $crontabConfig->setOnException(function (\Throwable $throwable) {
            // 定時任務執行發生異常時觸發（如果未在定時任務類的 onException 中進行捕獲異常則會觸發此異常回調）
        });

        // 創建定時任務實例
        $crontab = \EasySwoole\EasySwoole\Crontab\Crontab::getInstance($crontabConfig);

        // 注冊定時任務
        $crontab->register(new CustomCrontab());
    }
}

在 Swoole 中使用

<?php
use EasySwoole\Crontab\JobInterface;

require_once __DIR__ . '/vendor/autoload.php';

$http = new Swoole\Http\Server('0.0.0.0', 9501);

class JobPerMin implements JobInterface
{
    public function jobName(): string
    {
        return 'JobPerMin';
    }

    public function crontabRule(): string
    {
        return '*/1 * * * *';
    }

    public function run()
    {
        var_dump(time());
        return time();
    }

    public function onException(\Throwable $throwable)
    {
        throw $throwable;
    }
}

// 配置及注冊定時任務
$crontab = \EasySwoole\EasySwoole\Crontab\Crontab::getInstance();
$crontab->register(new JobPerMin());
$crontab->attachToServer($http);

$http->on('request', function ($request, $response) use ($crontab) {

    // 在 http 服務中直接觸發執行定時任務
    $ret = $crontab->rightNow('JobPerMin');

    $response->header('Content-Type', 'text/plain');
    $response->end('Hello World ' . $ret);
});

$http->start();

Crontab 表達式

通用表達式：

    *    *    *    *    *
    -    -    -    -    -
    |    |    |    |    |
    |    |    |    |    |
    |    |    |    |    +----- day of week (0 - 7) (Sunday=0 or 7)
    |    |    |    +---------- month (1 - 12)
    |    |    +--------------- day of month (1 - 31)
    |    +-------------------- hour (0 - 23)
    +------------------------- min (0 - 59)

特殊表達式：

@yearly                    每年一次 等同于(0 0 1 1 *) 
@annually                  每年一次 等同于(0 0 1 1 *)
@monthly                   每月一次 等同于(0 0 1 * *) 
@weekly                    每周一次 等同于(0 0 * * 0) 
@daily                     每日一次 等同于(0 0 * * *) 
@hourly                    每小時一次 等同于(0 * * * *)