PHPWord模板处理：块克隆场景下内嵌表格行克隆的实现问题

架构老林

2026-10-6

核心原理

调用cloneBlock生成多个重复块后，PHPWord会自动给每个块内的所有占位符加上#N后缀，N从1开始计数，对应第N个克隆出来的块。你只需要按块序号逐个处理每个块内的表格行克隆即可。

完整实现代码

// 1. 准备业务数据：分组信息 + 每个分组对应的人员行数据
$groupData = [
    [
        'group_name' => 'Group 1',
        'rows' => [
            ['name' => '张三', 'address' => '北京市朝阳区'],
            ['name' => '李四', 'address' => '上海市静安区'],
            ['name' => '王五', 'address' => '广州市天河区']
        ]
    ],
    [
        'group_name' => 'Group 2',
        'rows' => [
            ['name' => '赵六', 'address' => '深圳市南山区'],
            ['name' => '孙七', 'address' => '杭州市余杭区']
        ]
    ]
];

// 2. 初始化模板处理器
$templateProcessor = new \PhpOffice\PhpWord\TemplateProcessor('/path/to/template/Template.docx');

// 3. 构造块克隆替换数组，克隆所有分组块
$blockReplacements = array_map(function($item) {
    return ['group' => $item['group_name']];
}, $groupData);
$templateProcessor->cloneBlock('block_group', count($groupData), true, false, $blockReplacements);

// 4. 遍历每个分组，单独处理对应块内的表格行克隆
foreach ($groupData as $index => $groupItem) {
    // 块序号从1开始，所以要给数组索引+1
    $blockNum = $index + 1;
    // 克隆当前块内的表格行并填充数据，占位符需要加上对应块的序号后缀
    $templateProcessor->cloneRowAndSetValues("name#{$blockNum}", $groupItem['rows']);
}

// 5. 保存最终生成的报表
$templateProcessor->saveAs('/path/to/output/Report.docx');