Windows 環境安裝 PHP pthreads 多執行緒擴充套件完整教學

前言：為什麼需要 pthreads？

PHP 預設為單執行緒執行模型，面對 CPU 密集型任務（如圖片處理、大量資料運算）或高併發 I/O 任務（如爬蟲、API 批次請求）時效能受限。pthreads 是 PHP 官方維護的多執行緒擴充套件，能在 CLI 模式下建立真正的平行執行緒，大幅提升多核心 CPU 利用率。注意：pthreads 僅支援 CLI SAPI，不支援 Apache/Nginx 等 Web SAPI 環境。

步驟 1：確認 PHP 版本與 Thread Safety (TS/ NTS)

<?php phpinfo(); ?>

在輸出中尋找 Thread Safety 欄位：

• enabled → TS (Thread Safe) 版本，需下載含 -ts- 的 pthreads 檔案。
• disabled → NTS (Non-Thread Safe) 版本，需下載含 -nts- 的檔案。

同時記下：

• PHP 版本（如 7.4、8.1、8.2）
• 編譯器版本（VC15 / VS16 等，對應 Visual Studio 版本）
• 架構：x86 (32-bit) 或 x64 (64-bit)

步驟 2：下載對應的 pthreads DLL

前往 PECL 官方下載頁：https://pecl.php.net/package/pthreads

• PHP 7.x 選擇 3.x 版本系列（如 3.1.6）。
• PHP 8.0+ 選擇 4.x 版本系列（如 4.0.0）。
• 下載 php_pthreads---ts/nts-vc<編譯器>-x86/x64.zip。

範例： PHP 8.1 TS VC16 x64 → php_pthreads-4.0.0-8.1-ts-vs16-x64.zip

步驟 3：安裝擴充套件

1. 解壓縮 ZIP，取得兩個檔案：
   • php_pthreads.dll → 複製到 PHP 安裝目錄下的 ext/ 資料夾。
   • pthreadVC2.dll (或 pthreadVC3.dll) → 複製到 PHP 執行檔同層目錄（即 php.exe 所在資料夾），同時也建議複製一份到系統路徑（如 C:\Windows\System32 或 Apache 的 bin/ 目錄），避免 CLI 與 Web 環境找不到 DLL。
2. 編輯 php.ini，在 Dynamic Extensions 區塊新增：
   extension=pthreads
3. 重啟命令提示字元（或重啟電腦）使環境變數生效。

步驟 4：驗證安裝

php -m | findstr pthreads

或執行測試腳本：

<?php
// test_threads.php
class AsyncOperation extends Thread {
    public $arg;
    public function __construct($arg) { $this->arg = $arg; }
    public function run() {
        if ($this->arg) {
            printf("Hello %s\n", $this->arg);
        }
    }
}

$thread = new AsyncOperation("World");
$thread->start();
$thread->join();
echo "執行緒測試完成\n";
?>

執行 php test_threads.php，若輸出 Hello World 且無錯誤，即代表安裝成功！

常見問題排除

進階應用建議

• Worker Pool 模式：使用 Pool 類別管理固定數量的 Worker 執行緒，避免無限建立執行緒導致資源耗盡。
• 資料共享：透過 Threaded 物件（如 Volatile、Stackable）在執行緒間安全傳遞資料。
• 同步機制：善用 Mutex、Cond 實現執行緒同步與訊號通知。

結語

在 Windows 上部署 pthreads 的關鍵在於「版本對齊」：PHP 版本、TS/NTS、VC 編譯器、位元數四項必須完全一致。安裝完成後，即可在 CLI 腳本中發揮多核心效能，處理大規模平行運算任務。記住：Web 環境請勿嘗試載入 pthreads，否則會導致伺服器不穩定。