FlashMessage

A simple PHP container for passing session (flash) messages between page redirects., _(*1)

Installation

Install the FlashMessage package via Composer:, _(*2)

composer require thecodemill/flash-message

Usage

FlashMessage is used to make messages of 4 different statuses:, _(*3)

INFO
SUCCESS
WARNING
DANGER

A message can be created by instantiating a new TheCodeMill\FlashMessage\Message class, with the appropriate arguments:, _(*4)

use TheCodeMill\FlashMessage\Message;

$message = new Message('The problem with the gene pool is there’s no lifeguard', Message::STATUS_INFO);

Alternatively, static helper methods are available to automatically generate a message of each particular status:, _(*5)

use TheCodeMill\FlashMessage\Message;

// Info
$info = Message::info('I have noticed something strange.');

// Warning
$warning = Message::warning('This could be a problem.');

// Danger
$danger = Message::danger('Yes, it was definitely a problem.');

// Success
$success = Message::success('All fixed!');

These messages can then be passed into session storage and flashed between page redirects., _(*6)

Here's a Laravel example:, _(*7)

Route::post('/submit', function () {
    // Do something
    // ...

    // Now redirect
    return redirect('/success')
        ->with('message', Message::success('Thanks for submitting.'));
});

To output the message, we may use the content() and status() methods on the Message object., _(*8)

Note: You may notice that the status types tie in nicely with Bootstrap's default types., _(*9)

Here's another Laravel Blade example:, _(*10)

@if($message = session('message'))
    <div class="alert alert-{{ strtolower($message->status()) }} alert-dismissible" role="alert">
        <button type="button" class="close" data-dismiss="alert">
            <span>&times;</span>
            <span class="sr-only">Close</span>
        </button>

        {{ $message->content() }}
    </div>
@endif