在 CentOS 5/6 上為 PHP 5.4 編譯安裝 v8js(V8 JavaScript 引擎綁定)是依賴地獄:GCC、glibc、libstdc++、Python、re2c 版本必須精準匹配。本文記錄踩坑全過程,給出可復現的「舊版本組合拳」方案。
wget https://github.com/v8/v8-git-mirror/archive/3.15.5.tar.gz
tar zxvf 3.15.5.tar.gz
cd v8-git-mirror-3.15.5
make dependencies
make ia32.release library=shared -j4 # 32位;64位用 x64.release
警告:-j4 並行編譯極易觸發 internal compiler error,**強烈建議去掉 -j 參數單線程編譯**,雖慢但穩。
cp out/ia32.release/lib.target/libv8.so /usr/lib/
cp include/v8* /usr/include/
pecl install v8js-0.1.3
若 pecl 找不到 libv8,指定路徑:
pecl install --configureoptions \
'--with-v8js=/usr/local/v8' v8js-0.1.3
yum install glibc-devel.i686 libstdc++.i686
若 PHP 為 64 位(yum 安裝通常是),需編譯 64 位 libv8.so:
make x64.release library=shared
| 坑點 | 症狀 | 解法 |
|---|---|---|
| GCC 版本過高 | V8 3.15 編譯報錯 | 鎖定 GCC 4.4.7,勿升級 |
| glibc 版本過低 | 連結階段找不到符號 | CentOS 5 自帶 glibc 2.5 勉強可用,勿嘗試升級 glibc(系統級風險) |
| 並行編譯 -jN | 隨機 internal error | **去掉 -j,單線程編譯** |
| v8js 版本太新 | 要求更新 V8/API | 鎖定 v8js-0.1.3 |
| PHP 位數與 libv8 不匹配 | 載入擴展報 wrong ELF class | 確認 php -i | grep Architecture,編譯對應位數 libv8 |
php -m | grep v8js
php -r 'echo V8Js::V8_VERSION;'
若輸出 V8 版本號(如 3.15.5),安裝成功。此組合在 CentOS 5/6 + PHP 5.4 環境經過多專案驗證,穩定可用。新項目建議直接升級 PHP 7/8 + 官方 ext-v8js,避開依賴地獄。