PHP 設計初衷是「請求-回應」的短生命週期模型:
多進程模型 將「主進程(調度/監控)」與「子進程(實際工作)」分離,子進程結束自動釋放所有資源(記憶體、檔案描述符、資料庫連線),主進程存活、可重啟失敗任務,實現錯誤隔離、資源回收、架構清晰三大目標。
pcntl_fork():建立子進程(複製父進程記憶體空間,Copy-on-Write)pcntl_wait() / pcntl_waitpid():等待子進程結束,取得狀態碼pcntl_signal():訊號處理(SIGTERM、SIGCHLD、SIGINT)posix_getpid()、posix_getppid()、posix_kill():進程身分與控制限制: 僅支援 CLI SAPI,Windows 不支援(需 WSL、Docker 或 Linux 伺服器)。
主進程讀取使用者輸入 → Fork 子進程 eval() 執行 → 等待子進程結束 → 顯示狀態 → 循環。
<?php
#!/usr/bin/env php
<?php
/**
* PHP CLI 多進程命令解析器
* 主進程:讀取輸入、分發任務、監控子進程
* 子進程:隔離執行使用者程式碼、自動清理資源
*/
// 僅允許 CLI 執行
if (substr(php_sapi_name(), 0, 3) !== 'cli') {
die("This program can only run in CLI mode\n");
}
// 移除執行時間限制
set_time_limit(0);
// 訊號處理:優雅關閉
$shutdown = false;
pcntl_signal(SIGTERM, function() use (&$shutdown) { $shutdown = true; });
pcntl_signal(SIGINT, function() use (&$shutdown) { $shutdown = true; });
$pid = posix_getpid();
$user = posix_getlogin() ?: 'user';
echo <<getMessage()}\n";
}
echo "* Child process $childPid finished\n";
exit(0); // 正常退出,資源自動釋放
} else {
// ===== 父進程 =====
// 非阻塞等待:配合 pcntl_signal_dispatch() 處理訊號
while (true) {
$waitPid = pcntl_waitpid($pid, $status, WUNTRACED | WNOHANG);
if ($waitPid === $pid) {
// 子進程結束
if (pcntl_wifexited($status)) {
$exitCode = pcntl_wexitstatus($status);
echo "\n* Child $pid exited with code $exitCode\n";
} elseif (pcntl_wifsignaled($status)) {
$sig = pcntl_wtermsig($status);
echo "\n* Child $pid terminated by signal $sig\n";
} elseif (pcntl_wifstopped($status)) {
$sig = pcntl_wstopsig($status);
echo "\n* Child $pid stopped by signal $sig\n";
}
break;
}
// 父進程可在此處理其他事務(如讀取下一指令、監控其他子進程)
pcntl_signal_dispatch();
usleep(10000); // 10ms 避免佔滿 CPU
}
}
}
子進程複製父進程頁面表(Copy-on-Write),寫入時才真正複製記憶體。子進程執行 eval() 產生的變數、物件、資料庫連線,結束時隨進程銷毀,不汙染父進程。
使用 WNOHANG + pcntl_signal_dispatch() 迴圈,父進程可同時:
<?php
// pcntl_waitpid 回傳的 $status 解碼
if (pcntl_wifexited($status)) {
// 正常 exit(code)
$code = pcntl_wexitstatus($status); // 0-255
} elseif (pcntl_wifsignaled($status)) {
// 被信號殺死
$sig = pcntl_wtermsig($status); // SIGKILL=9, SIGSEGV=11...
$coredump = pcntl_wcoredump($status);
} elseif (pcntl_wifstopped($status)) {
// 被信號暫停
$sig = pcntl_wstopsig($status);
}
<?php
/**
* 簡易 Worker Pool:固定 N 個子進程並行處理任務
*/
class WorkerPool
{
private int $workerCount;
private array $workers = []; // pid => ['pipe' => resource, 'busy' => bool]
private array $taskQueue = [];
private int $maxTasksPerWorker = 100; // 防記憶體洩漏,定期重啟
public function __construct(int $workerCount = 4)
{
$this->workerCount = $workerCount;
}
public function addTask(callable $task, array $args = []): void
{
$this->taskQueue[] = [$task, $args];
$this->dispatch();
}
private function dispatch(): void
{
// 清理已完成的 Worker
foreach ($this->workers as $pid => &$worker) {
if (!$worker['busy']) continue;
$status = 0;
$ret = pcntl_waitpid($pid, $status, WNOHANG);
if ($ret === $pid) {
fclose($worker['pipe']);
unset($this->workers[$pid]);
$this->spawnWorker();
}
}
// 分發任務給閒置 Worker
while ($this->taskQueue && count($this->workers) < $this->workerCount) {
$this->spawnWorker();
}
}
private function spawnWorker(): void
{
$pipe = [];
if (!pcntl_socketpair(AF_UNIX, SOCK_STREAM, 0, $pipe)) {
throw new RuntimeException('Failed to create socket pair');
}
$pid = pcntl_fork();
if ($pid === -1) throw new RuntimeException('Fork failed');
if ($pid === 0) {
// Child
fclose($pipe[0]); // 關閉父進程端
$this->workerLoop($pipe[1]);
exit(0);
} else {
// Parent
fclose($pipe[1]); // 關閉子進程端
$this->workers[$pid] = ['pipe' => $pipe[0], 'busy' => false, 'tasks' => 0];
}
}
private function workerLoop($socket): void
{
while (true) {
// 從父進程讀取任務序列化資料
$data = fread($socket, 8192);
if ($data === '' || $data === false) break; // 父進程關閉
$task = unserialize($data, ['allowed_classes' => false]);
if (!$task) continue;
try {
($task[0])(...$task[1]); // 執行 callable
} catch (Throwable $e) {
// 記錄錯誤、發送結果回父進程...
}
// 簡化:實際應雙向通訊回報結果
}
}
public function waitAll(): void
{
while ($this->workers || $this->taskQueue) {
$this->dispatch();
usleep(50000);
}
}
}
| 坑 | 現象 | 解決 |
|---|---|---|
| Windows 不支援 PCNTL | 呼叫 pcntl_fork() 致命錯誤 | 使用 WSL2、Docker、Linux 伺服器;或改用 popen()、symfony/process、amphp/parallel 等跨平台替代 |
| 資料庫連線在 Fork 後失效 | 父進程建立 PDO,子進程繼承同一連線,關閉時互相影響 | 子進程內重新建立連線;或 Fork 前關閉連線,子進程自行連線 |
| 檔案描述符洩漏 | 父進程打開大量檔案/連線,Fork 後子進程繼承,未關閉導致耗盡 | Fork 後子進程立即關閉不需要的資源;使用 posix_close()、fclose() |
| 殭屍進程 | 父進程未 wait() 子進程,累積 | 設置 SIGCHLD 處理器呼叫 pcntl_wait();或定期輪詢 pcntl_waitpid(-1, $status, WNOHANG) |
| 記憶體洩漏累積 | 長運行 Worker 記憶體單調增長 | 設定 maxTasksPerWorker,完成 N 任務後自殺,主進程重啟新 Worker |
| 訊號處理器中不能做複雜操作 | 在 signal handler 內呼叫非 async-signal-safe 函數導致死鎖 | Handler 僅設標誌位,主迴圈檢查標誌位處理 |
PHP CLI 多進程透過 PCNTL + POSIX 實現進程隔離、資源自動回收、錯誤容錯,是編寫長期運行守護進程、批次處理器、任務佇列消費者的基石。掌握 fork → child work → exit → parent wait 核心流程、訊號處理、資源隔離原則,即可打造穩健的系統級 PHP 程式。生產環境建議優先使用成熟框架(Laravel Queue、Symfony Messenger)或高階運行時,專注業務邏輯而非底層進程管理。