# onTask [TOC] 在task\_worker進程內被調用。worker進程可以使用swoole\_server\_task函數向task\_worker進程投遞新的任務。當前的Task進程在調用`onTask`回調函數時會將進程狀態切換為**忙碌**，這時將不再接收新的Task，當`onTask`函數返回時會將進程狀態切換為**空閑**然后繼續接收新的Task。 ~~~ function onTask(swoole_server $serv, int $task_id, int $src_worker_id, mixed $data); ~~~ * $task\_id是任務ID，由swoole擴展內自動生成，用于區分不同的任務。**$task\_id和$src\_worker\_id組合起來才是全局唯一的，不同的worker進程投遞的任務ID可能會有相同** * $src\_worker\_id來自于哪個worker進程 * $data 是任務的內容 > `onTask`函數執行時遇到致命錯誤退出，或者被外部進程強制kill，當前的任務會被丟棄，但不會影響其他正在排隊的Task ### V4.2.12起如果開啟了 task\_enable\_coroutine 則回調函數原型是 ~~~ $server->on('Task', function ($serv, Swoole\Server\Task $task) { //來自哪個`Worker`進程 $task->workerId; //任務的編號 $task->id; //任務的類型，taskwait, task, taskCo, taskWaitMulti 可能使用不同的 flags $task->flags; //任務的數據 $task->data; //協程 API co::sleep(0.2); //完成任務，結束并返回數據 $task->finish([123, 'hello']); }); ~~~ ## 返回執行結果到worker進程 1.7.2以上的版本，在onTask函數中 return字符串，表示將此內容返回給worker進程。worker進程中會觸發onFinish函數，表示投遞的task已完成，當然你也可以通過`swoole_server->finish()`來觸發onFinish函數，而無需再return * return的變量可以是任意非`null`的PHP變量 1.7.2以前的版本，需要調用`swoole_server->finish()`函數將結果返回給worker進程