misterspelik / laravel-pdf
使用此mPDF包装器在Laravel中生成PDF。
Requires
- php: ^7.4 || ^8.0
- ext-gd: *
- ext-imagick: *
- ext-mbstring: *
- misterspelik/mpdf: ^8.1.6
- psr/http-message: ^1.1 || ^2.0
- psr/log: ^1.1.0 || ^2.0.0 || ^3.0.0
Requires (Dev)
- orchestra/testbench: ^8.5.0
- phpunit/phpunit: ^9.6.0
README
使用此mPDF包装器,您可以在Laravel内部轻松地从HTML生成PDF文档。
支持的版本
最低支持版本是Laravel 5
安装
在您的 composer.json
中要求此包,或者通过运行以下命令安装它
composer require misterspelik/laravel-pdf
注意:此包支持Laravel 5.5+的自动发现功能,如果您在低于5.5的Laravel版本上工作,则需要手动添加服务提供者和别名。
要开始使用Laravel,请将服务提供者和外观添加到您的 config/app.php
'providers' => [ // ... misterspelik\LaravelPdf\Providers\PdfServiceProvider::class ]
'aliases' => [ // ... 'PDF' => misterspelik\LaravelPdf\Facades\Pdf::class ]
现在,您应该通过以下命令将包的配置文件发布到您的配置目录中
php artisan vendor:publish
基本用法
要使用Laravel PDF,请将以下内容添加到您的控制器中之一。您可以将数据传递到 /resources/views
中的视图。
use PDF; function generate_pdf() { $data = [ 'foo' => 'bar' ]; $pdf = PDF::loadView('pdf.document', $data); return $pdf->stream('document.pdf'); }
其他方法
您还可以在 pdf
对象上使用以下方法
output()
:将PDF作为字符串输出。
save($filename)
:将PDF保存到文件。
download($filename)
:使PDF可供用户下载。
stream($filename)
:返回一个响应,在浏览器中显示PDF。
配置
如果您已发布配置文件,您可以在 config/pdf.php
文件中更改默认设置
return [ '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', ];
要基于文件覆盖此配置,请在初始化调用中使用第四个参数,如下所示
PDF::loadView('pdf', $data, [], [ 'format' => 'A5-L' ])->save($pdfFilePath);
您可以使用带有 'instanceConfigurator' 键的回调来访问mpdf函数
$config = ['instanceConfigurator' => function($mpdf) { $mpdf->SetImportUse(); $mpdf->SetDocTemplate(/path/example.pdf, true); }] PDF::loadView('pdf', $data, [], $config)->save($pdfFilePath);
页眉和页脚
如果您希望每页都有页眉和页脚,请像这样将它们添加到您的 <body>
标签中
<htmlpageheader name="page-header"> Your Header Content </htmlpageheader> <htmlpagefooter name="page-footer"> Your Footer Content </htmlpagefooter>
现在,您只需使用名称属性在您的CSS中定义它们即可
@page { header: page-header; footer: page-footer; }
在页眉和页脚中,{PAGENO}
可以用来显示页码。
包含的字体
默认情况下,您可以使用mPDF附带的所有字体。请参阅mPDF中可用的字体。
自定义字体
您可以在生成的PDF中使用自己的字体。TTF文件必须位于一个文件夹中,例如 /resources/fonts/
。将以下内容添加到您的配置文件中(/config/pdf.php
)
return [ // ... 'font_path' => base_path('resources/fonts/'), 'font_data' => [ 'examplefont' => [ 'R' => 'ExampleFont-Regular.ttf', // regular font 'B' => 'ExampleFont-Bold.ttf', // optional: bold font 'I' => 'ExampleFont-Italic.ttf', // optional: italic font 'BI' => 'ExampleFont-Bold-Italic.ttf' // optional: bold-italic font //'useOTL' => 0xFF, // required for complicated langs like Persian, Arabic and Chinese //'useKashida' => 75, // required for complicated langs like Persian, Arabic and Chinese ] // ...add as many as you want. ] // ... ];
注意:如果您使用 laravel-pdf
生成复杂的语言(如波斯语、阿拉伯语或中文)的PDF文档,则应在自定义字体定义数组中具有 useOTL
和 useKashida
索引。如果您不使用这些索引,您的字符将错误地显示为散列并在生成的PDF中显示。
现在您可以在CSS中使用此字体
body { font-family: 'examplefont', sans-serif; }
自定义样式
您可以在生成的PDF中使用自己的样式。CSS文件必须位于一个文件夹中,例如 /public/css/
。将以下内容添加到您的配置文件中(/config/pdf.php
)
return [ //... 'defaultCssFile' => base_path('public/css/pdf.css'), ];
设置保护
要设置保护,只需调用 SetProtection()
方法并传递一个包含权限、用户密码和所有者密码的数组。
密码是可选的。
有一些权限:'copy'
、'print'
、'modify'
、'annot-forms'
、'fill-forms'
、'extract'
、'assemble'
、'print-highres'
。
use PDF; function generate_pdf() { $data = [ 'foo' => 'bar' ]; $pdf = PDF::loadView('pdf.document', $data); $pdf->SetProtection(['copy', 'print'], '', 'pass'); return $pdf->stream('document.pdf'); }
在这里找到有关 SetProtection()
的更多信息:https://mpdf.github.io/reference/mpdf-functions/setprotection.html
PDF包装器扩展
此软件包为 Mpdf\Mpdf 类提供了自己的包装器。但也可以在项目级别上对其进行覆盖或扩展。
在配置文件中有一个设置,用于使用自定义 PdfWrapper。
return [ // ... 'pdfWrapper' => 'misterspelik\LaravelPdf\Wrapper\PdfWrapper', ];
包装器必须实现的唯一要求是接口 misterspelik\LaravelPdf\PdfInterface\PdfWrapperInterface
测试
要使用测试套件,您需要为本地PHP安装一些扩展和二进制文件。在macOS上,您可以这样安装:
brew install imagemagick ghostscript
pecl install imagick
许可证
Laravel PDF是开源软件,许可协议为MIT许可证