想用 PHP 寫高性能網路服務,libevent 擴展幾乎是必經之路。它的安裝過程並不難,但依賴關係隱蔽,錯誤訊息又給得含糊,第一次弄往往要卡上好一會兒。把整個過程與遇到的障礙記錄下來。
擴展本體從 PECL 取得:
https://pecl.php.net/package/libevent
解壓後進入目錄,先用 phpize 為擴展生成建置所需的檔案,再跑 configure:
$ cd libevent-version
$ /usr/local/php/bin/phpize
$ ./configure --with-php-config=/usr/local/php/bin/php-config
(若 PHP 已在 PATH 中,phpize 與 php-config 可省略絕對路徑。)
結果立刻報錯,訊息指向 re2c 版本過低。
re2c 是 PHP 用來做詞法分析的產生器,官網在 https://re2c.org/。從官網下載最新版,編譯安裝:
$ wget https://github.com/skvadrik/re2c/releases/download/x.xx/re2c-x.xx.tar.gz
$ tar zxvf re2c-x.xx.tar.gz
$ cd re2c-x.xx
$ ./configure
$ make && make install
裝好後再回去重跑擴展的 configure。
這次換了另一個錯誤:
error: Cannot find libevent headers
意思很明白——編譯器找不到 libevent 的開發標頭檔。到系統裡翻找一番,發現某個目錄下躺著一份 libevent-2.0.12-stable,但那只是執行時所需的函式庫,沒有搭配的 header,無法用於編譯。
解法是從原始碼完整安裝一份:
$ 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 指定安裝到獨立目錄而非系統預設路徑,是伺服器環境下的好习惯:不污染系統自帶的版本,日後要升級或移除只需換掉整個目錄,也不必擔心與發行版套件的依賴衝突。
依賴齊了,回來編譯擴展,這次記得把 libevent 的路徑明確告訴 configure:
$ 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
順利通過。
make install 只是把編譯好的 .so 放進擴展目錄,PHP 並不會自動載入它。最後一步是在 php.ini 中加上:
extension=libevent.so
存檔後重啟 PHP-FPM 或 Apache,用 php -m | grep libevent 或 phpinfo() 確認擴展已出現在列表中。
兩個錯誤訊息合起來說明了一件事:編譯 PHP 擴展時,所有 C 層級的依賴都得自己備齊。re2c 是建置工具鏈的一環,libevent 是被連結的函式庫,兩者性質不同,缺任何一個都會在 configure 階段就被攔下。
實務上有幾點可以省下不少時間:
./configure --help 或先看擴展的 README,確認它支援哪些 --with-xxx 參數,比逐一試錯快得多。libevent-devel / libevent-dev),用套件管理器安裝通常比手動編譯省事。手動編譯主要用在需要特定版本、或伺服器不允許動用套件庫的場合。Cannot find libevent headers 這類訊息背後隱含的「需要 -devel 套件或手動編譯」是社群裡的共通知識。swoole、event 這類仍在持續更新的替代方案,再決定要不要走這條路。