niklasravnsborg / mpdf
一个用于从HTML生成具有Unicode/UTF-8和CJK支持的PDF文件的PHP类
Requires
- php: >=5.3.2
- ext-mbstring: *
- setasign/fpdi: 1.6.*
Requires (Dev)
- phpunit/phpunit: ^4.7
Suggests
- ext-zlib: Needed for compression of embedded resources, such as fonts
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/ 上找到。
单元测试
使用 PHPUnit 进行 mPDF 的单元测试。
要从命令行开始,请在 mPDF 根目录中运行 composer install
(您首先需要安装 composer)。
要从命令行执行测试,请在 mPDF 根目录中运行 vendor/bin/phpunit
。
对于编写 mPDF 的单元测试,任何帮助都将受到高度重视。如果您想帮忙,请注意,任何位于 /tests/
目录中的 PHP 文件在单元测试时都会自动加载。