PHPWord 的 cloneBlock 不会自动处理 ${image:width:height} 占位符，需显式调用 setImageValue() 配合使用，才能将本地图片嵌入 Word 文档区块内。
phpword 的 `cloneblock` 不会自动处理 `${image:width:height}` 占位符，需显式调用 `setimagevalue()` 配合使用，才能将本地图片嵌入 word 文档区块内。
在使用 PHPWord 模板处理器（TemplateProcessor）进行动态内容填充时，许多开发者误以为只要在模板中声明 ${image:720:480} 并在 $replacements 数组中传入图片路径，图像就会自动插入——但事实并非如此。cloneBlock() 仅负责克隆和替换普通文本占位符（如 ${date}），而图像占位符属于特殊类型，必须通过 setImageValue() 单独注册。
✅ 正确做法如下：
use PhpOffice\PhpWord\TemplateProcessor;
$templateProcessor = new TemplateProcessor('template.docx');
$filepath = './uploads/image.png';
// ✅ 关键步骤：先为 image 占位符设置图像值（支持 PNG、JPG、GIF）
$templateProcessor->setImageValue('image', $filepath);
// ✅ 再执行 cloneBlock；注意：replacements 中的 'image' 键可保留（不参与渲染），但非必需
$replacements = [
['date' => '25-06-2022']
];
$templateProcessor->cloneBlock('evidence', 0, true, false, $replacements);
? 模板中 ${image:720:480} 的语法说明：
-
image是占位符名称（须与setImageValue()的第一个参数完全一致）； -
720:480表示目标显示尺寸（单位为磅，1 英寸 ≈ 72 磅），PHPWord 会按比例缩放图像并保持宽高比； - 若省略尺寸（如
${image}），则以原始尺寸嵌入（可能过大或变形）。
⚠️ 注意事项：
- 图像路径必须为服务器可读的绝对或相对路径（推荐使用
__DIR__ . '/uploads/image.png'避免路径歧义）； - PHPWord 0.18.3 不支持 URL 图片地址（如
https://...），仅支持本地文件； - 同一占位符名（如
'image'）在多次setImageValue()调用中会被覆盖，若需多图，请使用不同占位符名（如'image_1','image_2'）并分别设置； -
cloneBlock()的第四个参数false表示不删除空块，确保即使无数据时图像占位符仍存在（便于调试）。
最后，保存文档前请确认图像文件真实存在且有读取权限：
if (!file_exists($filepath) || !is_readable($filepath)) {
throw new RuntimeException("Image file not found or unreadable: {$filepath}");
}
$templateProcessor->saveAs('output.docx');
掌握 setImageValue() 与 cloneBlock() 的协同机制，是实现图文混排模板自动化的核心技巧。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
