add

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

เรียกใช้ฟังก์ชันหรือวิธีของคลาสตามเวลาที่กำหนด

注意：ตัวจับเวลาจะทำงานในกระบวนการปัจจุบัน โดย Workerman จะไม่สร้างกระบวนการหรือเธรดใหม่เพื่อทำงานกับตัวจับเวลา

参数

time_interval

เวลาที่จะ执行一次 หน่วยเป็นวินาที รองรับจำนวนทศนิยม สามารถแม่นยำได้ถึง 0.001 ซึ่งหมายถึงระดับมิลลิวินาที

callback

ฟังก์ชันเรียกกลับ 注意：如果回调函数是类的方法，则方法必须是public属性

args

พารามิเตอร์ของฟังก์ชันเรียกกลับ จำเป็นต้องเป็นอาเรย์ โดยองค์ประกอบของอาเรย์ต้องเป็นค่า

persistent

是否是持久的，如果只想定时执行一次，则传递false（只执行一次的任务在执行完毕后会自动销毁，不必调用Timer::del()）。默认是true，即一直定时执行。

返回值

ส่งกลับค่าจำนวนเต็ม ซึ่งเป็นตัวแทนของ timerid ของตัวจับเวลา สามารถทำลายตัวจับเวลาด้วยการเรียก Timer::del($timerid) ได้

示例

1、定时函数为匿名函数（闭包）

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

$task = new Worker();
// เปิดการทำงานของกระบวนการจำนวนเท่าไหร่ในการทำงานตามกำหนด เวลา
$task->count = 1;
$task->onWorkerStart = function(Worker $task)
{
    // ทุก 2.5 วินาที执行一次
    $time_interval = 2.5;
    Timer::add($time_interval, function()
    {
        echo "task run\n";
    });
};

// เรียกใช้ Worker
Worker::runAll();

2、只在指定进程中设置定时器

มีอินสแตนซ์ Worker 4 กระบวนการ แต่จะตั้งตัวจับเวลาเฉพาะในกระบวนการที่มีหมายเลข ID เป็น 0

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 ในขณะที่กระบวนการ 1, 2, 3 ไม่ตั้งตัวจับเวลา
    if($worker->id === 0)
    {
        Timer::add(1, function(){
            echo "4个worker进程，只在0号进程设置定时器\n";
        });
    }
};
// เรียกใช้ Worker
Worker::runAll();

3、定时函数为匿名函数，利用闭包传递参数

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;
// ตั้งตัวจับเวลาขณะเชื่อมต่อ
$ws_worker->onConnect = function(TcpConnection $connection)
{
    // ทุก 10 วินาที执行一次
    $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);
    });
};
// เมื่อเชื่อมต่อปิด ให้ลบตัวจับเวลาที่เกี่ยวข้อง
$ws_worker->onClose = function(TcpConnection $connection)
{
    // ลบตัวจับเวลา
    Timer::del($connection->timer_id);
};

// เรียกใช้ Worker
Worker::runAll();

4、定时器函数为匿名函数，利用定时器接口传递参数

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;
// ตั้งตัวจับเวลาขณะเชื่อมต่อ
$ws_worker->onConnect = function(TcpConnection $connection)
{
    // ทุก 10 วินาที执行一次
    $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));
};
// เมื่อเชื่อมต่อปิด ให้ลบตัวจับเวลาที่เกี่ยวข้อง
$ws_worker->onClose = function(TcpConnection $connection)
{
    // ลบตัวจับเวลา
    Timer::del($connection->timer_id);
};

// เรียกใช้ Worker
Worker::runAll();

5、定时函数为普通函数

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

// ฟังก์ชันธรรมดา
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 วินาที โดยให้พารามิเตอร์สุดท้ายเป็น false โดยหมายถึงทำงานเพียงครั้งเดียว
    Timer::add(10, 'send_mail', array($to, $content), false);
};

// เรียกใช้ Worker
Worker::runAll();

6、定时函数为类的方法

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

class Mail
{
    // 注意，回调函数属性必须是public
    public function send($to, $content)
    {
        echo "send mail ...\n";
    }
}

