MDword 1.1.9发布:PHP生成Word工具修复已知Bug

作者:技术拾光时间:2026-08-03 07:48:26浏览:415

MDword1.1.9版本发布,新增图片宽度百分比设定及小语种字体自动匹配功能。该工具基于母版替换机制动态生成Word文档,相比逐元素写入的PHPWord,开发效率更高。性能测试显示,1页母版执行100次变量赋值仅需0.04秒,连续运行内存占用稳定在约0.05MB。

新增特性与已修复问题

  • 图片宽度现已支持使用百分比进行设置
  • 系统可自动为小语种文字匹配兼容字体

项目概述

核心用途明确:动态生成Word文档。
主要优势在于,开发者只需关注动态数据与业务逻辑,文档样式则交由Word母版统一配置,无需手动调整。

MDword与PHPWord对比分析

共同点

  1. 两者均为基于PHP开发的开源库(Composer包)
  2. 均可生成标准Office Word文档(.docx格式)

差异点

  1. PHPWord采用逐元素写入方式;MDword基于母版文档进行内容替换与结构扩展,功能更全面,开发效率更高
  2. 文字格式调整、封面插入、页眉页脚修改等操作,MDword只需在Word中编辑一次母版即可复用;PHPWord则为每个元素单独编码设置,流程繁琐
  3. MDword支持自动生成文档目录(TOC),开箱即用

使用指南

安装方式

// 方式一:通过Composer安装
composer require mkdreams/mdword

// 方式二:手动引入自动加载类
require_once('Autoloader.php');

在母版文件“temple.docx”中添加批注示例

MDword 1.1.9发布:PHP生成Word工具修复已知Bug

基础调用示例(更多高级用法请参考测试案例,如目录生成、序号自动编号等)

// 实例化处理器并加载母版
$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);

输出效果预览

MDword 1.1.9发布:PHP生成Word工具修复已知Bug

动态操作演示(GIF)

MDword 1.1.9发布:PHP生成Word工具修复已知Bug

性能测试数据(基准脚本统计)

测试场景耗时(秒)
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

内存占用测试(连续运行统计)

连续运行次数累计内存占用说明
10.050590515136719 M首次运行需加载全部类文件
20.050949096679688 M
30.050949096679688 M
40.050949096679688 M
50.050949096679688 M
60.050949096679688 M
70.050949096679688 M
80.050949096679688 M

更多实用案例

  • 基础综合应用示例
  • 带富文本样式的段落处理
  • 图片嵌入与尺寸控制
  • 区块批量克隆与差异化填充
  • 多种区块标记方式(有效规避批注无法识别问题)
  • 兼容PHPWord的区块内容写入方案
  • 目录(TOC)嵌入表格单元格
  • 表格合并单元格操作