phpize, php-config),路徑如 /usr/local/php/bin/libevent 系統庫 (開發套件含 headers)re2c (PHP 詞法分析器產生器)# 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
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
# 套件管理器
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
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
# 找到 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
/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 found | re2c 版本 < 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 路徑正確 |
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();
libevent-devel (系統庫) + re2c + php-devel。libevent 擴展原始碼,phpize → configure --with-libevent=... → make install。php.ini 載入 libevent.so。ext-event,避免維護第三方 PECL 擴展。