Laravel：自定义或扩展通知 - 数据库模型 - PHP

简介

在 Laravel 中，通知（Notifications）是一种用于向用户发送消息的机制。通知可以通过不同的渠道发送，例如电子邮件、短信或通过数据库模型。本文将介绍如何自定义或扩展通知，特别是利用数据库模型来存储和检索通知。

目标

• 理解 Laravel 的通知系统和数据库模型
• 自定义通知类
• 扩展通知渠道
• 将通知存储到数据库
• 从数据库中检索通知

通知系统概述

Laravel 的通知系统由三个主要组件构成：通知类、通知渠道和通知频道。通知类定义了要发送的消息和与之关联的一些元数据。通知渠道定义了如何将通知发送给用户，例如通过邮件或短信。通知频道则定义了将通知存储在何处，例如数据库或日志文件。

自定义通知类

要自定义通知类，可以使用 php artisan make:notification 命令生成模板。在生成的通知类中，你可以定义要发送的消息和元数据。以下是一个简单的自定义通知类示例：

namespace App\Notifications;

use Illuminate\Bus\Queueable;
use Illuminate\Notifications\Notification;
use Illuminate\Contracts\Queue\ShouldQueue;
use Illuminate\Notifications\Messages\MailMessage;

class InvoicePaid extends Notification
{
    use Queueable;

    protected $amount;

    public function __construct($amount)
    {
        $this->amount = $amount;
    }

    public function via($notifiable)
    {
        return ['mail'];
    }

    public function toMail($notifiable)
    {
        return (new MailMessage)
            ->line('Your invoice has been paid.')
            ->line('Amount: $' . $this->amount);
    }
}

在上面的示例中，InvoicePaid 类继承了 Notification 类，并实现了 via 方法和 toMail 方法。via 方法用于指定使用的通知渠道，这里使用的是邮件渠道。toMail 方法定义了要发送的邮件内容。

扩展通知渠道

要扩展通知渠道，需要实现 Illuminate\Contracts\Notifications\Notification 接口。以下是一个简单的自定义通知渠道示例：

namespace App\Channels;

use Illuminate\Notifications\Notification;

class SmsChannel
{
    public function send($notifiable, Notification $notification)
    {
        $message = $notification->toSms($notifiable);

        // 使用短信渠道发送消息
    }
}

在上面的示例中，SmsChannel 类实现了 send 方法，用于发送短信通知。该方法接收两个参数：$notifiable（接收通知的用户实例）和 $notification（要发送的通知实例）。你可以在 send 方法中使用适当的逻辑将通知发送给用户。

将通知存储到数据库

要将通知存储到数据库，可以使用 Laravel 内置的 DatabaseNotification 模型。你可以使用 php artisan notifications:table 命令生成数据库迁移文件，并执行迁移来创建通知表。

要将通知存储到数据库，只需在通知类中添加 viaDatabase 方法，并返回 ['database']：

public function via($notifiable)
{
    return ['database'];
}

此外，你还需要修改 DatabaseNotification 模型的 toArray 方法，以将通知转换为数组：

public function toArray($notifiable)
{
    return [
        'message' => $this->message,
        // 其他通知元数据
    ];
}

现在，当你发送通知时，通知将被存储到数据库中。

从数据库中检索通知

要从数据库中检索通知，你可以使用 Laravel 提供的 notifications 方法。该方法返回与给定用户关联的通知集合。

以下是一个例子：

$user = User::find(1);
$notifications = $user->notifications;

返回的 $notifications 是一个通知集合，你可以使用 Laravel 的集合方法对其进行操作和过滤。

结论

通过自定义通知类和扩展通知渠道，你可以在 Laravel 中灵活地定制和扩展通知系统。将通知存储到数据库可以让你更方便地管理和检索通知。希望本文能帮助你理解并应用 Laravel 的通知功能。

注意：以上示例中的代码片段仅供参考，实际使用中可能需要根据实际情况进行调整和优化。

参考文档：https://laravel.com/docs/8.x/notifications