laravel中使用的PDF扩展包——laravel-dompdf和laravel-snappy
这两天项目中需要将HTML页面转换为PDF文件方便打印,我在网上搜了很多资料。先后尝试了laravel-dompdf和laravel-snappy两种扩展包,个人感觉laravel-snappy比较好用。
一、使用laravel-dompdf扩展包
1、安装扩展包
我们通过composer来安装
composer require barryvdh/laravel-dompdf
2、将ServiceProvider添加到config / app.php中的providers数组中
Barryvdh\DomPDF\ServiceProvider::class,
3、添加facade到config / app.php中的aliases数组中
'PDF' => Barryvdh\DomPDF\Facade::class,
4、使用
可以创建一个dompdf实例并加载HTML字符串、文件或者视图,然后使用stream()方法显示在浏览器中、save()方法保存到文件或者download()方法下载。
$pdf = App::make('dompdf.wrapper'); $pdf->loadHTML('<h1>Test</h1>'); return $pdf->stream();
也可以使用门面(facade),使用前先use PDF;
$pdf = PDF::loadView('pdf.invoice', $data); return $pdf->download('invoice.pdf');
也可以链式操作
return PDF::loadFile(public_path().'/myfile.html')->save('/path-to/my_stored_file.pdf')->stream('download.pdf');
可以更改方向(landscape将方向设为横向,一般使用的都是竖向的,使用时注意一下)和纸张大小,并隐藏或显示错误(默认情况下,调试打开时显示错误)
PDF::loadHTML($html)->setPaper('a4', 'landscape')->setWarnings(false)->save('myfile.pdf')
其他的一些基本使用和配置请参考文档资料https://github.com/barryvdh/laravel-dompdf
5、解决中文乱码问题
下载一个支持unicode编码的中文字体。例如:msyh.ttf(微软雅黑)
建议先在storage下创建fonts文件夹,把字体放在fonts文件夹下,不然会报错。
在css中引入字体
<style> @font-face { font-family: 'msyh'; font-style: normal; font-weight: normal; src: url({{ storage_path('your_path/msyh.ttf') }}) format('truetype'); } body { font-family: msyh, DejaVu Sans,sans-serif; } </style>
注意:亲测只有unicode编码的中文,才能正常显示,这也是我觉得这个PDF扩展不太好用的原因。
二、使用laravel-snappy扩展包
1、安装依赖软件
laravel-snappy扩展包需要Wkhtmltopdff的支持,所以先安装Wkhtmltopdf
方法一:下载wkhtmltopdf安装包
wkhtmltopdf下载地址http://www.softpedia.com/get/Office-tools/PDF/wkhtmltopdf.shtml
windows直接下载安装就可以了,注意安装到你知道的地方,这个路径后面有用。
我的安装在G:wk目录下
在bin目录下有wkhtmltoimage与wkhtmltopdf两个依赖软件
linux下载解压完成后,要将文件移动到 /usr/local/bin 下
方法二:通过 composer 来安装
以linux系统为例
32位: $ composer require h4cc / wkhtmltopdf-i386 0.12.x $ composer require h4cc / wkhtmltoimage-i386 0.12.x, 64位: $ composer require h4cc/wkhtmltopdf-amd64 0.12.x $ composer require h4cc/wkhtmltoimage-amd64 0.12.x (uname -a 命令查看系统位数) cp vendor/h4cc/wkhtmltoimage-amd64/bin/wkhtmltoimage-amd64 /usr/local/bin/ cp vendor/h4cc/wkhtmltopdf-amd64/bin/wkhtmltopdf-amd64 /usr/local/bin/ 并使其可执行: chmod +x /usr/local/bin/wkhtmltoimage-amd64 chmod +x /usr/local/bin/wkhtmltopdf-amd64
Linux 下使用该第三方插件需要几个库的支持
apt-get install libXrender* apt-get install libfontconfig*
2、安装laravel-snappy扩展包
composer require barryvdh/laravel-snappy
3、将ServiceProvider添加到config / app.php中的providers数组
Barryvdh\Snappy\ServiceProvider::class,
3、添加facade到config / app.php中的aliases数组中
'PDF' => Barryvdh\Snappy\Facades\SnappyPdf::class, 'SnappyImage' => Barryvdh\Snappy\Facades\SnappyImage::class,
4、生成配置文件
php artisan vendor:publish --provider="Barryvdh\Snappy\ServiceProvider"
此命令会在config/snappy.php生成配置文件
具体配置如下:
<?php return array( 'pdf' => array( 'enabled' => true, // 'binary' => '/usr/local/bin/wkhtmltopdf', //依赖软件的路径,linux默认在此目录下 'binary' => 'G:\wk\wkhtmltopdf\bin\wkhtmltopdf', 'timeout' => false, 'options' => array(), 'env' => array(), ), 'image' => array( 'enabled' => true, // 'binary' => '/usr/local/bin/wkhtmltoimage', 'binary' => 'G:\wk\wkhtmltopdf\bin\wkhtmltoimage', 'timeout' => false, 'options' => array(), 'env' => array(), ), );
5、使用 ( 与使用dompdf类似 )
先引入
use PDF;
use SnappyImage;
生成PDF文件
可以使用门面(facade)加载HTML字符串、文件或者视图,然后使用stream()方法显示在浏览器中、save()方法保存到文件或者download()方法下载。
$pdf = PDF::loadView('pdf.invoice', $data); return $pdf->download('invoice.pdf');
也可以链式操作
return PDF::loadFile(public_path().'/myfile.html')->save('/path-to/my_stored_file.pdf')->stream('download.pdf');
可以更改方向(landscape将方向设为横向,一般使用的都是竖向的,使用时注意一下)和纸张大小,并隐藏或显示错误(默认情况下,调试打开时显示错误)
PDF::loadHTML($html)->setPaper('a4', 'landscape')->setWarnings(false)->save('myfile.pdf')
生成图片
$pdf = SnappyImage::loadView('pdf.invoice', $data); return $pdf->download('invoice.image');
6、解决中英文乱码问题 (linux)
可以将例如:宋体或其他中文字体添加到 /usr/share/fonts/ 里
非常开心能够将我的学习心得分享给大家 (๑><๑)