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

如何使用 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 模板。

✅ 实施步骤（完整示例）

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

PHP 8.5.5
PHP 8.5.5 是 PHP 8.5 分支的维护更新版本。该版本延续了“小步快跑”的迭代逻辑，通过深度错误修复、底层性能微调以及安全加固，旨在为开发者提供一个更健壮、更高效的运行环境。该版本严格遵守语义化版本规范，不包含破坏性变更。

下载
```
composer require phpoffice/phpword
```

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

<?php require 'vendor/autoload.php';

use PhpOffice\PhpWord\IOFactory;

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 \PhpOffice\PhpWord\TemplateProcessor($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 模板基础上无缝继承原有信头样式。