在 laravel 项目中，生成 pdf 文档是一个常见的需求，尤其是在需要生成报表、发票或其他文档时。然而，传统的生成 pdf 的方法往往复杂且难以实现现代化布局。最近，我在项目中遇到了这样的问题：需要生成一个包含复杂布局的发票 pdf，传统方法难以实现现代化的 css 布局，如 grid 和 flexbox。
经过一番探索，我发现了 spatie/laravel-pdf 这个库，它提供了一种简单且高效的方法来生成 PDF 文档。使用这个库，我可以直接从 Blade 视图生成 PDF，并利用现代 CSS 特性来创建美观的文档。
使用 spatie/laravel-pdf 非常简单，首先通过 Composer 安装：
composer require spatie/laravel-pdf
然后，你就可以轻松地生成 PDF 文档了。以下是一个简单的例子，展示如何从 Blade 视图生成 PDF：
use Spatie\LaravelPdf\Facades\Pdf;
Pdf::view('pdfs.invoice', ['invoice' => $invoice])
->format('a4')
->save('invoice.pdf');这段代码会渲染 pdfs.invoice Blade 视图，并将生成的 PDF 保存为 invoice.pdf 文件。
你也可以直接从控制器中返回 PDF 作为响应：
use Spatie\LaravelPdf\Facades\Pdf;
class DownloadInvoiceController
{
public function __invoke(Invoice $invoice)
{
return Pdf::view('pdfs.invoice', ['invoice' => $invoice])
->format('a4')
->name('your-invoice.pdf');
}
}此外，spatie/laravel-pdf 还提供了测试功能，确保你的 PDF 生成过程正确无误：
use Spatie\LaravelPdf\Facades\Pdf;
it('can render an invoice', function () {
Pdf::fake();
$invoice = Invoice::factory()->create();
$this->get(route('download-invoice', $invoice))
->assertOk();
Pdf::assertRespondedWithPdf(function (PdfBuilder $pdf) {
return $pdf->contains('test');
});
});使用 spatie/laravel-pdf 解决了我在项目中生成 PDF 文档的难题。它不仅简化了生成过程，还支持现代 CSS 特性，使得生成的 PDF 文档更加美观和专业。如果你在 Laravel 项目中需要生成 PDF 文档，spatie/laravel-pdf 是一个非常值得推荐的工具。
