zloadmin / mpdf
一个用于从HTML生成PDF文件的PHP类,支持Unicode/UTF-8和CJK字符集
Requires
- php: ^5.4.0 || 7.0.*
- ext-mbstring: *
- setasign/fpdi: 1.6.*
Requires (Dev)
- phpunit/phpunit: ^4.7
Suggests
- ext-zlib: Needed for compression of embedded resources, such as fonts
This package is auto-updated.
Last update: 2024-09-09 02:06:06 UTC
README
mPDF 是一个PHP类,可以从UTF-8编码的HTML生成PDF文件。它基于 FPDF 和 HTML2FPDF (见 CREDITS), 并增加了一些功能。mPDF 由 Ian Back 编写,并发布在 GNU GPL v2 许可下。
安装
首选的安装方法是使用 composer 和它的 Packagist 软件包 mpdf/mpdf。
手动安装
-
下载 .zip 发布文件 并解压
-
在您的服务器上创建一个文件夹,例如 /mpdf
-
将所有文件上传到服务器,保持文件夹结构不变
-
确保您已为以下文件夹设置写权限(CHMOD 6xx 或 7xx)
/ttfontdata/ - 用于缓存字体数据;显著提高性能
/tmp/ - 用于某些图像和ProgressBar
/graph_cache/ - 如果您在使用 JpGraph 时与 mPDF 一起使用
要测试安装,请将您的浏览器指向基本示例文件
[path_to_mpdf_folder]/mpdf/examples/example01_basic.php
如果您想为临时文件定义一个不同于 /tmp/ 的不同文件夹,请参阅 临时文件文件夹 的说明,该说明位于 手册 的安装 & 设置部分。
如果您遇到问题,请阅读手册中 故障排除 部分的说明。
在线手册
在线手册可在 https://mpdf.github.io/ 获得。
单元测试
mPDF 的单元测试使用 PHPUnit 完成。
要从命令行开始,请在 mPDF 根目录下运行 composer install
(您需要首先安装 composer)。
要执行测试,请在 mPDF 根目录下从命令行运行 vendor/bin/phpunit
。
任何帮助为 mPDF 编写单元测试的人都将受到高度赞赏。如果您想帮忙,请注意,任何位于 /tests/
目录下的 PHP 文件在单元测试时都将自动加载。