add

int \Workerman\Timer::add(float $time_interval, callable $callback [,$args = array(), bool $persistent = true])

定時執(zhí)行某個函數(shù)或者類方法。

注意：定時器是在當(dāng)前進(jìn)程中運(yùn)行的，workerman中不會創(chuàng)建新的進(jìn)程或者線程去運(yùn)行定時器。

參數(shù)

time_interval

多長時間執(zhí)行一次，單位秒，支持小數(shù)，可以精確到0.001，即精確到毫秒級別。

callback

回調(diào)函數(shù)注意：如果回調(diào)函數(shù)是類的方法，則方法必須是public屬性

args

回調(diào)函數(shù)的參數(shù)，必須為數(shù)組，數(shù)組元素為參數(shù)值

persistent

是否是持久的，如果只想定時執(zhí)行一次，則傳遞false（只執(zhí)行一次的任務(wù)在執(zhí)行完畢后會自動銷毀，不必調(diào)用Timer::del()）。默認(rèn)是true，即一直定時執(zhí)行。

返回值

返回一個整數(shù)，代表計時器的timerid，可以通過調(diào)用Timer::del($timerid)銷毀這個計時器。

示例

1、定時函數(shù)為匿名函數(shù)（閉包）

use Workerman\Worker;
use Workerman\Timer;
require_once __DIR__ . '/vendor/autoload.php';

$task = new Worker();
// 開啟多少個進(jìn)程運(yùn)行定時任務(wù)，注意業(yè)務(wù)是否在多進(jìn)程有并發(fā)問題
$task->count = 1;
$task->onWorkerStart = function(Worker $task)
{
    // 每2.5秒執(zhí)行一次
    $time_interval = 2.5;
    Timer::add($time_interval, function()
    {
        echo "task run\n";
    });
};

// 運(yùn)行worker
Worker::runAll();

2、只在指定進(jìn)程中設(shè)置定時器

一個worker實(shí)例有4個進(jìn)程，只在id編號為0的進(jìn)程上設(shè)置定時器。

use Workerman\Worker;
use Workerman\Timer;
require_once __DIR__ . '/vendor/autoload.php';

$worker = new Worker();
$worker->count = 4;
$worker->onWorkerStart = function(Worker $worker)
{
    // 只在id編號為0的進(jìn)程上設(shè)置定時器，其它1、2、3號進(jìn)程不設(shè)置定時器
    if($worker->id === 0)
    {
        Timer::add(1, function(){
            echo "4個worker進(jìn)程，只在0號進(jìn)程設(shè)置定時器\n";
        });
    }
};
// 運(yùn)行worker
Worker::runAll();

3、定時函數(shù)為匿名函數(shù)，利用閉包傳遞參數(shù)

use Workerman\Worker;
use Workerman\Timer;
use Workerman\Connection\TcpConnection;
require_once __DIR__ . '/vendor/autoload.php';

$ws_worker = new Worker('websocket://0.0.0.0:8080');
$ws_worker->count = 8;
// 連接建立時給對應(yīng)連接設(shè)置定時器
$ws_worker->onConnect = function(TcpConnection $connection)
{
    // 每10秒執(zhí)行一次
    $time_interval = 10;
    $connect_time = time();
    // 給connection對象臨時添加一個timer_id屬性保存定時器id
    $connection->timer_id = Timer::add($time_interval, function()use($connection, $connect_time)
    {
         $connection->send($connect_time);
    });
};
// 連接關(guān)閉時，刪除對應(yīng)連接的定時器
$ws_worker->onClose = function(TcpConnection $connection)
{
    // 刪除定時器
    Timer::del($connection->timer_id);
};

// 運(yùn)行worker
Worker::runAll();

4、定時器函數(shù)為匿名函數(shù)，利用定時器接口傳遞參數(shù)

use Workerman\Worker;
use Workerman\Timer;
use Workerman\Connection\TcpConnection;
require_once __DIR__ . '/vendor/autoload.php';

$ws_worker = new Worker('websocket://0.0.0.0:8080');
$ws_worker->count = 8;
// 連接建立時給對應(yīng)連接設(shè)置定時器
$ws_worker->onConnect = function(TcpConnection $connection)
{
    // 每10秒執(zhí)行一次
    $time_interval = 10;
    $connect_time = time();
    // 給connection對象臨時添加一個timer_id屬性保存定時器id
    $connection->timer_id = Timer::add($time_interval, function($connection, $connect_time)
    {
         $connection->send($connect_time);
    }, array($connection, $connect_time));
};
// 連接關(guān)閉時，刪除對應(yīng)連接的定時器
$ws_worker->onClose = function(TcpConnection $connection)
{
    // 刪除定時器
    Timer::del($connection->timer_id);
};

// 運(yùn)行worker
Worker::runAll();

5、定時函數(shù)為普通函數(shù)

use Workerman\Worker;
use Workerman\Timer;
require_once __DIR__ . '/vendor/autoload.php';

// 普通的函數(shù)
function send_mail($to, $content)
{
    echo "send mail ...\n";
}

$task = new Worker();
$task->onWorkerStart = function(Worker $task)
{
    $to = 'workerman@workerman.net';
    $content = 'hello workerman';
    // 10秒后執(zhí)行發(fā)送郵件任務(wù)，最后一個參數(shù)傳遞false，表示只運(yùn)行一次
    Timer::add(10, 'send_mail', array($to, $content), false);
};

