使用PHP FFI调用webview库：自行编译PHP时无法显示窗口

出现(WebKitWebProcess:17649): Gtk-WARNING **: cannot open display:错误，本质是WebKit子进程无法连接到X11显示服务，下面是具体的解决步骤：

1. 补全编译依赖并重新编译PHP #

自行编译PHP时可能缺失了WebView依赖的X11/Gtk开发库，先安装所需包：

sudo pacman -S xorg-server-devel gtk3-devel webkit2gtk-devel

然后修改configure命令，添加--enable-shared选项（确保PHP以共享库方式编译，更好地继承系统环境变量）：

./configure --prefix=$(pwd)/target --with-config-file-scan-dir=$(pwd)/target/lib/conf.d --enable-zts --with-curl --with-ffi --enable-shared

重新清理编译安装：

make clean
make -j16
make install

2. 确保运行时环境变量正确传递 #

WebKit需要读取DISPLAY变量来定位X11显示服务，先检查变量是否存在：

echo $DISPLAY

正常输出应为:0或类似编号。如果为空，手动设置后再运行脚本：

export DISPLAY=:0
./target/bin/php your_webview_script.php

3. 验证X11访问权限 #

有时候当前用户没有访问X11显示的权限，执行以下命令临时授权：

xhost +local:$(whoami)

之后再运行PHP脚本测试。

为什么预编译PHP和Python能正常运行？ #

Manjaro软件源的预编译PHP默认以共享库方式构建，已经关联了系统X11相关依赖，能自动继承DISPLAY等环境变量；Python运行时会默认将父进程的环境变量传递给子进程，因此WebKit能正常获取显示环境。而自行编译的PHP如果是静态编译或缺失依赖，就会阻断这种环境传递。

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