php生成word文档时image标签不渲染，必须用phpword等原生支持ooxml的库；插入图片需绝对路径、显式单位（如cm），远程图须先下载为临时文件再传入，且注意原始分辨率与word客户端压缩设置。
PHP 生成 Word 文档时，image 标签不渲染？别用 HTML 转换
Word 不认 <img alt="php图片怎么插入到word_php图片怎么导入word文档【步骤】" >，哪怕你用 PHPWord 或 domdocument 拼 HTML 再转 .docx，图片基本会丢失或显示为红叉。本质是 Word 的 .docx 是 ZIP+XML 结构，图片得作为独立 part 嵌入，再被 document.xml 引用。
正确路径只有一条：用原生支持 Office Open XML 的库，比如 PHPWord（官方名 phpoffice/phpword），它内部处理了图片压缩、关系 ID 绑定、content-types 注册等细节。
- 别用
file_get_contents()+str_replace()往模板里塞 base64 图片 —— Word 打不开 - 别在 HTML 模板里写
<img src="xxx.jpg" alt="php图片怎么插入到word_php图片怎么导入word文档【步骤】" >然后用htmltodocx类库 —— 兼容极差，仅支持极简标签 - 如果必须从 HTML 入口，优先选
unoconv或 LibreOffice 命令行转换（但需服务端装 GUI 环境，不推荐生产）
PHPWord 插入本地图片的最小可行代码
不是调 addImage() 就完事——路径、类型、尺寸参数错一个，图片就静默失败或变形。
关键点：addImage() 必须传绝对路径；相对路径会被解析成 PHP 进程工作目录，不是脚本所在目录；图片宽高单位是「EMU」（English Metric Unit），1 厘米 ≈ 360000 EMU，但更安全的是用 width/height 配合 unit 参数设为 CM 或 INCH。
立即学习“PHP免费学习笔记（深入）”；
use PhpOffice\PhpWord\PhpWord;
use PhpOffice\PhpWord\IOFactory;
$phpWord = new PhpWord();
$section = $phpWord->addSection();
// ✅ 正确：绝对路径 + 显式单位
$section->addImage('/var/www/images/chart.png', [
'width' => 12,
'height' => 8,
'unit' => \PhpOffice\PhpWord\Shared\Unit::CM,
]);
$objWriter = IOFactory::createWriter($phpWord, 'Word2007');
$objWriter->save('/tmp/report.docx');
- 路径不存在 → 报
File not found错误但不抛异常，文档生成空图位 - 图片格式仅支持
png、jpg、gif；webp 会静默失败
width/height 只写数字（如 12）默认是像素，小图会被拉伸糊掉
远程图片怎么插？不能直接传 URL
PHPWord 的 addImage() 不接受 URL，传 'https://xxx.com/a.jpg' 会当成本地路径去找，必然失败。
必须先下载到临时文件，再传绝对路径。注意：不要用 file_get_contents() 直接喂给 addImage()，它不接受二进制流。
- 用
file_put_contents()写临时文件，确保有写权限，且记得unlink()清理（或用sys_get_temp_dir()） - 加
stream_context_create()设超时和 UA，避免远程图站拒绝爬取 - 检查
getimagesize()返回值，防止下载到空响应或 HTML 错误页
示例片段：
$url = 'https://example.com/photo.jpg';
$tmpPath = sys_get_temp_dir() . '/img_' . uniqid() . '.jpg';
$options = ['http' => ['method' => 'GET', 'timeout' => 10, 'header' => "User-Agent: PHPWord\r\n"]];
file_put_contents($tmpPath, file_get_contents($url, false, stream_context_create($options)));
if (getimagesize($tmpPath)) {
$section->addImage($tmpPath, ['width' => 10, 'unit' => \PhpOffice\PhpWord\Shared\Unit::CM]);
}
unlink($tmpPath); // 别漏
导出后图片模糊 / 比例错乱？检查 DPI 和原始分辨率
Word 本身不存图片 DPI 信息，但 Windows 版 Word 会按 96 DPI 渲染像素图。一张 300×200 像素的图，设 width=10, unit=CM，实际渲染宽度 ≈ 10cm × 96 / 2.54 ≈ 378 像素 —— 若原图不够大，就会插值模糊。
- 设计阶段就提供 ≥ 2 倍目标尺寸的图（比如要显示 10cm 宽，原图横向至少 750 像素）
- 避免用
resize参数强制缩放 ——PHPWord不做图像处理，只是告诉 Word “按这个尺寸显示”，缩放由 Word 客户端完成 - 如果必须动态缩图，先用
GD或Imagick生成合适尺寸的临时文件，再插入
最常被忽略的一点：Word 打开 docx 后会自动压缩图片（尤其在“文件 → 选项 → 高级 → 图像大小和质量”里勾了“不压缩文件中的图像”之前）。这和 PHP 无关，是用户端行为，但客户抱怨“你们生成的图糊”，大概率是这个开关没关。
