想用 PHP 寫高性能網絡服務,libevent 擴展是必備的一塊。理論上按文檔走三步應該就行,實測卻接連撞上兩個錯誤。本文記錄整個過程,重點在於兩個報錯該怎麼解。
從 PECL 下載擴展源碼:https://pecl.php.net/package/libevent,解壓後開始編譯:
$ cd libevent-version
$ /usr/local/php/bin/phpize
$ ./configure --with-php-config=/usr/local/php/bin/php-config
立刻報錯,提示 re2c 版本過低。
re2c 是 PHP 用來生成詞法分析器的工具,部分擴展在編譯階段需要重新生成掃描器代碼,因此對它有版本要求。
去官網 https://re2c.org/ 下載最新版本,編譯安裝:
$ tar zxvf re2c-x.x.tar.gz
$ cd re2c-x.x
$ ./configure
$ make && make install
裝好後再回到擴展目錄重新 configure,第一個錯誤消失,但馬上迎來第二個。
error: Cannot find libevent headers
這個報錯的意思很直白:編譯器找不到 libevent 的開發頭文件。到這一步基本可以確認系統上要麼沒裝 libevent,要麼裝了但沒有 devel 包(缺少 event.h 等頭文件)。
排查後在系統裡找到了 libevent-2.0.12-stable 目錄。如果確實未安裝,先把它裝好:
wget https://cloud.github.com/downloads/libevent/libevent/libevent-2.0.20-stable.tar.gz
tar zxvf libevent-2.0.20-stable.tar.gz
cd libevent-2.0.20-stable/
./configure --prefix=/usr/local/libevent-2.0.20-stable/
make
make install
cd ../
這裡指定 --prefix 裝到獨立目錄,是為了避免污染系統默認路徑,也便於後續告訴 PHP 擴展去哪裡找它。
$ cd libevent-0.0.5
$ /usr/local/php/bin/phpize
$ ./configure --with-php-config=/usr/local/php/bin/php-config \
--with-libevent=/usr/local/libevent-2.0.20-stable
$ make && make install
關鍵就是 --with-libevent= 這個參數,明確指出 libevent 的安裝前綴。加上它之後,編譯順利通過。
編譯完成後別忘了最後兩步,否則擴展不會生效:
· 把 make install 輸出的路徑(通常是 /usr/local/php/lib/php/extensions/...)確認無誤。
· 在 php.ini 中加入 extension=libevent.so,重啟 php-fpm 或相應服務。
· 用 php -m | grep libevent 或 php --ri libevent 驗證是否加載成功。
這次排查積累的經驗其實很通用:
· PECL 擴展編譯依賴 PHP 的開發環境,phpize 需要 php-devel 一類的包,缺了它連第一步都走不通。
· 報錯要讀清楚主語。「Cannot find headers」說的是缺頭文件而非缺庫文件,這意味著需要安裝 devel/-dev 版本的包,僅有運行時庫是不夠的。
· 非標準路徑依賴一律顯式指定,用 --with-xxx=/path 傳參,比改 LD_LIBRARY_PATH 或往系統目錄裡塞文件都更可控。
· 最後提醒一句:PHP 官方的 libevent 擴展已多年未更新,與 PHP 7 之後的版本並不相容。若目的只是構建異步網絡服務,現在更合適的選擇是 Swoole、Workerman 或 ReactPHP,它們在 API 設計與維護狀態上都遠優於這個老擴展。