PHP无法原生导出Word文档，必须依赖第三方库；直接用fopen或file_put_contents拼接XML会因ZIP结构、命名空间、字体、内存缓存等导致文件损坏、乱码或崩溃，应使用PhpOffice/PhpWord并注意版本、扩展、字体和缓存配置。
PHP 无法原生导出 Word 文档，必须依赖第三方库；直接用 fopen 写 .docx 文件会损坏格式，别试。
为什么不能用 file_put_contents 拼接 XML 导出 .docx
Word 的 .docx 是 ZIP 压缩包，内部含 [Content_Types].xml、word/document.xml 等严格结构的文件。手动拼 XML 容易漏命名空间、错编码、缺关系定义，导致：
• 打开提示“文件已损坏”
• 内容显示为空白或乱码
• 某些 Word 版本（如 macOS Pages）直接拒绝打开
实操建议：
• 别自己造轮子，用成熟库处理 ZIP 封装和 OPC（Open Packaging Conventions）规范
• 即使只是简单文本，也要走完整模板渲染流程
PHPWord 是当前最稳的选项，但要注意版本陷阱
最新版 phpoffice/phpword（v1.2+）已弃用 PHPWord 类名，改用命名空间 PhpOffice\PhpWord\。常见错误：
• 用旧教程的 new PHPWord() 报 Class 'PHPWord' not found
• 未启用 zip 和 xml 扩展，导出时静默失败
实操建议：
• 用 Composer 安装：composer require phpoffice/phpword
• 确保 PHP 启用了 extension=zip 和 extension=dom（XML 解析必需）
• 导出前加判断：if (!class_exists('ZipArchive')) { throw new Exception('zip extension required'); }
导出中文内容必须设字体，否则显示方块或空白
默认西文字体（如 Calibri）不支持中文，addText() 直接写汉字会丢字或渲染失败。这不是编码问题（UTF-8 已是默认），而是字体缺失。
实操建议：
• 显式设置中文字体：$section->addText('你好世界', ['name' => 'SimSun', 'size' => 14])
• 推荐备选字体： 'Noto Sans CJK SC'（跨平台兼容）、'Microsoft YaHei'（Windows）、'PingFang SC'（macOS）
• 避免用 'font' => 'simhei' 这类小写写法，部分系统不识别
生成大文档时内存溢出，得关掉样式缓存
PHPWord 默认缓存所有样式对象，100 页文档可能吃掉 200MB+ 内存，触发 Fatal error: Allowed memory size exhausted。
实操建议：
• 创建对象时禁用样式缓存：$phpWord = new \PhpOffice\PhpWord\PhpWord(['settings' => ['useDiskCache' => false]])
• 对长列表，避免在循环里反复调用 $section->addText()，改用 addTextRun() + addText() 批量追加
• 导出前调用 ob_end_clean() 清理输出缓冲，防止 header 冲突
真正麻烦的不是写几行字，而是 Word 对样式继承、段落分页、表格嵌套这些细节的隐式规则——PHPWord 只实现了常用子集，遇到复杂页眉页脚或公式，就得切回 LibreOffice headless 转换。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
