Download the PHP package jasny/session-middleware without Composer
On this page you can find all versions of the php package jasny/session-middleware. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download jasny/session-middleware
More information about jasny/session-middleware
Files in jasny/session-middleware
Package session-middleware
Short Description PSR-15 session middleware with support for mock sessions
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 session-middleware
Session middleware
Using superglobals like $_SESSION object makes it difficult to test an application as global variables can have
unexpected side effects. Using superglobals undermines the effort of using dependency injection and using containers.
The middleware creates an object that wraps $_SESSION, which is available for dependency injection and as attribute
of the PSR-7 ServerRequest. The middleware complies with PSR-15. It will also
work as double pass middleware.
Installation
composer require jasny/session-middlewareUsage
Get the session object from the PSR-7 ServerRequest object and use it as array
The session is started by the middleware.
Methods
The session object implements SessionInterface and has the following methods;
start()- Start the session.status()- Get the session status.stop()- Write session data and end session.abort()- Discard session array changes and finish session.clear()- Clear all data from the session.kill()- Destroy the session and remove the session cookie.rotate()- Delete the current session and start a new one.
When rotating a session, it's possible to copy some of the data by supplying a callback.
Session options
By default, the middleware will create a GlobalSession object. This object is linked to PHPs session management including
$_SESSION. You can manually instantiate this object, supplying session options. These options are passed to
session_start().
Flash
The session flash object can be used to pass a message to the next request. It is automatically removed from the session after it is used. A typical use case is to store information in a database, than redirect to a page and showing a success message. Or if the information could not be saved, to show an error message.
The flash information contains a type (e.g. success, error, info, warning) and a message. Optionally a
content type can be specified for the message. This defaults to text/plain.
In the next request
If flash() or flashes() is called, the flash messages are cleared from the session. To prevent this call
reissue()
Call $session->flashes()->clear() to explicly clear all flash messages, both newly added (to the session) and those
available for the current request.
Testing
When running tests, you can injecting a MockSession object in the server request before passing it to the middleware.
Alternatively you can pass a session object when creating the SessionMiddleware. This session object will be used
instead of the global session.
