README

使用Laravel的Blade模板和MPDF库轻松生成PDF文件。[a href="https://laravel.net.cn/docs/blade" rel="nofollow noindex noopener external ugc">Laravel的Blade模板MPDF库。该包已从Laravel 5.4开始测试。

安装

在您的Laravel应用程序中运行以下composer命令

composer require analize/laravel-mpdf-analize

重要提示

始终检查官方MPDF文档
当使用如php -S 或 artisan serve的单线程服务器时，mPDF在获取外部HTTP资源时会超时。[a href="https://github.com/mpdf/mpdf#known-server-caveats" rel="nofollow noindex noopener external ugc">已知服务器缺陷

要开始使用Laravel，请将服务提供者和外观添加到您的 config/app.php

注意：此包支持Laravel 5.5+的自动发现功能，如果您在低于5.5版本的Laravel上工作，则只需手动添加服务提供者和别名。

'providers' => [
    // ...
    Analize\LaravelMpdf\LaravelMpdfAnalizeServiceProvider::class
]

'aliases' => [
    // ...
    'PDFANALIZE' => Analize\LaravelMpdf\Facades\LaravelMpdf::class
]

此分支的目标是移除索引之后出现的空白页面，以下是步骤。

为使修改生效，请添加MpdfAnalize包

composer require wendel-ulhoa/laravel-mpdf-analize
composer require analize/mpdf-analize

use Analize\LaravelMpdfAnalize\LaravelMpdfAnalizeWrapper;

/* Criando uma instância da classe LaravelMpdfAnalizeWrapper, biblioteca modificada para que possa retirar a página em branco após os índices. */
$mpdf = new LaravelMpdfAnalizeWrapper();

/* Obtendo a renderização do PDF utilizando o Mpdf e a separação por chuncks para não atingir o limite de backtrack */
$pdf = $mpdf->chunkLoadView('<!--chunk-->', 'view', [], [], $configs);

/* Remove a página em branco que era adicionada após os índices, (Caso queira que volte a fazer a mesma impressão é só comentar a linha abaixo.). */ 
$pdf->getMpdf()->deletePage(2, true);

基本用法

要使用Laravel Mpdf，请将以下内容添加到您的控制器中之一。您可以将数据传递到/resources/views中的视图。

//....

use PDF;

class ReportController extends Controller 
{
    public function viewPdf()
    {
        $data = [
            'foo' => 'bar'
        ];

        $pdf = PDF::loadView('pdf.document', $data);

        return $pdf->stream('document.pdf');
    }

}

配置

您可以使用自定义文件覆盖默认配置。只需执行php artisan vendor:publish --tag=mpdf-config或创建config/pdf.php并添加以下内容

return [
    'mode'                       => '',
    'format'                     => 'A4',
    'default_font_size'          => '12',
    'default_font'               => 'sans-serif',
    'margin_left'                => 10,
    'margin_right'               => 10,
    'margin_top'                 => 10,
    'margin_bottom'              => 10,
    'margin_header'              => 0,
    'margin_footer'              => 0,
    'orientation'                => 'P',
    'title'                      => 'Laravel mPDF',
    'author'                     => '',
    'watermark'                  => '',
    'show_watermark'             => false,
    'show_watermark_image'       => false,
    'watermark_font'             => 'sans-serif',
    'display_mode'               => 'fullpage',
    'watermark_text_alpha'       => 0.1,
    'watermark_image_path'       => '',
    'watermark_image_alpha'      => 0.2,
    'watermark_image_size'       => 'D',
    'watermark_image_position'   => 'P',
    'custom_font_dir'            => '',
    'custom_font_data'           => [],
    'auto_language_detection'    => false,
    'temp_dir'                   => storage_path('app'),
    'pdfa'                       => false,
    'pdfaauto'                   => false,
    'use_active_forms'           => false,
];

要基于文件覆盖此配置，请在初始化调用中使用第四个参数，如下所示

// ...

PDF::loadView('pdf', $data, [], [
    'title' => 'Another Title',
    'margin_top' => 0
])->save($pdfFilePath);

获取Mpdf实例

您可以通过getMpdf方法通过mpdf实例访问所有mpdf方法。

use PDF;

$pdf = PDF::loadView('pdf.document', $data);
$pdf->getMpdf()->AddPage(/*...*/);

页眉和页脚

如果您想在每个页面上都有页眉和页脚，请将其添加到您的<body>标签中，如下所示

<htmlpageheader name="page-header">
    Your Header Content
</htmlpageheader>

<htmlpagefooter name="page-footer">
    Your Footer Content
</htmlpagefooter>

现在您只需使用CSS中的name属性定义它们

@page {
  header: page-header;
  footer: page-footer;
}

在页眉和页脚内部，可以使用{PAGENO}显示页码。

包含的字体

默认情况下，您可以使用Mpdf中提供的所有字体。

自定义字体

您可以在生成的PDF中使用自己的字体。TTF文件必须位于一个文件夹中，例如resources/fonts/。将其添加到您的配置文件（/config/pdf.php）中

return [
    'custom_font_dir'  => base_path('resources/fonts/'), // don't forget the trailing slash!
    'custom_font_data' => [
        'examplefont' => [ // must be lowercase and snake_case
            '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
        ]
      // ...add as many as you want.
    ]
];

现在您可以在CSS中使用此字体

body {
  font-family: 'examplefont', sans-serif;
}

包含HTML块

对于大HTML，您可能会遇到错误Uncaught Mpdf\MpdfException: The HTML code size is larger than pcre.backtrack_limit xxx，或者您可能只得到空或空白的结果。在这些情况下，您可以在添加分隔符到HTML的同时使用chunk方法。

//....
use PDF;
class ReportController extends Controller 
{
    public function generate_pdf()
    {
        $data = [
            'foo' => 'hello 1',
            'bar' => 'hello 2'
        ];
        $pdf = PDF::chunkLoadView('<html-separator/>', 'pdf.document', $data);
        return $pdf->stream('document.pdf');
    }
}

<div>
    <h1>Hello World</h1>

    <table>
        <tr><td>{{ $foo }}</td></tr>
    </table>
    
    <html-separator/>

    <table>
        <tr><td>{{ $bar }}</td></tr>
    </table>

    <html-separator/>
</div>

添加对可宏化特质的支持

您可以在AppServiceProvider提供者文件中配置宏。

//...
use Analize\LaravelMpdf\LaravelMpdf;

class AppServiceProvider extends ServiceProvider
{
  //...

    public function boot()
    {
        LaravelMpdf::macro('hello', function () {
            return "Hello, World!";
        });
    }

  //...
}

现在

PDF::loadView(/* ... */)->hello();

许可

Laravel Mpdf是开源软件，许可协议为MIT许可

analize / laravel-mpdf-analize

维护者

详细信息