Laravel中使用PHPWord添加图片触发最大执行时间错误如何解决？

问题根因 #

你遇到的超时是本地单进程Web服务死锁导致的：

• php artisan serve启动的PHP内置服务器是单线程运行的，同一时间只能处理一个请求
• 你给addImage传入HTTP格式的图片地址时，PHPWord会在当前请求中发起新的HTTP请求拉取图片，而内置服务器已经被当前生成文档的请求占用，无法响应图片请求，最终陷入无限等待触发超时
• 你用asset()助手生成的依然是HTTP格式的路径，所以问题没有解决

解决方案 #

最优方案：使用本地绝对路径读取图片 #

直接读取本地服务器上的图片文件，跳过HTTP请求环节，不会触发死锁，性能也更高。Laravel中可以用public_path()助手获取public目录的绝对路径，修改代码如下：

public function generateDocx()
{
    $phpWord = new \PhpOffice\PhpWord\PhpWord();
    $section = $phpWord->addSection();

    // 替换为本地绝对路径，不要用HTTP路径
    $headerLogo = public_path('img/logoAnevBulanan.png');
    $section->addImage($headerLogo);

    // 后续下载docx的逻辑保持不变
}

其他适配方案 #

如果你的图片确实是存放在远程第三方服务，无法直接读取本地文件：

• 先通过file_get_contents或者Laravel的Http客户端把远程图片下载到本地临时目录，再把本地临时路径传给addImage
• 本地测试环境替换为Nginx+PHP-FPM这类支持多进程的服务，避免单进程死锁问题

可选优化点 #

• 确认图片文件权限正常，PHP进程有文件读取权限
• 若必须使用HTTP路径，可提前将配置项allow_url_fopen设置为On（不推荐，安全性和性能都不如本地读取）

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