php 8.6填充docx合同,可以用phpword的templateprocessor替换标量占位符,再用clonerowandsetvalues()复制明细行。模板由业务方预先维护,代码只填充允许字段;输出应保存为新文件,保留原始模板。

官方文档:Templates processing
准备受控模板
安装PHPWord并确认DOM、ZIP和XML等扩展可用。在Word模板中放置${customer}、${contractNo}两个文本占位符,再建立一行明细,分别放入${item}、${quantity}、${price}。这些明细占位符必须在同一表格行。
composer require phpoffice/phpword:"^1.4"

官方文档:General usage
替换字段并复制明细行
将模板保存为private/contract-template.docx,输出目录同样放在Web根目录外。启用输出转义,防止&和尖括号破坏DOCX内部XML;这不代表支持把任意HTML直接塞进标量字段。
<?php require __DIR__.'/vendor/autoload.php';
use PhpOffice\PhpWord\Settings;
use PhpOffice\PhpWord\TemplateProcessor;
Settings::setOutputEscapingEnabled(true);
$template = __DIR__.'/private/contract-template.docx';
if (!is_file($template) || !is_readable($template)) throw new RuntimeException('Missing template');
$processor = new TemplateProcessor($template);
$processor->setValues(['customer'=>'Example & Partners','contractNo'=>'CT-001']);
$lines = [
['item'=>'Keyboard','quantity'=>'2','price'=>'99.00'],
['item'=>'Mouse','quantity'=>'1','price'=>'49.00']
];
$processor->cloneRowAndSetValues('item', $lines);
$output = __DIR__.'/private/contract-'.bin2hex(random_bytes(6)).'.docx';
$processor->saveAs($output);
echo 'DOCX saved', PHP_EOL;
检查占位符和版面
用Word或兼容软件打开输出文件,确认客户名中的&能正常显示、合同号被替换、明细行数为两行,而且没有残留${...}。模板里的文字样式、分页和表格宽度仍由模板决定;内容明显变长时,要用实际数据检查换行和跨页。
限定模板与字段的来源
TemplateProcessor不是任意办公文档的安全审查器,不接受未授权用户上传的模板直接进入服务端处理。替换值应是经过业务校验的纯文本,金额和数量先完成校验与计算,不能把合同生成成功当成业务内容已经正确。
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!











