DIV CSS 佈局教程網

Linux 下手動編譯安裝 PHP libevent 擴展的完整踩坑記錄
編輯:關於JavaScript     

想用 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 版本不足

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。

三、障礙二:找不到 libevent 標頭檔

這次換了另一個錯誤:

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 套件或手動編譯」是社群裡的共通知識。
  • 另外提醒,libevent 這支 PHP 擴展的維護並不活躍,與 PHP 新版本的相容性存在風險。若專案是新啟動的,值得先評估 swoole、event 這類仍在持續更新的替代方案,再決定要不要走這條路。
XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved