olivierneo/laravel-dompdf

Laravel 的 DOMPDF 包装器

v0.6.1 2015-12-21 19:51 UTC

README

对于 Laravel 4.x,请查看 0.4 分支

在 composer.json 中添加此包并在 composer 中更新。这将下载此包以及 dompdf 和 fontlib 库。

"barryvdh/laravel-dompdf": "0.6.*"

安装

Laravel 5.x

更新 composer 后,将 ServiceProvider 添加到 config/app.php 中的 providers 数组

Barryvdh\DomPDF\ServiceProvider::class,

您可以可选地使用 facade 以缩短代码。将其添加到您的 facades

'PDF' => Barryvdh\DomPDF\Facade::class,

Lumen

更新 composer 后,将以下行添加到 bootstrap/app.php 中以注册 provider

$app->register(\Barryvdh\DomPDF\ServiceProvider::class);

要更改配置,将配置文件复制到您的配置文件夹中,并在 bootstrap/app.php 中启用它

$app->configure('dompdf');

使用

您可以创建一个新的 DOMPDF 实例并加载一个 HTML 字符串、文件或视图名称。您可以将其保存到文件中,或通过流(在浏览器中显示)或下载。

$pdf = App::make('dompdf.wrapper');
$pdf->loadHTML('<h1>Test</h1>');
return $pdf->stream();

或者使用 facade

$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');

您可以更改方向和纸张大小,以及隐藏或显示错误(默认情况下,当调试开启时显示错误)

PDF::loadHTML($html)->setPaper('a4')->setOrientation('landscape')->setWarnings(false)->save('myfile.pdf')

如果您需要输出为字符串,可以使用 output() 函数获取渲染的 PDF,然后您可以自行保存/输出它。

使用 php artisan vendor:publish 创建一个配置文件,位于 config/dompdf.php,允许您定义本地配置以更改某些设置(默认纸张等)。您还可以使用您的 ConfigProvider 设置某些键。

提示:UTF-8 支持

在您的模板中,设置 UTF-8 Metatag

<meta http-equiv="Content-Type" content="text/html; charset=utf-8"/>

提示:页面中断

您可以使用 CSS page-break-before/page-break-after 属性来创建新页面。

<style>
.page-break {
    page-break-after: always;
}
</style>
<h1>Page 1</h1>
<div class="page-break"></div>
<h1>Page 2</h1>

许可

此 Laravel 的 DOMPDF 包装器是开源软件,许可协议为 MIT 许可协议