MDword1.1.9版本发布,新增图片宽度百分比设定及小语种字体自动匹配功能。该工具基于母版替换机制动态生成Word文档,相比逐元素写入的PHPWord,开发效率更高。性能测试显示,1页母版执行100次变量赋值仅需0.04秒,连续运行内存占用稳定在约0.05MB。
MDword 1.1.9发布:PHP生成Word工具修复已知Bug
作者:技术拾光
时间:2026-08-03
浏览:414
文章目录
新增特性与已修复问题
- 图片宽度现已支持使用百分比进行设置
- 系统可自动为小语种文字匹配兼容字体
项目概述
核心用途明确:动态生成Word文档。
主要优势在于,开发者只需关注动态数据与业务逻辑,文档样式则交由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”中添加批注示例

基础调用示例(更多高级用法请参考测试案例,如目录生成、序号自动编号等)
// 实例化处理器并加载母版
$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->sa veAs($rtemplate);
输出效果预览

动态操作演示(GIF)

性能测试数据(基准脚本统计)
| 测试场景 | 耗时(秒) |
|---|---|
| 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)嵌入表格单元格
- 表格合并单元格操作
实用工具推荐
电子包浆
使用 ›绿化、压缩、噪点和虚拟水印,自由调节做旧程度。
图片压缩
使用 ›选择画质和输出格式,预览压缩前后的大小。