Laravel生成DOC文件后图片在Windows系统不显示问题求助

API 探路者

2026-7-7

问题解决：Laravel生成DOC文件图片在Windows不显示

直接把HTML内容以application/msword类型存为.doc文件的方式，本质是依赖Office的旧兼容机制，不同系统的Office软件解析规则差异极大——Ubuntu下的LibreOffice对这种“伪DOC”的Base64图片支持更宽松，而Windows的Word严格遵循二进制DOC规范，导致图片无法加载。

正确解决方案：用PHPWord库生成标准DOC文档

PHPWord是专门生成Word文档的PHP库，能确保文件符合规范，在不同系统的Office软件中都能正常显示图片。

步骤1：安装PHPWord

在Laravel项目根目录执行：

composer require phpoffice/phpword

步骤2：重写生成DOC的代码

替换原有代码为以下实现：

use PhpOffice\PhpWord\PhpWord;
use Illuminate\Support\Str;
use Illuminate\Support\Facades\Storage;

// 初始化PHPWord实例
$phpWord = new PhpWord();
// 添加文档章节
$section = $phpWord->addSection();

// 添加描述文本
$section->addText('description');

// 图片远程地址
$imageUrl = 'https://staging-sub.s3.ap-south-1.amazonaws.com/20231102132857p11UD.jpg';
// 下载图片到临时文件
$tempImage = tempnam(sys_get_temp_dir(), 'doc_img');
file_put_contents($tempImage, file_get_contents($imageUrl));

// 向文档中插入图片并设置尺寸
$section->addImage($tempImage, [
    'width' => 500,
    'height' => 333,
]);

// 生成临时DOC文件
$tempDoc = tempnam(sys_get_temp_dir(), 'doc_output') . '.doc';
$phpWord->save($tempDoc);

// 上传到S3
$fileName = Str::random() . time() . '.doc';
$fullpath = $folderName . '/' . $fileName;

Storage::disk('s3')->put($fullpath, file_get_contents($tempDoc), [
    'ContentDisposition' => 'attachment; filename=' . $fileName,
    'ContentType' => 'application/msword',
]);

// 清理临时文件
unlink($tempImage);
unlink($tempDoc);

// 触发文件下载
return Storage::disk(config("filesystems.default"))->download($fullpath);