前言
之前的项目中,涉及一个生成 PDF
的需求,当时使用的框架是 Lumen
。
调研
原本是想用官方网站上可以看到的 PDF
扩展的,发现使用之后有水印,直接放弃。(传送门 好像已经不能打开了)
之后考虑了一下,如果能像浏览器一样,将网页直接转换为 PDF
,那该多好,省时省力。
搜索了一下,发现还蛮多。
但适合这个项目的都需要自己再封装一下,为了方便,检索了一下基于 Laravel
的包。
最终选定了 niklasravnsborg/laravel-pdf
传送门,这个项目是基于 mpdf
的封装。
在使用的时候,遇到了两个问题。
- 不兼容
Lumen
- 中文乱码
问题解决
不兼容 Lumen
看了下源码,是配置获取的时候,Laravel
和 Lumen
的方式有所差异。
于是 Fork
了项目,并重写了 src/LaravelPdf/PdfServiceProvider.php@boot
和 src/LaravelPdf/PdfServiceProvider.php@register
。
TIPS:有一些细节就不细说了,可以直接拿到项目里使用。imjcw/laravel-pdf
public function boot()
{
// 原代码
// $this->publishes([$this->configPath() => config_path('pdf.php')]);
// 新代码
if ($this->app instanceof \Laravel\Lumen\Application) {
$this->app->configure(self::CONFIG_KEY);
} else {
$this->publishes([$this->configPath() => config_path('pdf.php')]);
}
}
public function register()
{
// 原代码
// $this->mergeConfigFrom(
// __DIR__ . '/../config/pdf.php', 'pdf'
// );
// $this->app->bind('mpdf.wrapper', function($app) {
// return new PdfWrapper();
// });
// 新代码
$this->mergeConfigFrom($this->configPath(), 'pdf');
$this->app->bind('mpdf.wrapper', function($app) {
return new PdfWrapper(config(self::CONFIG_KEY));
});
}
随后发布了 packagist
,就在项目中引用了。
中文乱码
时间有点久,具体细节忘了,主要配置如下:
TIPS:这里的 stsong.ttf
是从网上下载来使用的。为了省事,所有的字体都是一个😂。
<?php
return [
'mode' => '+aCJK',
'format' => 'A4', // See https://mpdf.github.io/paging/page-size-orientation.html
'author' => 'John Doe',
'subject' => 'This Document will explain the whole universe.',
'keywords' => 'PDF, Laravel, Package, Peace', // Separate values with comma
'creator' => 'Laravel Pdf',
'display_mode' => 'fullpage',
'font_path' => base_path('resources/fonts'),
'font_data' => [
'stsong' => [
'R' => 'stsong.ttf',
'B' => 'stsong.ttf',
'I' => 'stsong.ttf',
'BI' => 'stsong.ttf'
]
],
'tempDir' => storage_path('app/public')
];
使用
Lumen
中 bootstrap/app.php
中添加下两行(最好添加到指定位置):
$app->configure('pdf');
$app->register(niklasravnsborg\LaravelPdf\PdfServiceProvider::class);
Laravel
中写入 Kernel.php
中就行。
真香!!!
最后
了解工具,可以帮助我们更好的使用工具。