部分新增特性 & 已修复问题
- 图片宽度现支持以百分比形式设定
- 针对部分小语种文字，已实现自动匹配兼容字体功能
项目概述
核心用途：动态生成 Word 文档
核心优势：开发者仅需聚焦于动态数据与业务逻辑，无需手动调整文档样式（样式可通过 Microsoft Word 编辑母版统一配置）
MDword 与 PHPWord 的对比分析
相同之处
- 均为基于 PHP 开发的开源库（Composer 包）
- 均可用于生成标准 Office Word 文档（.docx 格式）
差异点
- PHPWord 采用逐元素写入方式；而 MDword 则基于母版文档进行内容替换与结构扩展，功能更全面，开发效率更高
- 对于文字格式调整、封面插入、页眉页脚修改等操作，MDword 只需在 Word 中编辑一次母版即可复用；PHPWord 则需对每个元素单独编码设置，流程繁琐
- MDword 支持自动生成文档目录（TOC），开箱即用
使用指南
安装方式
// 方式一：通过 composer 安装composer require mkdreams/mdword
// 方式二：手动引入自动加载类require_once('Autoloader.php');
在母版文件 “temple.docx” 中添加批注示例
基础调用示例（更多高级用法请参考测试案例：tests\samples\simple for readme，如目录生成、序号自动编号等）
// 实例化处理器并加载母版
$TemplateProcessor = new WordProcessor();
$template = 'temple.docx';
$TemplateProcessor->load($template);
// 设置普通变量值
$TemplateProcessor->setValue('value', 'r-value');
// 克隆指定区块（如“people”）3 次
$TemplateProcessor->clones('people', 3);
// 分别为克隆后的子项赋值
$TemplateProcessor->setValue('name#0', 'colin0');
$TemplateProcessor->setValue('name#1', [
['text'=>'colin1','style'=>'style','type'=>MDWORD_TEXT],
['text'=>1,'type'=>MDWORD_BREAK],
['text'=>'86','style'=>'style','type'=>MDWORD_TEXT]
]);
$TemplateProcessor->setValue('name#2', 'colin2');
$TemplateProcessor->setValue('sex#1', 'woman');
$TemplateProcessor->setValue('age#0', '280');
$TemplateProcessor->setValue('age#1', '281');
$TemplateProcessor->setValue('age#2', '282');
// 插入图片
$TemplateProcessor->setImageValue('image', dirname(__FILE__).'/logo.jpg');
// 删除含特定样式的段落
$TemplateProcessor->deleteP('style');
// 保存结果文档
$rtemplate = __DIR__.'/r-temple.docx';
$TemplateProcessor->saveAs($rtemplate);输出效果预览
动态操作演示（GIF）
立即学习“PHP免费学习笔记（深入）”；
性能测试数据（基准脚本统计）
| 测试场景 | 耗时 (秒) |
|---|---|
| 1 页母版执行 100 次变量赋值 | 0.04 |
| 1 页母版执行 500 次变量赋值 | 0.16 |
| 1 页母版执行 1000 次变量赋值 | 0.33 |
| 1 页母版执行 10000 次变量赋值 | 7.80 |
| 1750 页母版执行 100 次变量赋值 | 4.61 |
| 1750 页母版执行 500 次变量赋值 | 4.94 |
| 1750 页母版执行 1000 次变量赋值 | 5.43 |
| 1750 页母版执行 10000 次变量赋值 | 17.39 |
内存占用测试（连续运行统计）
| 连续运行次数 | 累计内存占用 | 说明 |
|---|---|---|
| 1 | 0.050590515136719 M | 首次运行需加载全部类文件 |
| 2 | 0.050949096679688 M | |
| 3 | 0.050949096679688 M | |
| 4 | 0.050949096679688 M | |
| 5 | 0.050949096679688 M | |
| 6 | 0.050949096679688 M | |
| 7 | 0.050949096679688 M | |
| 8 | 0.050949096679688 M |
更多实用案例
- 基础综合应用示例
- 带富文本样式的段落处理
- 图片嵌入与尺寸控制
- 区块批量克隆与差异化填充
- 多种区块标记方式（有效规避批注无法识别问题）
- 兼容 PHPWord 的区块内容写入方案
- 目录（TOC）嵌入表格单元格
- 表格合并单元格操作
源码仓库地址：点击下载
