README

Laravel包装器，用于Dompdf HTML到PDF转换器

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

composer require barryvdh/laravel-dompdf

安装

Laravel 5.x

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

Barryvdh\DomPDF\ServiceProvider::class,

您可以选择使用外观以缩短代码。将以下内容添加到您的外观中

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

Lumen

更新composer后，将以下行添加到bootstrap/app.php中的注册提供者

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

或者使用外观

    $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', 'landscape')->setWarnings(false)->save('myfile.pdf')

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

使用php artisan vendor:publish创建位于config/dompdf.php的配置文件，这将允许您定义本地配置以更改某些设置（默认纸张等）。您还可以使用自己的ConfigProvider设置某些键。

配置

默认配置设置在config/dompdf.php中设置。将此文件复制到您的自己的配置目录以修改值。您可以使用此命令发布配置

    php artisan vendor:publish --provider="Barryvdh\DomPDF\ServiceProvider"

您仍然可以在生成PDF之前使用此命令更改dompdf选项

    PDF::setOptions(['dpi' => 150, 'defaultFont' => 'sans-serif']);

可用选项及其默认值

• rootDir："{app_directory}/vendor/dompdf/dompdf"
• tempDir："/tmp" (在config/dompdf.php中可用)
• fontDir："{app_directory}/storage/fonts/" (在config/dompdf.php中可用)
• fontCache："{app_directory}/storage/fonts/" (在config/dompdf.php中可用)
• chroot："{app_directory}" (在config/dompdf.php中可用)
• logOutputFile："/tmp/log.htm"
• defaultMediaType："screen" (在config/dompdf.php中可用)
• defaultPaperSize："a4" (在config/dompdf.php中可用)
• defaultFont："serif" (在config/dompdf.php中可用)
• dpi：96 (在config/dompdf.php中可用)
• fontHeightRatio：1.1 (在config/dompdf.php中可用)
• isPhpEnabled：false (在config/dompdf.php中可用)
• isRemoteEnabled：true (在config/dompdf.php中可用)
• isJavascriptEnabled：true (在config/dompdf.php中可用)
• isHtml5ParserEnabled：false (在config/dompdf.php中可用)
• isFontSubsettingEnabled：false (在config/dompdf.php中可用)
• debugPng：false
• debugKeepTemp：false
• debugCss：false
• debugLayout：false
• debugLayoutLines：true
• debugLayoutBlocks：true
• debugLayoutInline：true
• debugLayoutPaddingBox：true
• pdfBackend："CPDF" (在config/dompdf.php中可用)
• pdflib许可证: ""
• adminUsername："user"
• adminPassword： "密码"

提示：UTF-8 支持

在您的模板中，设置 UTF-8 元标签

<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 许可协议