Laraflash：优雅的 Laravel 闪消息处理库

Laraflash：优雅的 Laravel 闪消息处理库

Laraflash 是一个精心设计的 Laravel 扩展包，它为开发者提供了一种简单易用的方式来处理和展示应用中的闪消息。灵感来自于 Laravel 的核心精髓，Laraflash 提供了丰富的接口和语法糖，让闪消息管理变得既高效又灵活。

安装与配置

安装 Laraflash 只需一条命令：

composer require coderello/laraflash

然后在 app\Http\Kernel.php 中注册中间件 Coderello\Laraflash\Middleware\HandleLaraflash::class 并将其放置在 Illuminate\Session\Middleware\StartSession::class 之后。还可以通过 php artisan vendor:publish --tag="laraflash-config" 命令发布配置文件。

添加闪消息

Laraflash 支持多种添加闪消息的方式，如下所示：

use Coderello\Laraflash\Facades\Laraflash;

// 示例1
Laraflash::message()->content('内容')->title('标题')->type('success');

// 示例2
laraflash()->message()->content('内容')->title('标题')->success();

// 示例3
laraflash('内容', '标题')->success();

// 示例4
laraflash('内容', '标题', 'success');

这些示例展示了如何利用各种方法组合来创建并设定闪消息的内容、标题、类型等属性。

渲染闪消息

你可以使用 render() 方法将存储的闪消息渲染成 HTML 输出：

laraflash()->render();

默认情况下，消息之间会以 <br> 分隔，并且支持自定义皮肤，所有可用的皮肤都在配置文件中列出。

获取闪消息数组

除了 HTML 格式外，Laraflash 还允许你获取闪消息的数组形式，便于在 API 或其他场景中使用：

laraflash()->toArray();

功能特性

Laraflash 主要方法

• message(): 创建一个新的闪消息实例。
• render(): 将闪消息渲染为 HTML。
• keep(): 让消息在下一次请求时仍然显示。
• clear(): 删除所有闪消息。
• all(): 获取所有的闪消息集合。
• ready(): 获取已准备好的闪消息集合。
• touch(): 更新消息状态（减小跳数，延迟计时，删除过期消息）。
• toArray(): 返回闪消息的数组表示形式。
• toJson(): 返回闪消息的 JSON 表示形式。

FlashMessage 主要方法

• content(): 设置闪消息的内容。
• title(): 设置闪消息的标题。
• type(): 设置闪消息的类型。
• danger(), warning(), info(), success(): 快捷设置不同类型的闪消息。
• hops(): 设置闪消息的显示次数。
• delay(): 设置闪消息的延迟时间。
• attribute(): 设置自定义属性。
• get(): 获取自定义属性的值。
• toArray(): 获取闪消息的数组形式。
• toJson(): 获取闪消息的 JSON 形式。

应用场景

Laraflash 在任何需要向用户反馈信息的应用场景下都非常适用，如表单提交后的提示信息、操作成功或失败的通知、系统提示等。无论是在 Web 界面还是在 API 接口中，都能轻松集成并展示。

总的来说，Laraflash 的设计充分考虑了开发者的便利性，其简洁的 API 设计使得处理闪消息变得轻而易举。如果你正在寻找一个能够提升用户体验，同时简化代码逻辑的 Laravel 闪消息解决方案，Laraflash 绝对值得你尝试。立即加入，让你的 Laravel 应用更上一层楼！