// 運(yùn)行worker
Worker::runAll();

6、定時函數(shù)為類的方法

use Workerman\Worker;
use Workerman\Timer;
require_once __DIR__ . '/vendor/autoload.php';

class Mail
{
    // 注意，回調(diào)函數(shù)屬性必須是public
    public function send($to, $content)
    {
        echo "send mail ...\n";
    }
}

$task = new Worker();
$task->onWorkerStart = function($task)
{
    // 10秒后發(fā)送一次郵件
    $mail = new Mail();
    $to = 'workerman@workerman.net';
    $content = 'hello workerman';
    Timer::add(10, array($mail, 'send'), array($to, $content), false);
};

// 運(yùn)行worker
Worker::runAll();

7、定時函數(shù)為類方法（類內(nèi)部使用定時器）

use Workerman\Worker;
use Workerman\Timer;
require_once __DIR__ . '/vendor/autoload.php';

class Mail
{
    // 注意，回調(diào)函數(shù)屬性必須是public
    public function send($to, $content)
    {
        echo "send mail ...\n";
    }

    public function sendLater($to, $content)
    {
        // 回調(diào)的方法屬于當(dāng)前的類，則回調(diào)數(shù)組第一個元素為$this
        Timer::add(10, array($this, 'send'), array($to, $content), false);
    }
}

$task = new Worker();
$task->onWorkerStart = function(Worker $task)
{
    // 10秒后發(fā)送一次郵件
    $mail = new Mail();
    $to = 'workerman@workerman.net';
    $content = 'hello workerman';
    $mail->sendLater($to, $content);
};

// 運(yùn)行worker
Worker::runAll();

8、定時函數(shù)為類的靜態(tài)方法

use Workerman\Worker;
use Workerman\Timer;
require_once __DIR__ . '/vendor/autoload.php';

class Mail
{
    // 注意這個是靜態(tài)方法，回調(diào)函數(shù)屬性也必須是public
    public static function send($to, $content)
    {
        echo "send mail ...\n";
    }
}

$task = new Worker();
$task->onWorkerStart = function(Worker $task)
{
    // 10秒后發(fā)送一次郵件
    $to = 'workerman@workerman.net';
    $content = 'hello workerman';
    // 定時調(diào)用類的靜態(tài)方法
    Timer::add(10, array('Mail', 'send'), array($to, $content), false);
};

// 運(yùn)行worker
Worker::runAll();

9、定時函數(shù)為類的靜態(tài)方法(帶命名空間)

namespace Task;

use Workerman\Worker;
use Workerman\Timer;
require_once __DIR__ . '/vendor/autoload.php';

class Mail
{
    // 注意這個是靜態(tài)方法，回調(diào)函數(shù)屬性也必須是public
    public static function send($to, $content)
    {
        echo "send mail ...\n";
    }
}

$task = new Worker();
$task->onWorkerStart = function(Worker $task)
{
    // 10秒后發(fā)送一次郵件
    $to = 'workerman@workerman.net';
    $content = 'hello workerman';
    // 定時調(diào)用帶命名空間的類的靜態(tài)方法
    Timer::add(10, array('\Task\Mail', 'send'), array($to, $content), false);
};

// 運(yùn)行worker
Worker::runAll();

10、定時器中銷毀當(dāng)前定時器（use閉包方式傳遞$timer_id）

use Workerman\Worker;
use Workerman\Timer;
require_once __DIR__ . '/vendor/autoload.php';

$task = new Worker();
$task->onWorkerStart = function(Worker $task)
{
    // 計數(shù)
    $count = 1;
    // 要想$timer_id能正確傳遞到回調(diào)函數(shù)內(nèi)部，$timer_id前面必須加地址符 &
    $timer_id = Timer::add(1, function()use(&$timer_id, &$count)
    {
        echo "Timer run $count\n";
        // 運(yùn)行10次后銷毀當(dāng)前定時器
        if($count++ >= 10)
        {
            echo "Timer::del($timer_id)\n";
            Timer::del($timer_id);
        }
    });
};

// 運(yùn)行worker
Worker::runAll();

11、定時器中銷毀當(dāng)前定時器（參數(shù)方式傳遞$timer_id）

use Workerman\Worker;
use Workerman\Timer;
require_once __DIR__ . '/vendor/autoload.php';

class Mail
{
    public function send($to, $content, $timer_id)
    {
        // 臨時給當(dāng)前對象添加一個count屬性，記錄定時器運(yùn)行次數(shù)
        $this->count = empty($this->count) ? 1 : $this->count;
        // 運(yùn)行10次后銷毀當(dāng)前定時器
        echo "send mail {$this->count}...\n";
        if($this->count++ >= 10)
        {
            echo "Timer::del($timer_id)\n";
            Timer::del($timer_id);
        }
    }
}

$task = new Worker();
$task->onWorkerStart = function(Worker $task)
{
    $mail = new Mail();
    // 要想$timer_id能正確傳遞到回調(diào)函數(shù)內(nèi)部，$timer_id前面必須加地址符 &
    $timer_id = Timer::add(1, array($mail, 'send'), array('to', 'content', &$timer_id));
};

// 運(yùn)行worker
Worker::runAll();