Ubuntu 22.04下安装PHP V8Js遇编译报错，求解决方案

一、核心问题根源 #

你的问题本质是V8版本与V8JS版本不兼容，加上V8编译安装时的步骤缺失，导致依赖检测失败：

• Ubuntu 22.04官方源的libv8-dev被替换为libnode-dev，无法满足V8JS的依赖要求
• 直接编译最新V8会与旧版V8JS（2.1.2）的API不匹配
• 编译V8时未正确生成安装所需的头文件和库文件结构

二、分步解决方案 #

1. 编译兼容版本的V8 #

V8JS 2.1.2适配的V8版本为9.x系列（以9.8.177.13为例），需指定版本编译：

# 安装编译依赖
sudo apt-get install -y build-essential curl git python3 libglib2.0-dev

# 克隆depot_tools并配置环境变量
git clone https://chromium.googlesource.com/chromium/tools/depot_tools.git
export PATH=$PATH:$PWD/depot_tools

# 创建V8编译目录并拉取指定版本代码
mkdir -p ~/v8 && cd ~/v8
fetch v8
cd v8
git checkout 9.8.177.13
gclient sync

# 生成编译配置（生成共享库，便于V8JS链接）
gn gen out/x64.release --args='is_debug=false target_cpu="x64" v8_enable_v8_checks=false v8_enable_i18n_support=false use_custom_libcxx=false is_component_build=true'

# 编译并安装到系统路径
ninja -C out/x64.release
sudo mkdir -p /opt/v8/{lib,include}
sudo cp -r out/x64.release/lib*.so /opt/v8/lib/
sudo cp -r include/* /opt/v8/include/
sudo cp out/x64.release/icudtl.dat /opt/v8/lib/

# 配置动态库路径
echo "/opt/v8/lib" | sudo tee /etc/ld.so.conf.d/v8.conf
sudo ldconfig

2. 安装适配的V8JS版本 #

放弃pecl的旧版本，直接从PHP8分支克隆最新源码编译（已修复新V8的API兼容问题）：

# 安装PHP开发依赖
sudo apt-get install -y php-dev php-pear

# 克隆V8JS PHP8分支源码
git clone https://github.com/phpv8/v8js.git
cd v8js
git checkout php8

# 生成配置文件并编译
phpize
./configure --with-v8js=/opt/v8
make
sudo make install

# 启用扩展
echo "extension=v8js.so" | sudo tee /etc/php/8.1/mods-available/v8js.ini
sudo phpenmod v8js

# 验证安装
php -m | grep v8js

3. 针对性错误修复 #

• pecl安装时"无法确定libv8版本"：新版V8不再生成旧格式的version.h，手动创建版本文件：

  sudo echo '#define V8_MAJOR_VERSION 9' > /opt/v8/include/v8-version.h
  sudo echo '#define V8_MINOR_VERSION 8' >> /opt/v8/include/v8-version.h
  sudo echo '#define V8_BUILD_NUMBER 177' >> /opt/v8/include/v8-version.h
  sudo echo '#define V8_PATCH_LEVEL 13' >> /opt/v8/include/v8-version.h
  

• 手动编译时SetAccessor函数错误：使用V8JS的php8分支源码即可，该分支已修复V8 API变更的适配问题，无需修改代码。

三、验证安装 #

执行以下PHP代码确认V8JS正常工作：

<?php
$v8 = new V8Js();
echo $v8->executeString('"Hello from V8!"');
?>

运行后输出Hello from V8!则表示安装成功。

内容的提问来源于stack exchange，提问作者Rom7x