overtrue / laravel-stateless-session
A lightweight middleware to make api routing session capable.
Installs: 6 107
Dependents: 0
Suggesters: 0
Security: 0
Stars: 18
Watchers: 3
Forks: 1
Open Issues: 0
Requires
- laravel/framework: ^9.0
Requires (Dev)
- friendsofphp/php-cs-fixer: ^3.0
- jetbrains/phpstorm-attributes: ^1.0
- mockery/mockery: ^1.4.4
- orchestra/testbench: ^7.0
- phpunit/phpunit: ^9.5.8
This package is auto-updated.
Last update: 2024-10-14 12:27:26 UTC
README
A lightweight middleware to make api routing session capable.
Installing
$ composer require overtrue/laravel-stateless-session -vvv
Usage
Add the middleware (\Overtrue\LaravelStatelessSession\Http\Middleware\SetSessionFromHeaders
) to api route group.
protected $middlewareGroups = [ //... 'api' => [ \Overtrue\LaravelStatelessSession\Http\Middleware\SetSessionFromHeaders::class, \Illuminate\Session\Middleware\StartSession::class, 'throttle:api', \Illuminate\Routing\Middleware\SubstituteBindings::class, ], ];
Response header
This middleware will set session id to response headers with name 'x-session', if you want to update the header name, you can add header
to config/session.php
:
config/session.php
'header' => 'x-session',
Request header
The api request must set the last session id to headers. Using axios as an example, we need to listen to the api response, retrieve the session ID from response headers and store it in local storage, then retrieve it and add it to the request header:
axios.interceptors.request.use(function (config) { config.headers['x-session'] = 'session id from your localstorage'; return config; }, function (error) { return Promise.reject(error); }); // Store the response session id axios.interceptors.response.use(function (response) { if (response.headers['x-session']) { // store session id to localstorage } return response; }, function (error) { return Promise.reject(error); });
Contributing
You can contribute in one of three ways:
- File bug reports using the issue tracker.
- Answer questions or fix bugs on the issue tracker.
- Contribute new features or update the wiki.
The code contribution process is not very formal. You just need to make sure that you follow the PSR-0, PSR-1, and PSR-2 coding guidelines. Any new code contributions must be accompanied by unit tests where applicable.
Project supported by JetBrains
Many thanks to Jetbrains for kindly providing a license for me to work on this and other open-source projects.
PHP 扩展包开发
想知道如何从零开始构建 PHP 扩展包?
请关注我的实战课程,我会在此课程中分享一些扩展开发经验 —— 《PHP 扩展包实战教程 - 从入门到发布》
License
MIT