萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

PHP CLI 多進程架構實戰:利用 PCNTL 打造穩健的長期運行命令解析器

為什麼 PHP CLI 需要多進程?

PHP 設計初衷是「請求-回應」的短生命週期模型:

  • 無專用 GC 守護程序: 長運行腳本易記憶體洩漏,導致 OOM Abort
  • 單執行緒: 一個致命錯誤(非法輸入、擴充套件 Crash)即終結整個進程
  • 資源隔離缺失: 佇列處理、定時任務、WebSocket 伺服器混在一起,牽一髮動全身

多進程模型 將「主進程(調度/監控)」與「子進程(實際工作)」分離,子進程結束自動釋放所有資源(記憶體、檔案描述符、資料庫連線),主進程存活、可重啟失敗任務,實現錯誤隔離、資源回收、架構清晰三大目標。

核心擴充套件:PCNTL + POSIX

  • 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 伺服器)。

實戰範例:互動式 PHP 程式碼執行器

主進程讀取使用者輸入 → 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
        }
    }
}

關鍵技術細節解析

1. Fork 後的記憶體隔離

子進程複製父進程頁面表(Copy-on-Write),寫入時才真正複製記憶體。子進程執行 eval() 產生的變數、物件、資料庫連線,結束時隨進程銷毀,不汙染父進程。

2. 訊號驅動的非阻塞等待

使用 WNOHANG + pcntl_signal_dispatch() 迴圈,父進程可同時:

  • 等待特定子進程結束
  • 處理 SIGCHLD(其他子進程結束)
  • 處理 SIGTERM/SIGINT(優雅關閉)
  • 執行其他調度邏輯

3. 子進程狀態碼完整解析

<?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);
}

生產級工作佇列模式:主進程分發、Worker 池消費

<?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 僅設標誌位,主迴圈檢查標誌位處理

現代替代方案:不想寫底層 PCNTL 怎麼辦?

  • Symfony Process / Messenger:高層封裝,支援 Worker、Retry、Queue(Redis/RabbitMQ)
  • Laravel Queue / Horizon:生產級佇列系統,內建監控、重試、速率限制
  • ReactPHP / Amp:非阻塞事件迴圈,單進程高併發,避開 Fork 複雜度
  • RoadRunner / Swoole:長駐應用伺服器,Worker 管理內建
  • Gearman / RabbitMQ + 獨立 Consumer:分散式任務佇列,語言無關

總結

PHP CLI 多進程透過 PCNTL + POSIX 實現進程隔離、資源自動回收、錯誤容錯,是編寫長期運行守護進程、批次處理器、任務佇列消費者的基石。掌握 fork → child work → exit → parent wait 核心流程、訊號處理、資源隔離原則,即可打造穩健的系統級 PHP 程式。生產環境建議優先使用成熟框架(Laravel Queue、Symfony Messenger)或高階運行時,專注業務邏輯而非底層進程管理。

copyright © 萬盛學電腦網 all rights reserved