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

本文详解如何绕过 php 直接输出 html 到 .doc 文件的兼容性陷阱，通过解析/生成标准 docx（.docx）格式，安全、可靠地将数据库数据注入预设样式的 word 模板。

本文详解如何绕过 php 直接输出 html 到 .doc 文件的兼容性陷阱，通过解析/生成标准 docx（.docx）格式，安全、可靠地将数据库数据注入预设样式的 word 模板。

直接使用 echo 向 .doc 文件（尤其是含复杂格式、嵌入字体或公司信头的 Word 模板）追加 HTML 内容是根本不可行的——因为传统 .doc 是二进制格式，而现代 .docx 是基于 OPC（Open Packaging Convention）的 ZIP 压缩包（含 XML 文档结构）。你当前代码中 readfile("test.doc") 输出的是原始二进制流，随后强行拼接 HTML 字符串，会导致文件结构彻底损坏，Word 无法识别，因此“不显示任何文本”。

✅ 正确方案：使用 PHPWord 库（推荐 v1.2+）操作 .docx 模板
PHPWord 是专为生成和修改 Office Open XML（OOXML）文档设计的成熟库，支持模板替换、样式保留、表格/图片/页眉页脚等高级功能，完美适配带信头的 Word 模板。

✅ 实施步骤（完整示例）

1. 准备模板：将你的 Word 模板另存为 .docx（非 .doc），并在需填充处插入占位符，例如：
   {{NAME}}、{{EMAIL}}（建议用双大括号，避免与 XML 冲突）

2. 安装 PHPWord（Composer 推荐）：

   composer require phpoffice/phpword

3. PHP 填充逻辑（安全、可扩展）：

   立即学习“PHP免费学习笔记（深入）”；

   <?phprequire 'vendor/autoload.php';use PhpOfficePhpWordIOFactory;if (isset($_POST['NT2a'])) {    // 1. 加载模板（确保路径正确，且为 .docx）    $templatePath = 'templates/company_letterhead.docx';    $phpWord = IOFactory::load($templatePath, 'Word2007');    // 2. 获取主文档部分并执行变量替换    $section = $phpWord->getSections()[0];    $textElements = $section->getElements();    // 更健壮的方式：使用 TemplateProcessor（推荐）    $template = new PhpOfficePhpWordTemplateProcessor($templatePath);    $template->setValue('NAME', htmlspecialchars($_POST['name'], ENT_XML1, 'UTF-8'));    $template->setValue('EMAIL', htmlspecialchars($_POST['email'], ENT_XML1, 'UTF-8'));    // 3. 设置响应头（关键：Content-Type 必须匹配 .docx）    ob_end_clean();    header('Content-Type: application/vnd.openxmlformats-officedocument.wordprocessingml.document');    header('Content-Disposition: attachment; filename="letter_' . date('Y-m-d_H-i-s') . '.docx"');    header('Cache-Control: max-age=0');    header('Pragma: public');    header('Expires: 0');    // 4. 输出生成的文档流    $template->saveAs('php://output');    exit;}?>

⚠️ 关键注意事项

• ❌ 绝不使用 .doc（旧二进制格式）：PHPWord 仅支持 .docx；若只有 .doc，请先用 Word 2007+ 另存为 .docx。
• ✅ 占位符命名规范：模板中必须严格使用 {{KEY}} 或 KEY（取决于 setValue() 调用方式），且不能含空格或特殊字符。
• ? 安全过滤：务必对用户输入（如 $_POST['name']）调用 htmlspecialchars(..., ENT_XML1)，防止 XML 注入或格式破坏。
• ? 路径与权限：确保模板文件路径可读，Web 服务器有读取权限；临时目录（如 php://output）无需写入权限。
• ? 复杂需求扩展：PHPWord 支持表格循环（cloneRow）、图片插入、页眉页脚、自定义字体——全部在 .docx 模板基础上无缝继承原有信头样式。

总结

放弃“HTML 拼接 .doc”的过时思路，转向基于 OOXML 标准的 PHPWord 方案，是实现专业级 Word 文档自动化生成的唯一稳健路径。它不仅解决模板兼容性问题，更保障样式、信头、布局零丢失，同时具备高安全性与可维护性。