动态根据 URL 参数生成不同发票内容的 Laravel 教程

在 Lara vel 项目中，如果你需要根据不同的 URL 地址（比如 /admin/invoice/1、/admin/invoice/2）来生成对应的 PDF 发片，一个常见的坑就是试图用硬编码的 URL 字符串去判断。这篇文章就来聊聊如何通过路由参数动态识别发片 ID，进而渲染不同的内容，让代码更健壮、更易维护。

直接写一个 if ('http://...') 来作为判断条件？这完全行不通。在 PHP 里，一个非空的字符串在条件判断中永远为 true，所以第一个 if 分支会一直被执行，后面的 else if 永远没机会登场。正确的做法，是从路由中获取参数值，然后根据这个值走不同的逻辑分支。

正确实现方式：利用路由参数绑定

你已经在路由中正确定义了带参数的路径：

Route::get('admin/invoice/{id}/', [InvoiceController::class, 'show']);

Lara vel 会自动把 URL 里的 {id}（比如 /admin/invoice/2/ 中的 2）解析出来，并注入到控制器方法的参数中。接下来，只需要在 show() 方法的签名里声明 $id 参数就行了：

public function show(int $id) // 强制类型提示为 int，更安全
{
    // 根据 $id 加载对应数据（推荐：从数据库查询）
    $invoiceData = match($id) {
        1 => [
            'name' => 'Ahmed',
            'email' => '[email protected]',
            'title' => 'Reservation 1',
            'amount' => 245,
        ],
        2 => [
            'name' => 'Abdullah',
            'email' => '[email protected]',
            'title' => 'Reservation 2',
            'amount' => 467,
        ],
        default => abort(404, 'Invoice not found'),
    };

    $customer = new Buyer([
        'name'          => $invoiceData['name'],
        'custom_fields' => [
            'Email' => ''.$invoiceData['email'].'',
        ],
    ]);

    $item = (new InvoiceItem())
        ->title($invoiceData['title'])
        ->pricePerUnit($invoiceData['amount']);

    $invoice = Invoice::make()
        ->buyer($customer)
        ->series('10')
        ->sequence(10000 + $id) // 区分单号，如 10001、10002
        ->dateFormat('m/d/Y')
        ->currencySymbol('SR')
        ->discountByPercent(10)
        ->taxRate(15)
        ->addItem($item);

    return $invoice->stream("invoice_{$id}.pdf");
}

重要注意事项

• 别再用 URL 字符串做判断了：if('http://...') 这种写法不仅恒真，还完全违背了 MVC 的分离原则。
• 数据库才是王道：在生产环境里，应该通过 $invoice = Invoice1::findOrFail($id) 从数据库查询真实数据，而不是用硬编码的数组。
• 异常处理不可少：对于非法的 ID，记得用 abort(404) 或抛出 ModelNotFoundException。
• 邮箱链接需要安全处理：示例中直接使用了标准的 mailto: 链接，避免被一些干扰项混淆。
• PDF 文件名建议动态化：比如 stream("invoice_{$id}.pdf")，用户下载时一眼就能认出是哪个发片。

进阶建议（推荐）

如果想更进一步，可以把生成发片的逻辑抽出来，封装成一个独立的服务类，比如 InvoiceGeneratorService。然后在控制器里调用它：

return app(InvoiceGeneratorService::class)->generateForId($id)->stream();

这样做的好处很明显：单元测试更方便，代码复用性更强，后期如果想扩展成支持导出 Excel 或邮件发送，也只需要改这一个地方。

合理利用 Lara vel 的路由参数绑定机制，能够简洁、安全、可扩展地实现“一个 URL 对应一张发片”的动态内容生成目标。