CentOS 編譯安裝 PHP v8js 擴展完整實戰筆記（含坑點避雷）

V8js 讓 PHP 能直接執行 JavaScript 程式碼（基於 Google V8 引擎），但在 CentOS 上編譯安裝依賴地獄極深。本文記錄經過實測驗證的完整流程、版本鎖定策略與常見錯誤解法，助你一次成功。

環境與版本鎖定（關鍵）

核心步驟：編譯共享庫 libv8.so

# 1. 取得 V8 3.15.5 源碼
wget https://github.com/v8/v8-git-mirror/archive/3.15.5.tar.gz
tar xzf 3.15.5.tar.gz
cd v8-git-mirror-3.15.5

# 2. 下載依賴（需翻牆或預先鏡像）
make dependencies

# 3. 編譯共享庫（64 位系統用 x64.release）
make x64.release library=shared -j4   # -j4 可加速，但易觸發 internal error，建議去掉 -j

# 4. 安裝庫與頭文件
cp out/x64.release/lib.target/libv8.so /usr/lib64/
cp -r include/v8* /usr/include/

安裝 v8js 擴展

# 方式一：PECL 自動編譯（推薦）
pecl install v8js-0.1.3   # PHP 5.x
# pecl install v8js-2.1.1 # PHP 7+

# 方式二：手動編譯（需指定 v8 路徑）
cd v8js-0.1.3
phpize
./configure --with-v8js=/usr   # 若 libv8.so 在 /usr/lib64
make && make install

php.ini 啟用

extension=v8js.so

常見坑點與解法

1. make -j4 導致 internal compiler error
   • 原因：並行編譯記憶體不足或 GCC Bug。
   • 解法：移除 -j4，單執行緒編譯雖慢但穩定。
2. 64 位系統找不到 libv8.so
   • 檢查 ldconfig -p | grep v8，若無輸出，執行 ldconfig 刷新快取。
   • 確認 /usr/lib64/libv8.so 存在且權限 755。
3. PHP 為 64 位但編譯出 32 位 libv8.so
   • 必須使用 make x64.release 而非 ia32.release。
4. gcc 版本過新導致 V8 3.15 編譯失敗
   • CentOS 7 GCC 4.8.5 尚可；若更高版本報錯，考慮升級 V8 到 6.x 分支並搭配 v8js 2.x。
5. 缺少 re2c、libstdc++-devel 等建置工具
   • yum install re2c libstdc++-devel glibc-devel

驗證安裝

php -m | grep v8js
php -r 'echo (new V8Js)->executeString("1+1");'   # 輸出 2 即成功

編譯安裝 v8js 雖繁瑣，但掌握「版本鎖定、共享庫正確安裝、避開並行編譯」三大原則，即可在生產環境穩定運行。建議將編譯好的 libv8.so 與 v8js.so 打包成 RPM 或 Docker Image，實現不可變基礎設施。