mPDF的简单使用

Posted 2022-10-14 haizizhu

tags:

篇首语：本文由小常识网(cha138.com)小编为大家整理，主要介绍了mPDF的简单使用相关的知识，希望对你有一定的参考价值。

1. 基本使用

安装

1 在Yii项目在项目下composer文件中添加 "mpdf/mpdf":"~7.1.9"

"require": 
    这里是其它扩展
    "mpdf/mpdf":"~7.1.9"
,

然后在bash命令行执行

composer update mpdf/mpdf

安装完毕之后打开mpdf文件夹下这些目录的写权限

src/
tmp/
ttfonts/

在controller中使用

use Mpdf\Mpdf;

//yii中获取 html 的方法 PDFHtml为需要转换的html文件 $data为动态展示的数据
$html = $this->renderPartial(‘PDFHtml‘, $data);

$mpdf = new Mpdf();
//设置中文字体
$mpdf->autoScriptToLang = true; 
$mpdf->autoLangToFont = true; 
$mpdf->WriteHTML($html);

//直接展示 
$mpdf -> Output();
//保存文件
$mpdf -> Output($path.$name.‘.pdf‘);

2.基本定制化使用

安装

官方手册中安装方法为composer安装 Packagist php扩展包库地址 https://packagist.org/packages/mpdf/mpdf
截止到2019年5月 mpdf版本更新到8.0.1>，主要大版本为6~. 7~. 8~
6~版本 php版本要求为5.4-7.0，版本不符会报错，不需要php扩展依赖
7~版本 php版本要求为5.6- 7.2，需要php扩展支持 gd库与mbstring库
8~版本 php版本要求为5.6-7.3，需要php扩展支持 gd库与mbstring库，php版本高可以试下。目前官方文档支持到7.1.

更改目录权限

7~版本需要打开mpdf文件夹下

src/
tmp/
ttfonts/

的目录写权限。

6~版本打开

ttfontdata/
tmp/
graph_cache/

写权限。

使用

引用方法大版本有明显差异

//6~版本
use mpdf;
$mpdf=new mPDF();

//7~版本
use Mpdf\Mpdf;
$mpdf=new mPDF();
$mpdf = new Mpdf();

属性设置及方法参数

1.输出方法 Output()

$mpdf = new \Mpdf\Mpdf();
$mpdf->WriteHTML(‘Hello World‘);
$name = $path . $fileName . ".pdf";

1 直接展示在浏览器页面
$mpdf->Output();  

2 以文件形式保存到服务器
$mpdf->Output( $name );

3 带第二个参数
$mpdf->Output( $name , "F"); //服务器保存以$name为名称的文件
$mpdf->Output( $name , "D"); //浏览器下载以$name为名称的文件
$mpdf->Output( $name , "S"); //以字符串形式返回 $name忽略
$mpdf->Output( $name , "I"); //浏览器展示,但当用户另存为时以$name为默认文件名

2.写入方法 WriteHTML()

$mpdf->WriteHTML( $html , 0 );  //默认 以html为标准分析写入内容
$mpdf->WriteHTML( $css , 1 );   //会以style样式录入写入内容 等同于<style></style>标签中的内容
$mpdf->WriteHTML( $body , 2 );  //会以html body体形式录入写入内容 等同于<body></body>标签内的内容
$mpdf->WriteHTML( $thml , 0 );  //默认 以html为标准

自动分析录入内容字体

$mpdf->autoScriptToLang = true;
$mpdf->autoLangToFont = true;

4.加水印

$mpdf->SetWatermarkImage(‘../web/static/img/water-min.png‘,1);//参数一是图片的位置(图片相对目录 为处理脚本的相对目录)，参数二是透明度0.1-1
$mpdf->showWatermarkImage = true;

5.设置页眉页脚

//设置PDF页眉内容
$header=‘<table width="95%" style="margin:0 auto;border-bottom: 1px solid #4F81BD; vertical-align: middle; font-family:serif; font-size: 9pt; color: #000088;"><tr>
<td width="10%"></td><td width="80%" align="center" style="font-size:16px;color:#A0A0A0">页眉</td>
<td width="10%" style="text-align: right;"></td></tr></table>‘;
 
//设置PDF页脚内容
在页脚html中添加 PAGENO/nb (当前页/总页数) 可添加页码
$footer=‘<table width="100%" style=" vertical-align: bottom; font-family:serif; font-size: 9pt; color: #000088;"><tr style="height:30px"></tr><tr>
<td width="10%"></td><td width="80%" align="center" style="font-size:14px;color:#A0A0A0">页脚</td>
<td width="10%" style="text-align: left;">页码：PAGENO/nb</td></tr></table>‘;

$mpdf->SetHTMLHeader($header);
$mpdf->SetHTMLFooter($footer);

6.合并多张PDF

$mpdf = new Mpdf();
$mpdf->SetImportUse();
$pagecount = $mpdf->SetSourceFile(‘单页PDF地址‘);
$tplId = $mpdf->ImportPage(1);
$mpdf->UseTemplate($tplId);
$mpdf->WriteHTML(‘‘);
$pagecount = $mpdf->SetSourceFile(‘多页PDF地址‘);
for ($i=1;$i<=$pagecount;$i++) 
    $mpdf->AddPage();
    $tplId = $mpdf->ImportPage($i);
    $mpdf->UseTemplate($tplId);
    $mpdf->WriteHTML(‘‘);

$mpdf->Output($outPut);

7.关于字体设置

决定客户端字体显示的因素有两个
1.一个是pdf本身设置的字体
2.客户端电脑的系统内置字体（mac系统 win系统 unix系统字体 部分字体通用 部分差异）
 
不过一般服务器为unix系统，所以在设置字体时需要考虑服务器本身支持哪些字体

查看所有的字体
fc-list
查看所有的中文字体
fc-list :lang=zh 
 
在html中直接设置想要呈现的字体,如果没有则需要自行下载字体,放置于服务器字体目录中

8.关于中文符号在数字后面乱码的问题

个别字体会出现数字后面的中文字符出现乱码情况,目前没有很好的解决方式,只列举一个简单方式:使用gb字体显示中文字符

例如要显示:【213456789】

<span style:"font-family:自定义字体;">【123456798<span style="font-family: gb;">】</span></span>

更多方法参照官方文档
http://mpdf.github.io/reference/mpdf-functions/overview.html

以上是关于mPDF的简单使用的主要内容，如果未能解决你的问题，请参考以下文章

使用 MPDF 将 HTML 保存为 PDF 和电子邮件

mPDF 库和浮动图像

mpdf 图像错误，找不到图像文件

在 mPDF 中调整 css 大小

mPDF 图像以裁剪且无失真的方式覆盖页面

使用 mPDF 错误在 codeigniter 3 中将 html 导出并下载为 pdf 错误：找不到类“Mpdf\Mpdf”