萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

Linux 編譯安裝 PHP libevent 擴展完整步驟與常見錯誤排查

前置條件

  • 已安裝 PHP (含 phpize, php-config),路徑如 /usr/local/php/bin/
  • 已安裝 libevent 系統庫 (開發套件含 headers)
  • 已安裝 re2c (PHP 詞法分析器產生器)
  • GCC、Make、Autoconf 等建構工具

步驟 1:安裝/確認 libevent 系統庫

# Ubuntu/Debian
sudo apt-get update && sudo apt-get install -y libevent-dev

# CentOS/RHEL/Rocky/Alma
sudo yum install -y libevent-devel
# 或 dnf install -y libevent-devel

# 驗證
pkg-config --libs --cflags libevent
# 輸出應包含 -I/usr/include -L/usr/lib -levent

若套件庫版本過舊,手動編譯新版 libevent

cd /usr/local/src
wget https://github.com/libevent/libevent/releases/download/release-2.1.12-stable/libevent-2.1.12-stable.tar.gz
tar zxvf libevent-2.1.12-stable.tar.gz
cd libevent-2.1.12-stable
./configure --prefix=/usr/local/libevent-2.1.12
make -j$(nproc) && make install

# 關鍵:讓 pkg-config 找到它
echo '/usr/local/libevent-2.1.12/lib' > /etc/ld.so.conf.d/libevent.conf
ldconfig
export PKG_CONFIG_PATH=/usr/local/libevent-2.1.12/lib/pkgconfig:$PKG_CONFIG_PATH

步驟 2:安裝 re2c (若缺少)

# 套件管理器
sudo apt-get install -y re2c   # 或 yum/dnf install re2c

# 或原始碼安裝 (取最新版)
cd /usr/local/src
wget https://github.com/skvadrik/re2c/releases/download/3.0/re2c-3.0.tar.xz
tar xf re2c-3.0.tar.xz && cd re2c-3.0
./configure --prefix=/usr/local/re2c && make -j$(nproc) && make install
export PATH=/usr/local/re2c/bin:$PATH

步驟 3:下載並編譯 php-libevent 擴展

cd /usr/local/src
# 從 PECL 下載指定版本 (對應 PHP 版本)
# PHP 7.x 用 libevent-0.1.0+ ; PHP 8.x 需較新版或從 git 克隆
wget https://pecl.php.net/get/libevent-0.1.0.tgz   # 範例版本
tar zxvf libevent-0.1.0.tgz
cd libevent-0.1.0

# phpize 產生 configure
/usr/local/php/bin/phpize

# 配置:指定 php-config 與 libevent 路徑
./configure \
    --with-php-config=/usr/local/php/bin/php-config \
    --with-libevent=/usr/local/libevent-2.1.12   # 若 libevent 在標準路徑可省略

# 編譯安裝
make -j$(nproc) && make install

步驟 4:啟用擴展

# 找到 php.ini 路徑
/usr/local/php/bin/php --ini

# 編輯 php.ini,新增
extension=libevent.so

# 或建立獨立 ini (推薦,模組化管理)
echo "extension=libevent.so" > /usr/local/php/etc/conf.d/libevent.ini

步驟 5:驗證安裝

/usr/local/php/bin/php -m | grep libevent
# 應輸出: libevent

/usr/local/php/bin/php -r "echo extension_loaded('libevent') ? 'OK' : 'FAIL';"
# OK

常見錯誤與解決方案

錯誤訊息原因解決方法
re2c version too old 或 re2c not foundre2c 版本 < 0.13.5 或未安裝升級/安裝 re2c 至最新版 (>= 1.0 建議)
Cannot find libevent headers / libevent not found缺少 libevent-devel 或路徑未正確指定安裝開發套件;手動編譯需 --with-libevent=/path/to/libevent
libevent version too old系統 libevent < 2.0 (舊版 API 不相容)手動編譯安裝 libevent 2.1+ 並指定路徑
php.h not found缺少 php-devel/php-dev 套件apt install php-dev 或 yum install php-devel
make: *** [libevent.lo] Error 1 (編譯錯誤)PHP 版本與擴展版本不匹配 (如 PHP 8 用舊擴展)檢查 PECL 頁面對應版本;PHP 8 可能需從 git master 編譯或改用 ext-event (libevent 綁定)
運行時 undefined symbol: event_base_new動態連結找不到 libevent 共享庫ldconfig 更新快取;檢查 LD_LIBRARY_PATH;確認 php -i | grep libevent 路徑正確

現代替代方案:PHP 8+ 內建 ext-event (libevent 綁定)

PHP 7.3+ 核心內建 event 擴展 (基於 libevent),提供完整事件循環、緩衝區、HTTP 伺服器等功能,**無需額外編譯 PECL libevent**。

# PHP 7.3+ 通常預設編譯啟用 --enable-event
# 驗證
php -m | grep -i event
# event

# 使用範例:簡易 HTTP 伺服器
$base = new EventBase();
$http = new EventHttp($base);
$http->setCallback("/api", function($req) {
    $req->sendReply(200, "OK", "Hello libevent via ext-event!");
});
$http->bind("0.0.0.0", 8080);
$base->loop();

總結

  1. 安裝 libevent-devel (系統庫) + re2c + php-devel。
  2. 下載 PECL libevent 擴展原始碼,phpize → configure --with-libevent=... → make install。
  3. 修改 php.ini 載入 libevent.so。
  4. 新專案強烈建議直接使用 PHP 內建 ext-event,避免維護第三方 PECL 擴展。
copyright © 萬盛學電腦網 all rights reserved