seguce92/laravel-dompdf

Laravel 的 DOMPDF 包装器,基于 barryvdh/laravel-dompdf 包的分支

v2.3 2020-02-21 01:43 UTC

This package is auto-updated.

Last update: 2024-09-28 01:51:41 UTC


README

安装

Laravel 5.x

您可以通过 Composer 安装适用于您 Laravel 5 项目的包。

$ composer require seguce92/laravel-dompdf

app/config/app.php 中注册服务提供者数组。

Seguce92\DomPDF\ServiceProvider::class,

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

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

Lumen

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

$app->register(\Seguce92\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')->setOrientation('landscape')->setWarnings(false)->save('myfile.pdf')

您可以添加图像和文本类型的水印

```php
$pdf = App::make('dompdf.wrapper');
$pdf->setWatermarkImage('path/to/image.png');
$pdf->loadHTML('<h1>Test</h1>');
return $pdf->stream();
```

注意:要正确运行 setWatermarkText [尺寸更改],请启用 "DOMPDF_ENABLE_FONTSUBSETTING" => true,在 app/config/dompdf.php

```php
$pdf = App::make('dompdf.wrapper');
$pdf->setWatermarkText('example', '150px');
$pdf->loadHTML('<html><head><title>Hello world</title><body><h1>example</h1></body></html>');
return $pdf->stream();
```

方法属性

  • setWatermarkImage

    $pdf->setWatermarkImage($image, $opacity = 0.6, $top = '30%', $width = '100%', $height = '100%');
    $image = path to image file *.png, *.jpeg, ect
    $opacity = values accept 1.0 - 0.11111
    $top = margin respect to top page
    $with = size image width
    $height = size image height
  • setWatermarkText

    $pdf->setWatermarkText($text, $size = '100px', $opacity = 0.6, $rotate = '10deg', $top = '30%')
    $text = text a view with watermark
    $size = font size
    $opacity = values accept 1.0 - 0.11111
    $rotate = rotation text in deg values  (css transform-rotate
    $top = margin respect to top page

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

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

提示: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 包装器是开源软件,许可协议为 barryvdh/laravel-dompdf 仓库