Download the PHP package lukebro/flash without Composer
On this page you can find all versions of the php package lukebro/flash. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download lukebro/flash
More information about lukebro/flash
Files in lukebro/flash
Package flash
Short Description Magical flash notifications in Laravel 5.*
License MIT
FAQ
Example:
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
- Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
- To use Composer is sometimes complicated. Especially for beginners.
- Composer needs much resources. Sometimes they are not available on a simple webspace.
- If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
- Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Informations about the package flash
Magical flash notifications in Laravel 5. & 6.
A simple magical API for flashing notifications to a session inside Laravel 5.*.
Installation
Requires PHP 5.5.9, Laravel 5. & 6. and Composer.
Add the following line to the require block of your composer.json file:
Run composer install or composer update.
Include the service provider within \config\app.php:
Add the facade alias at the bottom of the same file:
Usage
Flashing notifications
Before redirecting, flash a message to the screen:
Inside your view's you have access to a flash()->level and flash()->message attribute.
The level attribute is the name of the function you called, which could be anything.
The message attribute is the string you passed into the magical function.
So for the example above, flash()->level and flash()->message would equal warning and Max file size is 5MB. respectively.
A flash message is not required, calling just a method will result in just the level being flashed.
You also have access to a Flash facade which you could use in place of the flash() helper function.
Flashing multiple notifications
You can chain your flashes like so:
Inside your views flash()->level and flash()->message attributes will return the level and message of the last message flashed. To get a Collection of all messages flashed you have access to flash()->all().
So for example to iterate through all messages flashed inside your view:
flash()->all() returns Laravel's Collection class, so you have access to all methods Collection contains such as groupBy(), chunk(), toJson(), etc. It could also just be treated as an array.
Detecting flash notifications
To detect if any flash messages exist in the session, use flash()->exists().
If you want to detect a specific level, use the has() method. E.g. flash()->has('error'). This works for single or multiple flashed messages.
It's best use to detect if a certain level was flashed and then display only the notifications of that level using the get() method.
Reflashing notifications
To reflash notification or all notifications to the next request use the function again().
You're able to flash more messages before, or after calling the flash()->again() method.
Helper function
You may also just pass a level and a message into the flash() helper function.
Single vs Multiple Flashes
Depending on what your application needs, set up your views to display flashes using a loop or just the attributes. For example if your application is only going to flash one notification at a time, using flash()->level and flash()->message directly in your views is fine.
However, if your application will flash multiple notifications it's best to set up a foreach loop and iterate over flash()->all(). Again you'll still have direct access to the flash()->level and flash()->message attributes even if multiple notifications were flashed, but there values will be of the last notification flashed.
Examples
Below are some basic blade templates/examples.
Single flash example
Multiple flash example
Detecting a specific level
Detecting a specific level and displaying multiple messages
Details
The data is stored inside Laravel's session under the key flashes in the following format:
flash()->all() returns a Collection of Flash object. A flash object contains two attributes: level, and message which are publicly accessable. You may also access them via array syntax as such: $flash['level'] and $flash['message']. A Flash object has a toArray() and toJson() method.
Contributions
Feel free to create an issue with a feature request or bug report. If you would rather implement the feature or fix the bug yourself, create a pull request. I'm not sure how far I want to take this package, as of right now I'm pretty happy where it stands.
Contributions can be made to the documentation as well, not just code. If you think you can explain the API better than I can, please do and I'll be happy to merge it in.
I'd love to hear your feedback in how the package feels and what you don't like about it.
Credits
The inspiration for this extremely small package comes from Jeffrey Way's Laracast video: Elegant Flash Messaging. Definitely check it out. Jeffrey mentions that you could write the API in a "magical" way, so I thought it would be cool to implement.
License
The MIT License (MIT). Please see License File for more information.
