数据库通知

概述

开始前，请确保将 Laravel 通知表添加到数据库中：

php artisan notifications:table

如果你用的是 PostgreSQL，请确保迁移中 data 字段使用 json(): $table->json('data')。

如果你的 User 模型中使用了 UUID，请确保你的 notifiable 字段使用 uuidMorphs(): $table->uuidMorphs('notifiable')。

要将数据库通知添加到应用中，你必须在你的 Blade 布局中添加一个新的 Livewire 组件：

@livewire('database-notifications')

数据库通知会在模态框中渲染。要打开这一模态框，你必须在视图中有一个“触发”按钮。在应用中创建新的触发按钮组件，比如在 /resources/views/filament/notifications/database-notifications-trigger.blade.php 文件中：

<button type="button">
    Notifications ({{ $unreadNotificationsCount }} unread)
</button>

$unreadNotificationsCount 是一个自动传入视图的变量，它提供了用户未读通知的实时数量。

在该服务提供者中，指向新的触发视图：

use Filament\Notifications\Livewire\DatabaseNotifications;

DatabaseNotifications::trigger('filament.notifications.database-notifications-trigger');

然后，点击视图中渲染的触发按钮。一个包含数据库通知的模态框就会出现！

发送数据库通知

有多种方法可用于发送数据库通知，取决于哪一种更适合你。

你可以使用我们的 fluent API:

use Filament\Notifications\Notification;

$recipient = auth()->user();

Notification::make()
    ->title('Saved successfully')
    ->sendToDatabase($recipient);

或者，也可以使用 notify() 方法：

use Filament\Notifications\Notification;

$recipient = auth()->user();

$recipient->notify(
    Notification::make()
        ->title('Saved successfully')
        ->toDatabase(),
);

此外，还可以使用传统 Laravel 通知类返回通知给 toBroadcast() 方法：

use App\Models\User;
use Filament\Notifications\Notification;

public function toDatabase(User $notifiable): array
{
    return Notification::make()
        ->title('Saved successfully')
        ->getDatabaseMessage();
}

接收数据库通知

如果不进行配置，新的数据库通知只会在页面首次加载时收到。

轮询新数据库通知

轮询是定期向服务器发送请求，检查是否有新通知的操作。此方法安装简单，不过这不是可扩展的方案因为它会增加服务器负载。

默认情况下，Livewire 轮询每 30 秒发起一次：

use Filament\Notifications\Livewire\DatabaseNotifications;

DatabaseNotifications::databaseNotifications();
DatabaseNotifications::databaseNotificationsPollingInterval('30s');

如果需要，你可以完全禁用轮询：

use Filament\Notifications\Livewire\DatabaseNotifications;

DatabaseNotifications::databaseNotifications();
DatabaseNotifications::databaseNotificationsPollingInterval(null);

使用 Echo 接收 websocket 的新数据库通知

此外，也可以本地集成 Laravel Echo。请确保已经安装了 Echo， 以及服务端 websocket 集成如 Pusher。

一旦安装了 websocket，在发送数据库通知后，你可以排放 DatabaseNotificationsSent 事件，使用户立即获取新的通知：

use Filament\Notifications\Events\DatabaseNotificationsSent;
use Filament\Notifications\Notification;

$recipient = auth()->user();

Notification::make()
    ->title('Saved successfully')
    ->sendToDatabase($recipient);

event(new DatabaseNotificationsSent($recipient));

将数据库通知标记为已读

在模态框顶部有一个按钮，用来一次性将所有通知标记为已读。你可能也想将 Action 添加到通知中，然后将单条通知标记为已读。为此，请在 Action 上使用 markAsRead() 方法：

use Filament\Notifications\Actions\Action;
use Filament\Notifications\Notification;

Notification::make()
    ->title('Saved successfully')
    ->success()
    ->body('Changes to the post have been saved.')
    ->actions([
        Action::make('view')
            ->button()
            ->markAsRead(),
    ])
    ->send();

此外，你可以使用 markAsUnread() 方法将一条消息设置成未读：

use Filament\Notifications\Actions\Action;
use Filament\Notifications\Notification;

Notification::make()
    ->title('Saved successfully')
    ->success()
    ->body('Changes to the post have been saved.')
    ->actions([
        Action::make('markAsUnread')
            ->button()
            ->markAsUnread(),
    ])
    ->send();

打开数据库通知模态框

除了上述渲染触发按钮，你也可以通过派发(dispatch) open-modal 浏览器事件，在任何地方中打开数据库通知模态框：

<button
    x-data="{}"
    x-on:click="$dispatch('open-modal', { id: 'database-notifications' })"
    type="button"
>
    Notifications
</button>