如何解决PHP项目中microweber/screen包的PhantomJs权限拒绝致命错误？

问题概述 #

使用microweber/screen包进行网页截图时，触发以下致命错误：

[15-Feb-2023 20:51:43 UTC] PHP Fatal error:  Uncaught Screen\Exceptions\PhantomJsException: sh: 
/home/bloggors/capturewebpage.bloggors.com/vendor/microweber/screen/bin/phantomjs: Permission denied in 
/home/bloggors/capturewebpage.bloggors.com/vendor/microweber/screen/src/Capture.php:259
Stack trace:
#0 /home/bloggors/capturewebpage.bloggors.com/controller/index.php(12): Screen\Capture->save('files')
#1 /home/bloggors/capturewebpage.bloggors.com/router.php(46): include_once('/home/bloggors/...')
#2 /home/bloggors/capturewebpage.bloggors.com/router.php(7): route('/', 'controller/inde...')
#3 /home/bloggors/capturewebpage.bloggors.com/routes.php(14): get('/', 'controller/inde...')
#4 {main}
  thrown in /home/bloggors/capturewebpage.bloggors.com/vendor/microweber/screen/src/Capture.php on line 259

核心原因是PhantomJs二进制文件无执行权限，PHP进程无法调用它完成截图。

解决方案 #

1. 给PhantomJs文件添加执行权限 #

在服务器终端执行以下命令，为PhantomJs二进制文件赋予可执行权限：

chmod +x /home/bloggors/capturewebpage.bloggors.com/vendor/microweber/screen/bin/phantomjs

2. 匹配文件所属用户与PHP运行用户 #

确保PhantomJs文件的所属用户和组与PHP进程运行的用户一致（常见为www-data，需根据自身环境调整）：

# 先查看PHP运行用户：ps aux | grep php
chown www-data:www-data /home/bloggors/capturewebpage.bloggors.com/vendor/microweber/screen/bin/phantomjs

3. 验证父目录权限 #

确保PhantomJs所在的bin目录有读权限，避免PHP进程无法访问文件：

chmod 755 /home/bloggors/capturewebpage.bloggors.com/vendor/microweber/screen/bin

验证 #

完成上述操作后，重新运行你的index.php代码：

$url = 'https://github.com';

$screenCapture = new Capture($url);
$screenCapture->setWidth(1200);
$screenCapture->setHeight(800);
$fileLocation = 'files';
$screenCapture->save($fileLocation);
echo $screenCapture->getImageLocation();

此时应该能正常生成网页截图并返回图片路径。

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