一个PHP类,用于从HTML生成支持Unicode/UTF-8和CJK的PDF文件

v7.0.0-beta2 2017-03-12 18:05 UTC

README

mPDF是一个PHP类,它可以从UTF-8编码的HTML生成PDF文件。它基于FPDFHTML2FPDF(参见CREDITS),并进行了一些增强。mPDF是由Ian Back编写的,并在GNU GPL v2许可下发布。

Build Status

安装

首选的安装方法是使用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文件在单元测试时都将被自动加载。