PHP Conference Japan 2024

    GearmanClient::doBackground

    (PECL gearman >= 0.5.0)

    GearmanClient::doBackground — 在背景執行任務

    描述

    public GearmanClient::doBackground(字串 $function, 字串 $workload, ?字串 $unique = null): 字串

    在背景執行任務，返回一個作業控制代碼，可用於獲取正在執行任務的狀態。

    參數

    函式

    Worker 需執行的已註冊函式

    工作負載

    待處理的序列化資料

    唯一

    用於識別特定任務的唯一 ID

    回傳值

    已提交任務的工作控制代碼。

    範例

    範例 #1 提交並監控背景工作

    此範例中的 worker 人為地加入了延遲，以模擬長時間運行的任務。用戶端腳本會定期檢查運行中任務的狀態。

    <?php

    /* 建立物件 */
    $gmclient= new GearmanClient();

    /* 加入預設伺服器 */
    $gmclient->addServer();

    /* 執行反向用戶端 */
    $job_handle = $gmclient->doBackground("reverse", "this is a test");

    if (    $gmclient->returnCode() != GEARMAN_SUCCESS)
    {
    echo     "錯誤的回傳碼\n";
    exit;
    }

    $done = false;
    do
    {
    sleep(3);
    $stat = $gmclient->jobStatus($job_handle);
    if (!    $stat[0]) // 工作已知，因此尚未完成
    $done = true;
    echo     "執行中: " . ($stat[1] ? "true" : "false") . ", 分子: " . $stat[2] . ", 分母: " . $stat[3] . "\n";
    }
    while(!    $done);

    echo     "完成!\n";

    ?>

    上述範例將輸出類似以下內容

    Running: true, numerator: 3, denominator: 14
Running: true, numerator: 6, denominator: 14
Running: true, numerator: 9, denominator: 14
Running: true, numerator: 12, denominator: 14
Running: false, numerator: 0, denominator: 0
done!

    另請參閱

    發現問題了嗎？

    瞭解如何改進此頁面 • 提交 Pull Request • 回報錯誤
    ＋新增註解

    使用者貢獻的筆記 1 則筆記

    8
    felix at passcod dot name
    7 年前
    唯一 ID 參數的行為

    如果未提供，則預設為 UUIDv1（時間戳記 + MAC 位址）。

    否則，如果存在具有相同唯一 ID 的作業（即已排入佇列或正在執行），則會使用該作業，而不是您提交的作業。這不適用於過去（已完成）的作業，並且在整個作業伺服器池中都有效，假設沒有分割區。

    或者使用程式碼（方括號中的值是伺服器分配的作業識別碼）

    <?php

    $gearman    ->doBackground('sleep', '3', '123'); // [H:host:1] 開始 sleep(3)
    $gearman->doBackground('sleep', '5', '456'); // [H:host:2] 將 sleep(5) 排入佇列
    $gearman->doBackground('sleep', '3', '123'); // [H:host:1] 什麼都不做
    $gearman->doBackground('sleep', '1', '123'); // [H:host:1] 也什麼都不做（不同的參數不會觸發新的作業）

    sleep (3);
    // 作業 123 [sleep(3)] 現在已經完成

    $gearman->doBackground('sleep', '3', '123'); // [H:host:3] 啟動新的作業

    ?>
    ＋新增註解
    To Top