Laravel Nova 4 长时操作通知最佳实践：使用内置通知系统

默认消息机制的局限性

在 Laravel Nova 中，我们通常使用 Action::message() 或 Action::danger() 等方法来向用户显示操作执行结果的即时反馈。例如：

return Action::message('操作成功完成！');
return Action::danger('操作过程中发生错误！');

这些消息以“Toast”的形式在屏幕上短暂显示几秒钟后便会自动消失。对于快速完成的操作，这种机制是高效且用户友好的。然而，当处理耗时较长的后台任务（例如，数据导入、报表生成，可能需要数分钟甚至更长时间）时，这种短暂的消息机制就显得力不从心。用户可能会在操作执行期间导航到其他页面或标签页，从而错过任务完成时的关键通知。在这种情况下，一个持久化且可供用户随时查看的通知机制变得尤为重要。

引入 Laravel Nova 4 内置通知功能

为了解决上述问题，Laravel Nova 4 引入了一个强大的内置通知系统，它允许开发者向用户发送更持久、更具交互性的通知。这些通知会显示在 Nova 后台界面的通知中心，用户可以随时查看，并且可以包含操作按钮、图标和不同的通知类型。

通过使用 Laravel\Nova\Notifications\NovaNotification 类，我们可以构建一个功能丰富的通知，完美适用于长时操作的场景。

实现持久化通知

以下是使用 Laravel Nova 4 内置通知功能发送持久化通知的示例代码：

知我AI

一款多端AI知识助理，通过一键生成播客/视频/文档/网页文章摘要、思维导图，提高个人知识获取效率；自动存储知识，通过与知识库聊天，提高知识利用效率。

26

查看详情

<?php

namespace App\Nova\Actions;

use Illuminate\Bus\Queueable;
use Illuminate\Contracts\Queue\ShouldQueue;
use Illuminate\Queue\InteractsWithQueue;
use Laravel\Nova\Actions\Action;
use Laravel\Nova\Fields\ActionFields;
use Laravel\Nova\Notifications\NovaNotification;
use Illuminate\Support\Facades\Log;

class GenerateReport extends Action implements ShouldQueue
{
    use InteractsWithQueue, Queueable;

    /**
     * 执行操作。
     *
     * @param  \Laravel\Nova\Fields\ActionFields  $fields
     * @param  \Illuminate\Support\Collection  $models
     * @return mixed
     */
    public function handle(ActionFields $fields, \Illuminate\Support\Collection $models)
    {
        // 模拟一个耗时操作，例如生成报表
        Log::info('开始生成报表...');
        sleep(300); // 模拟5分钟的执行时间
        Log::info('报表生成完成。');

        // 假设报表生成后有一个可下载的URL
        $reportUrl = 'https://example.com/reports/generated_report_' . uniqid() . '.pdf';

        // 向当前用户发送 Nova 通知
        $fields->request->user()->notify(
            NovaNotification::make()
                ->message('您的报表已准备就绪，请点击下载。')
                ->action('下载报表', $reportUrl) // 添加一个下载按钮
                ->icon('download') // 添加一个下载图标
                ->type('success') // 设置通知类型为成功
        );

        return Action::message('报表生成请求已提交，请留意通知中心。');
    }

    /**
     * 获取操作的字段。
     *
     * @param  \Laravel\Nova\Http\Requests\NovaRequest  $request
     * @return array
     */
    public function fields(\Laravel\Nova\Http\Requests\NovaRequest $request)
    {
        return [];
    }
}

在上述代码中，我们首先模拟了一个耗时 5 分钟的报表生成过程。一旦任务完成，我们不再使用 Action::message() 来通知用户，而是通过 NovaNotification::make() 构建一个通知对象，并将其发送给当前操作的用户。

Nova 通知详解

NovaNotification::make() 方法提供了多个链式调用方法来定制通知：

• message(string $message): 设置通知的主要文本内容。
• action(string $label, string $url): 为通知添加一个可点击的按钮。$label 是按钮显示的文本，$url 是按钮点击后跳转的链接。这对于下载文件或跳转到相关资源非常有用。
• icon(string $icon): 设置通知的图标。Nova 支持多种内置图标（例如 download, check, x, info 等），提升通知的视觉效果和信息传达效率。
• type(string $type): 设置通知的类型。支持 info (默认), success, warning, danger 等，不同类型会显示不同的颜色，帮助用户快速识别通知的性质。
• url(string $url): 设置整个通知卡片点击后跳转的 URL，而不是某个特定按钮。
• model(\Laravel\Nova\Resource $resource): 将通知与某个 Nova 资源关联起来，点击通知可以直接跳转到该资源的详情页。

通过这些方法，我们可以创建出高度定制化且用户友好的通知。

注意事项与最佳实践

1. 版本要求: NovaNotification 功能是 Laravel Nova 4 引入的。如果您的项目使用的是 Nova 3 或更早版本，则无法直接使用此功能。
2. 异步处理: 对于真正耗时的操作，强烈建议将操作本身放入队列（通过实现 ShouldQueue 接口）进行异步处理。这样可以避免请求超时，并确保用户界面保持响应。在队列任务完成后，再发送 NovaNotification。
3. 用户关联: 确保通知发送给正确的用户。在 Nova Action 中，可以通过 $request-youjiankuohaophpcnuser() 获取当前执行操作的用户实例。
4. 清晰的通知内容: 编写简洁明了的通知信息，明确告知用户任务的状态和下一步操作（如果适用）。
5. 区别对待: 对于即时反馈，仍然可以使用 Action::message()。对于需要持久化或交互性的通知，则应优先考虑 NovaNotification。
6. 通知中心: 用户可以在 Nova 界面的右上角找到通知铃铛图标，点击即可查看所有未读和历史通知。

总结

Laravel Nova 4 的内置通知系统为处理长时操作提供了优雅而强大的解决方案。通过从短暂的 Toast 消息转向持久化、可交互的通知，我们极大地提升了用户体验，确保用户即使在操作过程中离开界面，也能及时获取到关键任务的完成状态和相关信息。合理利用 NovaNotification 及其丰富的定制选项，是构建健壮且用户友好的 Nova 后台管理系统的关键一步。

以上就是Laravel Nova 4 长时操作通知最佳实践：使用内置通知系统的详细内容，更多请关注php中文网其它相关文章！