在 Laravel 中生成 PDF 文档

在现代 web 开发中，生成 PDF 文档是一项常见需求，尤其是在需要生成发票、报表或其他格式文档的情况下。Laravel 框架以其简洁的语法和强大的功能受到了广泛欢迎。本文将详细介绍如何在 Laravel 中生成 PDF 文档。

选择合适的 PDF 库

在 Laravel 中生成 PDF 文档，有几个流行的库可以选择。其中，最常用的包括 dompdf 和 snappy。这两个库功能强大，各有特点。

dompdf

dompdf 是一个 PHP 库，它可以将 HTML 转换为 PDF。使用 dompdf 很简单，支持多种 CSS样式与字体，是一个非常适合生成简单 PDF 文档的选择。

snappy

snappy 则是基于 wkhtmltopdf 的一个 PDF 生成库，能够更好地处理复杂的 HTML 和 CSS。它适合需要生成高质量 PDF 的场景。例如发票和报表。

安装步骤

无论选择哪个库，首先需要通过 Composer 安装相应的包。以 dompdf 为例：

composer require barryvdh/laravel-dompdf

对于 snappy，可以使用以下命令进行安装：

composer require barryvdh/laravel-snappy

配置 Laravel 项目

安装完成后，需要在 Laravel 的配置文件中进行相应设置。对于 dompdf，通常会自动注册服务提供者。如果需要手动注册，可以在 config/app.php 中添加：

'providers' => [
    Barryvdh\DomPDF\ServiceProvider::class,
],

对于 snappy，同样需要在 config/app.php 中添加：

'providers' => [
    Barryvdh\Snappy\ServiceProvider::class,
],

生成 PDF 文档

接下来，开始生成 PDF 文档。无论使用哪种库，流程基本相似。以下是使用 dompdf 生成简单 PDF 的示例代码：

use PDF;

public function generatePDF() {
    $data = ['title' => '欢迎使用 Laravel PDF'];
    $pdf = PDF::loadView('pdf.document', $data);
    return $pdf->download('document.pdf');
}

在上述代码中，`PDF::loadView` 方法会加载指定的视图并将数据传递给它。然后，`download` 方法将生成的 PDF 文档下载到客户端。

视图文件

需要创建一个视图文件以便加载。你可以在 resources/views/pdf/document.blade.php 中添加以下内容：

<h1>{{ $title }}</h1>

use Barryvdh\Snappy\Facades\Snappy;

public function generateSnappyPDF() {
    $data = ['title' => '欢迎使用 Snappy PDF'];
    $pdf = Snappy::loadView('pdf.document', $data);
    return $pdf->download('document.pdf');
}