PhpWord使用setComplexBlock/setComplexValue后占位符丢失，仅首个元素生效求助

你的问题核心在于PhpWord的TemplateProcessor对同名占位符的处理逻辑，以及你原流程中存在的两个关键错误：

原方案的问题点 #

1. 同名占位符的解析限制：setComplexBlock默认只会匹配并替换第一个同名占位符，替换后剩余的同名占位符会因DOM结构被修改而无法被后续循环定位到，最终被移除。
2. 二次加载文档的额外风险：先通过PhpWord生成带占位符的文件再重新加载，可能导致占位符格式不符合TemplateProcessor的解析要求（比如未正确包裹${}），进一步加剧定位失败的问题。

正确实现方式 #

方式一：使用带唯一标识的占位符 #

直接在模板中定义带索引的占位符（如${content_0}、${content_1}），循环时动态指定占位符名称进行替换：

// 假设$htmlContents是你的WYSIWYG输出HTML数组
$templateProcessor = new \PhpOffice\PhpWord\TemplateProcessor('your-template.docx');

foreach ($htmlContents as $index => $html) {
    // 将HTML转换为PhpWord Section元素
    $tempPhpWord = new \PhpOffice\PhpWord\PhpWord();
    $section = $tempPhpWord->addSection();
    \PhpOffice\PhpWord\Shared\Html::addHtml($section, $html);

    // 替换对应索引的唯一占位符
    $templateProcessor->setComplexBlock('content_' . $index, $section);
}

$templateProcessor->saveAs('final-output.docx');

方式二：使用重复区块（推荐） #

利用PhpWord的重复区块特性，先在模板中定义区块结构，再克隆并批量替换：

1. 模板中定义重复区块：

{html_blocks}
${content}
{/html_blocks}

2. 代码实现：

$templateProcessor = new \PhpOffice\PhpWord\TemplateProcessor('your-template.docx');
$htmlContents = [/* 你的HTML内容数组 */];

// 克隆区块，数量与HTML内容一致
$templateProcessor->cloneBlock('html_blocks', count($htmlContents), true, true);

foreach ($htmlContents as $index => $html) {
    $tempPhpWord = new \PhpOffice\PhpWord\PhpWord();
    $section = $tempPhpWord->addSection();
    \PhpOffice\PhpWord\Shared\Html::addHtml($section, $html);

    // 替换对应索引区块内的占位符（#N为克隆后的区块索引）
    $templateProcessor->setComplexBlock('content#' . ($index + 1), $section);
}

$templateProcessor->saveAs('final-output.docx');

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