前言
项目近期有个业务需求:下载 PDF 版发票。和公司前辈沟通,有两种方案
- 先做成图片,把动态数据用画布坐标的形式填充进去,把图片放进 PDF 文件中,再下载(比较繁琐)
- 先用 html 画页面,再转成 PDF 文件,再下载(觉得用这种方式)
一、安装依赖
wkhtmltopdf 依赖安装(https://wkhtmltopdf.org/downloads.html)可以直接在官网下载安装包,像服务器通过通过以下方式(找好对应的版本下载呦,我用的是 ubantu 16)
wget https://downloads.wkhtmltopdf.org/0.12/0.12.5/wkhtmltox_0.12.5-1.xenial_amd64.deb
apt-get install -f
dpkg -i wkhtmltox_0.12.5-1.xenial_amd64.deb
如果出现以下错误,就重复下上面第二行命令和第三行命令
dpkg: error processing package wkhtmltox (--install):
dependency problems - leaving unconfigured
Errors were encountered while processing:
wkhtmltox
二、代码演示
$outPut = view('invoice', ['orderData' => $orderData])->render(); //invoice.blade.php 是 html 模板,往里填充动态数据
// 将填充完整的 html 文件存储起来,稍后用来转 PDF
$htmlName = $this->getHtmlName();// 获取 html 文件名
$htmlDir = $this->getHtmlDir();// 获取 html 工作目录
$htmlFullPath = storage_path($htmlDir . $htmlName);
file_put_contents($htmlFullPath, $outPut);
// 设置 pdf 文件路径
$pdfName = $this->getPdfName($orderData['order_no']);// 获取 pdf 文件名
$pdfDir = $this->getPDFDir();// 获取 pdf 工作目录
$pdfFullPath = storage_path($pdfDir . $pdfName);
// 设置 PDF 文件的属性
$pdf = new Pdf($htmlFullPath);
$pdf->setOptions([
'no-outline',
//'zoom' => 3,
'margin-top' => 0,
'margin-right' => 0,
'margin-bottom' => 0,
'margin-left' => 0,
//'disable-smart-shrinking',
]);
// 保存 PDF
if (!$pdf->saveAs($pdfFullPath)) {\Log::error('Could not create PDF:', [$pdf->getError()]);
return false;
}
因为我们项目使用了多台服务器,所以我们就把 PDF 文件先上传到 oss 再进行下载的,如果不需要可以直接用 Header 方式下载
header('Content-Type: application/octet-stream');
header('Content-Disposition: attachment; filename=' . $pdfName);
readfile($pdfFullPath);
三、可能遇到的问题
- 如果出现 PDF 文件下载下来,中文乱码的情况,那是因为缺少一个字体文件,下载这个字体 simsun.ttc,把它添加到
/usr/share/fonts
目录。