萬盛學電腦網

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

PHP 執行緒安全 (ZTS) 編譯與 pthreads 擴展安裝指南

背景知識

ZTS (Zend Thread Safety) 是 PHP 的執行緒安全版本,用於多執行緒 SAPI (如 Apache worker MPM、IIS)。預設編譯為非執行緒安全 (NTS),用於 PHP-FPM、CLI。pthreads 擴展**強制要求 ZTS 版本 PHP**。

完整編譯安裝流程 (Linux)

1. 編譯安裝 ZTS 版 PHP

# 下載源碼
cd /usr/local/src
wget https://www.php.net/distributions/php-8.2.10.tar.gz
tar xzf php-8.2.10.tar.gz
cd php-8.2.10

# 關鍵:--enable-maintainer-zts (舊版 --with-tsrm-pthreads)
./configure \
    --prefix=/usr/local/php-zts \
    --enable-maintainer-zts \
    --with-config-file-path=/usr/local/php-zts/etc \
    --enable-mbstring \
    --with-curl \
    --with-openssl \
    --with-pdo-mysql=mysqlnd \
    --with-mysqli=mysqlnd \
    --enable-fpm \
    --with-fpm-user=www \
    --with-fpm-group=www \
    # 其他所需擴展...

make -j$(nproc)
make install

# 驗證
/usr/local/php-zts/bin/php -v | grep -i thread
# 輸出應包含: Zend Thread Safety (ZTS) => enabled

2. 安裝 pthreads (PECL)

# 使用 ZTS 版本的 phpize/php-config
cd /usr/local/src
wget https://pecl.php.net/get/pthreads-4.1.4.tgz  # PHP 8.x 對應版本
tar xzf pthreads-4.1.4.tgz
cd pthreads-4.1.4

/usr/local/php-zts/bin/phpize
./configure --with-php-config=/usr/local/php-zts/bin/php-config
make -j$(nproc)
make install

# 啟用擴展
echo "extension=pthreads" > /usr/local/php-zts/etc/conf.d/pthreads.ini

3. 驗證安裝

/usr/local/php-zts/bin/php -m | grep pthreads
# 應輸出 pthreads

/usr/local/php-zts/bin/php -r "
\$t = new class extends Thread {
    public function run() { echo \"Thread running\n\"; }
};
\$t->start();
\$t->join();
"

常見錯誤與解決

錯誤原因解決
configure: error: pthreads requires ZTSPHP 非 ZTS 編譯重新編譯 PHP 加 --enable-maintainer-zts
phpize: command not found未安裝 php-dev / php-develapt install php8.2-dev 或 yum install php-devel
No configure script found下載的是 GitHub 源碼非 PECL 發布包必須從 pecl.php.net/get/pthreads-.tgz 下載
編譯通過但啟動報 undefined symbolPHP 版本與 pthreads 版本不匹配嚴格對應:PHP 8.0/8.1→pthreads 4.x, PHP 7.x→pthreads 3.x

重要遷移提醒:pthreads 在 PHP 8.1+ 官方不再維護

  • PHP 8.1+ 官方推薦使用 Fibers (纖程):Fiber 類原生支援協程式並發,無需 ZTS、無需擴展。
  • Swoole / OpenSwoole / RoadRunner**:高效能協程伺服器,生產級異步方案。
  • ReactPHP / Amp:純 PHP 事件驅動庫,無擴展依賴。

Fibers 簡單範例 (PHP 8.1+)

<?php
$fiber = new Fiber(function (): void {
    $value = Fiber::suspend('fiber suspended');
    echo "Fiber resumed with: $value\n";
});

$value = $fiber->start();
echo "Main: $value\n";

$fiber->resume('main resumed');
echo "Done\n";

結論

若維護舊專案必須用 pthreads,嚴格按上述流程編譯 ZTS PHP + 對應版本 pthreads。新專案請直接使用 PHP 8.1+ Fibers 或 Swoole/OpenSwoole,獲得更好效能、更簡單部署、官方長期支援。

copyright © 萬盛學電腦網 all rights reserved