Ubuntu下PHP7.0通过shell_exec调用wkhtmltoimage失效求助

你的问题根源很明确：wkhtmltoimage 是依赖X Window显示环境的GUI程序，而Nginx搭配的PHP-FPM是在无桌面的后台进程中运行的，没有默认的DISPLAY环境变量——这就是为什么终端能正常执行（你的终端处于桌面环境，自带可用的DISPLAY），但PHP调用时会抛出QXcbConnection: Could not connect to display错误的原因。

下面是具体的解决方案，按优先级推荐：

方法一：用xvfb-run临时创建虚拟显示环境（最推荐） #

这是最简单可靠的方式，xvfb-run会自动为命令创建一个临时的X虚拟显示，执行完就销毁，不需要额外维护服务。

1. 首先安装Xvfb工具：

sudo apt-get update && sudo apt-get install xvfb -y

2. 修改你的PHP代码，用xvfb-run包装wkhtmltoimage命令：

shell_exec("xvfb-run -a /usr/bin/wkhtmltoimage http://google.com screen.png > debug.log 2>&1");

其中-a参数表示自动寻找可用的显示编号，避免手动指定:0或:1可能出现的冲突。

方法二：手动启动Xvfb服务并指定DISPLAY #

如果你需要长期运行虚拟显示（比如频繁调用截图），可以手动启动Xvfb服务，然后在PHP中指定DISPLAY变量：

1. 安装Xvfb（同上），然后启动服务：

Xvfb :1 -screen 0 1024x768x16 &

这里:1是显示编号，1024x768x16是分辨率和色深，可按需调整。

2. 在PHP代码中先设置环境变量，再调用命令：

putenv("DISPLAY=:1");
shell_exec("/usr/bin/wkhtmltoimage http://google.com screen.png > debug.log 2>&1");

注意：这种方式需要确保Xvfb服务一直运行，可以把它加入开机自启（比如用systemd配置服务）。

额外需要检查的权限问题 #

除了显示环境，还要确保PHP运行用户（通常是www-data）有足够的权限：

• 目标目录（生成screen.png的目录）需要www-data有写入权限：

sudo chown www-data:www-data /path/to/your/output/directory

• 确保wkhtmltoimage本身有可执行权限：

sudo chmod +x /usr/bin/wkhtmltoimage

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