PHP动态填充公司信头Word模板

如何使用 PHP 将 MySQL 数据动态填充到带公司信头的 Word 模板中

本文详解如何正确将 MySQL 数据通过 PHP 注入预设格式的 Word 文档（含信头），避免直接 echo HTML 内容导致模板失效的问题，并提供安全、可维护的 docx 模板替换方案。

直接通过 PHP 向 .doc 或 .docx 文件输出 HTML 片段并不可行。Word 文档，特别是 .docx，并非纯文本，而是基于 OpenXML 的 ZIP 压缩包，其中包含 document.xml、样式、字体、页眉页脚等多个独立部件。若使用 readfile("test.doc") 输出二进制流，再附加 HTML 标签，文件结构将被破坏，Word 无法解析，导致“内容不显示”。

推荐的实现方法是模板占位符 + XML 解析替换，而非 HTML 拼接。使用 PHPWord（github.com/PHPOffice/PHPWord）这类成熟库，专门用于生成和操作 .docx，能够完整保留公司信头、页眉、Logo、字体及段落样式。

以下是完整实现步骤：

1. 准备模板

在 Microsoft Word 中创建 template.docx，在需要填充数据的位置插入清晰的占位符，例如：

[NAME]  [EMAIL]  [DATE]

2. 安装 PHPWord（推荐 Composer）

composer require phpoffice/phpword

3. PHP 填充逻辑示例

getSections()[0];

    // 替换占位符（支持段落内、表格内、页眉等）
    $properties = [
        'NAME'  => $_POST['name'] ?? 'N/A',
        'EMAIL' => $_POST['email'] ?? 'N/A',
        'DATE'  => date('Y年m月d日')
    ];

    // 执行全局替换
    PhpOffice\PhpWord\Settings::setOutputEscapingEnabled(true);
    $phpWord->getVariablesProcessor()->setVariable('NAME', $properties['NAME']);
    $phpWord->getVariablesProcessor()->setVariable('EMAIL', $properties['EMAIL']);
    $phpWord->getVariablesProcessor()->setVariable('DATE', $properties['DATE']);

    // 输出响应头
    header('Content-Type: application/vnd.openxmlformats-officedocument.wordprocessingml.document');
    header('Content-Disposition: attachment;filename="letter_' . date('Ymd_His') . '.docx"');
    header('Cache-Control: max-age=0');

    // 输出生成的文档
    $objWriter = IOFactory::createWriter($phpWord, 'Word2007');
    $objWriter->save('php://output');
    exit;
}
?>

关键注意事项

• 绝对不要对 .docx 使用 readfile() + echo HTML，这会导致二进制与文本混合污染，文件必然损坏。
• 占位符建议全大写加方括号（如 [NAME]），避免与正文内容冲突。
• 若模板包含复杂的页眉、页脚、水印，可通过 PHPWord 的 $section->addHeader() 等方法精准控制。
• 生产环境中务必对 $_POST 数据进行过滤（如 htmlspecialchars() 或白名单验证），防范 XSS 或注入风险。
• 如需兼容旧版 .doc（非 .docx），建议先转换为 .docx 模板再处理。原生 .doc（OLE 格式）在 PHP 下支持极弱，不推荐直接操作。

总结：动态生成专业的 Word 文档，关键在于遵循其结构规范。放弃“HTML 思维”，转向 OpenXML 意识，借助 PHPWord 等工具，即可在保留企业信头、品牌样式的同时，高效稳定地完成数据库驱动的文档自动化工作。