$task = new Worker();
$task->onWorkerStart = function($task)
{
    // ส่งอีเมลหลังจาก 10 วินาที
    $mail = new Mail();
    $to = 'workerman@workerman.net';
    $content = 'hello workerman';
    Timer::add(10, array($mail, 'send'), array($to, $content), false);
};

// เรียกใช้ Worker
Worker::runAll();

7、定时函数为类方法（类内部使用定时器）

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

class Mail
{
    // 注意，回调函数属性必须是public
    public function send($to, $content)
    {
        echo "send mail ...\n";
    }

    public function sendLater($to, $content)
    {
        // หมายเหตุ，หากวิธีการเรียกกลับเป็นคลาสปัจจุบัน，พารามิเตอร์เป็น $this
        Timer::add(10, array($this, 'send'), array($to, $content), false);
    }
}

$task = new Worker();
$task->onWorkerStart = function(Worker $task)
{
    // ส่งอีเมลหลังจาก 10 วินาที
    $mail = new Mail();
    $to = 'workerman@workerman.net';
    $content = 'hello workerman';
    $mail->sendLater($to, $content);
};

// เรียกใช้ Worker
Worker::runAll();

8、定时函数为类的静态方法

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

class Mail
{
    // หมายเหตุ，นี่คือวิธี Static，พารามิเตอร์การเรียกกลับก็ต้องเป็น public
    public static function send($to, $content)
    {
        echo "send mail ...\n";
    }
}

$task = new Worker();
$task->onWorkerStart = function(Worker $task)
{
    // ส่งอีเมลหลังจาก 10 วินาที
    $to = 'workerman@workerman.net';
    $content = 'hello workerman';
    // เรียกใช้วิธี Static ของคลาสตามกำหนดเวลา
    Timer::add(10, array('Mail', 'send'), array($to, $content), false);
};

// เรียกใช้ Worker
Worker::runAll();

9、定时函数为类的静态方法(带命名空间)

namespace Task;

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

class Mail
{
    // หมายเหตุ，นี่คือวิธี Static，พารามิเตอร์การเรียกกลับก็ต้องเป็น public
    public static function send($to, $content)
    {
        echo "send mail ...\n";
    }
}

$task = new Worker();
$task->onWorkerStart = function(Worker $task)
{
    // ส่งอีเมลหลังจาก 10 วินาที
    $to = 'workerman@workerman.net';
    $content = 'hello workerman';
    // เรียกใช้วิธี Static ของคลาสที่มีชื่อระยะเวลา
    Timer::add(10, array('\Task\Mail', 'send'), array($to, $content), false);
};

// เรียกใช้ Worker
Worker::runAll();

10、定时器中销毁当前定时器（use闭包方式传递$timer_id）

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

$task = new Worker();
$task->onWorkerStart = function(Worker $task)
{
    // นับ
    $count = 1;
    // เพื่อให้ $timer_id สามารถส่งไปยังฟังก์ชันเรียกกลับได้ถูกต้องต้องใช้ & ข้างหน้า
    $timer_id = Timer::add(1, function()use(&$timer_id, &$count)
    {
        echo "Timer run $count\n";
        // หลังจากการทำงาน 10 ครั้งให้ทำลายตัวจับเวลา
        if($count++ >= 10)
        {
            echo "Timer::del($timer_id)\n";
            Timer::del($timer_id);
        }
    });
};

// เรียกใช้ Worker
Worker::runAll();

11、定时器中销毁当前定时器（参数方式传递$timer_id）

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

class Mail
{
    public function send($to, $content, $timer_id)
    {
        // เพิ่มชั่วคราวให้กับอ็อบเจ็กต์ปัจจุบันให้มีคุณลักษณะ count เพื่อนับจำนวนการทำงานของตัวจับเวลา
        $this->count = empty($this->count) ? 1 : $this->count;
        // หลังจากการทำงาน 10 ครั้งให้ทำลายตัวจับเวลา
        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 สามารถส่งไปยังฟังก์ชันเรียกกลับได้ถูกต้องต้องใช้ & ข้างหน้า
    $timer_id = Timer::add(1, array($mail, 'send'), array('to', 'content', &$timer_id));
};

// เรียกใช้ Worker
Worker::runAll();