Package Data | |
---|---|
Maintainer Username: | spatie |
Maintainer Contact: | freek@spatie.be (Freek Van der Herten) |
Package Create Date: | 2019-03-14 |
Package Last Update: | 2024-02-27 |
Home Page: | https://freek.dev/1291-a-laravel-package-to-flash-messages |
Language: | PHP |
License: | MIT |
Last Refreshed: | 2024-11-19 03:18:08 |
Package Statistics | |
---|---|
Total Downloads: | 1,383,006 |
Monthly Downloads: | 21,183 |
Daily Downloads: | 988 |
Total Stars: | 564 |
Total Watchers: | 12 |
Total Forks: | 31 |
Total Open Issues: | 0 |
This is a lightweight package to send flash messages in Laravel apps. A flash message is a message that is carried over to the next request by storing it in the session. This package only supports one single flash message at a time.
This is how it can be used:
class MySpecialSnowflakeController
{
public function store()
{
// …
flash('My message', 'my-class');
return back();
}
}
In your view you can do this:
@if(flash()->message)
<div class="{{ flash()->class }}">
{{ flash()->message }}
</div>
@endif
You can install the package via composer:
composer require spatie/laravel-flash
Here is an example on how to flash a message.
class MyController
{
public function store()
{
// …
flash('My message');
return back();
}
}
In your view you can use it like this
@if(flash()->message)
<div>
{{ flash()->message }}
</div>
@endif
You can add a class as the second parameter. This is typically used to style the output in your HTML.
class MyController
{
public function store()
{
// …
flash('My message', 'my-class'));
return back();
}
}
In your view you can use the class like this:
@if(flash()->message)
<div class="{{ flash()->class }}">
{{ flash()->message }}
</div>
@endif
You can also set an array of classes. These will be output by flash()->class
by imploding the array with a space-delimiter.
flash('My message', ['my-class', 'another-class'])); // flash()->class output is: 'my-class another-class'
If you don't want to specify a class each time you flash a message you can add a method name to flash
.
The easiest way is by passing an array to the levels
method. The key is the method name that should be added to flash()
. The value is the class that will automatically be used when rendering the message.
// this would probably go in a service provider
\Spatie\Flash\Flash::levels([
'success' => 'alert-success',
'warning' => 'alert-warning',
'error' => 'alert-error',
]);
The above example will make these methods available on flash
:
flash()->success('Hurray');
flash()->warning('Mayybeee');
flash()->error('Oh Oh');
Additionally, when you've added your own method, you can also pass that method name as a second parameter to flash
itself:
flash('Hurray', 'success'); // `flash()->class` will output 'alert-success'
You can also add a method to flash
by using macro
.
Here's an example:
// this would probably go in a service provider
use Spatie\Flash\Message;
\Spatie\Flash\Flash::macro('warning', function(string $message) {
return $this->flashMessage(new Message($message, 'alert alert-warning'));
});
You can now use a warning
method on flash
:
flash()->warning('Look above you!');
This package is intended to be lightweight. If you need things like multiple messages, support for Bootstrap, overlays, ... take a look at this excellent flash package by Jeffrey Way or Laraflash by Ilya Sakovich.
composer test
Please see CHANGELOG for more information on what has changed recently.
Please see CONTRIBUTING for details.
If you discover any security related issues, please email freek@spatie.be instead of using the issue tracker.
You're free to use this package, but if it makes it to your production environment we highly appreciate you sending us a postcard from your hometown, mentioning which of our package(s) you are using.
Our address is: Spatie, Samberstraat 69D, 2060 Antwerp, Belgium.
We publish all received postcards on our company website.
Spatie is a webdesign agency based in Antwerp, Belgium. You'll find an overview of all our open source projects on our website.
Does your business depend on our contributions? Reach out and support us on Patreon. All pledges will be dedicated to allocating workforce on maintenance and new awesome stuff.
The MIT License (MIT). Please see License File for more information.