Laravel Livewire 生成并下载 PDF 文件的解决方案

霞舞

发布时间：2025-11-19 13:21:05

565人浏览过

来源于php中文网

原创

laravel livewire 生成并下载 pdf 文件的解决方案

本文旨在解决 Laravel Livewire 应用中生成 PDF 文件并提供下载的问题。通过示例代码和详细步骤，阐述如何利用 response()->streamDownload() 方法实现 PDF 的实时生成和下载，避免常见的序列化错误，并提供更高效的解决方案。

在 Laravel Livewire 应用中，直接使用 return $invoice->download(); 方法下载 PDF 文件可能会遇到 Livewire 不支持或序列化错误的问题。这是因为 Livewire 的工作机制涉及到组件状态的序列化，而某些对象（如闭包）是无法序列化的。为了解决这个问题，我们可以使用 response()->streamDownload() 方法。

以下是如何在 Livewire 组件中生成并下载 PDF 的步骤：

修改 Livewire 组件中的 invoice() 方法：

不再直接返回 $invoice->download()，而是使用 response()->streamDownload()。这个方法允许我们以流的方式发送 PDF 内容，避免了序列化问题。
```
use Symfony\Component\HttpFoundation\StreamedResponse;

public function invoice(): StreamedResponse
{
    $customer = new Buyer([
        'name'          => 'John Doe',
        'custom_fields' => [
            'email' => 'john.doe@example.com',
        ],
    ]);

    $item = (new InvoiceItem())->title('Service 1')->pricePerUnit(2);

    $invoice = Invoice::make()
        ->buyer($customer)
        ->discountByPercent(10)
        ->taxRate(15)
        ->shipping(1.99)
        ->addItem($item);

    return response()->streamDownload(function () use ($invoice) {
        echo  $invoice->stream();
    }, 'invoice.pdf');
}
```
代码解释：
- use Symfony\Component\HttpFoundation\StreamedResponse;：导入StreamedResponse类，用于返回流式下载。
- response()->streamDownload()：此方法接收两个参数：
  - 一个闭包函数，该函数负责生成 PDF 内容并将其输出到流中。在这里，我们使用 $invoice->stream() 方法将 PDF 内容以流的形式输出。
  - 文件名，指定下载的 PDF 文件的名称（例如，'invoice.pdf'）。
- use ($invoice)：将 $invoice 变量传递到闭包函数中，以便在闭包函数中使用 $invoice 对象。
确保 $invoice->stream() 方法存在：

$invoice->stream() 方法应该返回 PDF 的二进制内容。如果你的 Invoice 类没有 stream() 方法，你需要添加它。通常，这个方法会调用 PDF 生成库（例如 Dompdf 或 TCPDF）来生成 PDF 内容，然后将其作为字符串返回。

示例：
```
// 假设使用 Dompdf 生成 PDF
use Dompdf\Dompdf;

public function stream(): string
{
    $dompdf = new Dompdf();
    $dompdf->loadHtml($this->render()); // $this->render() 渲染 PDF 模板
    $dompdf->render();

    return $dompdf->output();
}
```
注意： $this->render() 应该返回包含发票内容的 HTML 字符串。你需要根据你的实际情况修改这个方法。
前端 Livewire 组件调用：

确保你的 Livewire 组件中有一个按钮或链接，点击后触发 invoice() 方法。
```
下载发票
```