https://github.com/slimphp/Slim-Flash
Slim Framework flash messages service provider
https://github.com/slimphp/Slim-Flash
Last synced: 6 months ago
JSON representation
Slim Framework flash messages service provider
- Host: GitHub
- URL: https://github.com/slimphp/Slim-Flash
- Owner: slimphp
- License: mit
- Created: 2015-04-01T18:43:46.000Z (over 10 years ago)
- Default Branch: master
- Last Pushed: 2022-02-10T09:41:16.000Z (almost 4 years ago)
- Last Synced: 2024-05-18T04:41:12.453Z (over 1 year ago)
- Language: PHP
- Size: 611 KB
- Stars: 149
- Watchers: 16
- Forks: 36
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE.md
Awesome Lists containing this project
- awesome-slim - Slim Flash - Slim Framework flash messages service provider. (Miscellaneous)
README
# Slim Framework Flash Messages
[](https://travis-ci.org/slimphp/Slim-Flash)
This repository contains a Slim Framework Flash messages service provider. This enables you to define transient messages that persist only from the current request to the next request.
## Install
Via Composer
``` bash
$ composer require slim/flash
```
Requires Slim 3.0.0 or newer.
## Usage
### Slim 4
This example assumes that you have `php-di/php-di` installed.
```php
addDefinitions(
[
'flash' => function () {
$storage = [];
return new Messages($storage);
}
]
);
AppFactory::setContainer($containerBuilder->build());
$app = AppFactory::create();
// Add session start middleware
$app->add(
function ($request, $next) {
// Start PHP session
if (session_status() !== PHP_SESSION_ACTIVE) {
session_start();
}
// Change flash message storage
$this->get('flash')->__construct($_SESSION);
return $next->handle($request);
}
);
$app->addErrorMiddleware(true, true, true);
// Add routes
$app->get(
'/',
function ($request, $response) {
// Set flash message for next request
$this->get('flash')->addMessage('Test', 'This is a message');
// Redirect
$url = RouteContext::fromRequest($request)->getRouteParser()->urlFor('bar');
return $response->withStatus(302)->withHeader('Location', $url);
}
);
$app->get(
'/bar',
function ($request, $response) {
$flash = $this->get('flash');
// Get flash messages from previous request
$messages = $flash->getMessages();
print_r($messages);
// Get the first message from a specific key
$test = $flash->getFirstMessage('Test');
print_r($test);
return $response;
}
)->setName('bar');
$app->run();
```
### Slim 3
```php
// Start PHP session
session_start();
$app = new \Slim\App();
// Fetch DI Container
$container = $app->getContainer();
// Register provider
$container['flash'] = function () {
return new \Slim\Flash\Messages();
};
$app->get('/foo', function ($req, $res, $args) {
// Set flash message for next request
$this->flash->addMessage('Test', 'This is a message');
// Redirect
return $res->withStatus(302)->withHeader('Location', '/bar');
});
$app->get('/bar', function ($req, $res, $args) {
// Get flash messages from previous request
$messages = $this->flash->getMessages();
print_r($messages);
// Get the first message from a specific key
$test = $this->flash->getFirstMessage('Test');
print_r($test);
});
$app->run();
```
> Please note that a message could be a string, object or array. Please check what your storage can handle.
### Using with Twig-View
If you use [Twig-View](https://github.com/slimphp/Twig-View), then [slim-twig-flash](https://github.com/kanellov/slim-twig-flash) may be a useful integration package.
## Testing
``` bash
$ phpunit
```
## Contributing
Please see [CONTRIBUTING](CONTRIBUTING.md) for details.
## Security
If you discover any security related issues, please email security@slimframework.com instead of using the issue tracker.
## Credits
- [Josh Lockhart](https://github.com/codeguy)
- [All Contributors](../../contributors)
## License
The MIT License (MIT). Please see [License File](LICENSE.md) for more information.