gbuckingham89/laraflash

用于处理Laravel中的闪存消息/通知的包。

5.0.0 2024-07-25 08:48 UTC

This package is auto-updated.

Last update: 2024-09-25 09:06:27 UTC


README

这是一个简单的用于处理Laravel中闪存消息/通知的包。根据我的需求编写,但希望其他人也会觉得它很有用。

当前版本需要Laravel 7.0及PHP 8.0或更高版本。如果您有一个需要较低版本PHP或Laravel的项目,请检查旧版本的要求。

安装

推荐的方式是使用Composer - 在您的终端中简单地运行此命令

composer require gbuckingham89/laraflash

除非您已禁用自动发现,否则服务提供者和外观将自动为您注册。如果是这种情况,您需要手动注册服务提供者和外观

对于服务提供者,将以下内容添加到您的app.php配置文件中的providers数组中

Gbuckingham89\Laraflash\ServiceProvider::class

对于外观,将以下内容添加到您的app.php配置文件中的aliases数组中

'Laraflash' => Gbuckingham89\Laraflash\Facade\Laraflash::class

最后,您需要发布视图文件(除非您想自己创建)。在您的终端中运行此命令来完成此操作

php artisan vendor:publish --provider="Gbuckingham89\Laraflash\ServiceProvider"

使用

设置消息

在您重定向到另一个页面之前,只需使用Laraflash外观来设置您的消息。您可以按如下方式调用主要的flash方法

Laraflash::flash("This is a flash message.", "success");

第一个参数是您的消息,第二个是优先级级别。

还有四个辅助方法可用于更轻松地设置优先级级别

Laraflash::success("This is a success flash message.");

Laraflash::info("This is an info flash message.");

Laraflash::warning("This is a warning flash message.");

Laraflash::danger("This is a danger flash message.");

显示消息

要显示消息,只需在您的视图中包含捆绑的视图(为Bootstrap构建)

@include('laraflash::laraflash')

或者,您可以直接访问会话中的数据(存储在laraflash.messagelaraflash.level中)并创建自己的视图。

测试断言

此包提供了Gbuckingham89\Laraflash\LaraflashAssertions,其中包含一些基本/常见断言,以便您测试响应是否包含laraflash消息。

use Gbuckingham89\Laraflash\LaraflashAssertions;

LaraflashAssertions::assertResponseDoesntHaveLaraflash($response);

LaraflashAssertions::assertResponseHasLaraflash($response, 'info', 'The message you are expecting');

LaraflashAssertions::assertResponseHasLaraflashSuccess($response, 'The message you are expecting');
LaraflashAssertions::assertResponseHasLaraflashInfo($response, 'The message you are expecting');
LaraflashAssertions::assertResponseHasLaraflashWarning($response, 'The message you are expecting');
LaraflashAssertions::assertResponseHasLaraflashDanger($response, 'The message you are expecting');

版权和许可证

代码和文档版权所有George Buckingham

代码在MIT许可证下发布。