Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/burzum/fast-route-middleware
A convenient and strict typed Fast Route middleware implementation.
https://github.com/burzum/fast-route-middleware
dispatcher fast-route middleware php7 psr psr-15 routes routing
Last synced: about 2 months ago
JSON representation
A convenient and strict typed Fast Route middleware implementation.
- Host: GitHub
- URL: https://github.com/burzum/fast-route-middleware
- Owner: burzum
- License: other
- Created: 2018-08-18T20:36:57.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2019-12-05T21:46:10.000Z (about 5 years ago)
- Last Synced: 2024-10-13T12:43:54.790Z (3 months ago)
- Topics: dispatcher, fast-route, middleware, php7, psr, psr-15, routes, routing
- Language: PHP
- Size: 29.3 KB
- Stars: 2
- Watchers: 2
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: readme.md
- License: LICENSE
Awesome Lists containing this project
README
# Fast Route PSR 15 Middleware
[](LICENSE)
[](https://scrutinizer-ci.com/g/burzum/fast-route-psr15-middleware/)
[](https://scrutinizer-ci.com/g/burzum/fast-route-psr15-middleware/)
A convenient and strict typed Fast Route middleware.
## How to use it
Fast Routes result will be an array of which the first key represent the kind of result. Fast Route knows three different cases so far:
1. Route found
2. Route not found
3. Route not allowed
The middleware deals with getting this result for you from Fast Route but you'll have to to define your handlers, because this is up to you and your application. The middleware takes an object that needs to implement an interface specific to each time.
You **must** create at least the found handler! Each kind of handler must implement the according interface. The other two handlers are optional!
```php
// Route was found and matched the URL
class MyFoundHandler implements FoundHandlerInterface
{
public function handle(ServerRequestInterface $request, $handler, array $vars): ?ResponseInterface
{
// Handle the request and return null or a response object
// Dispatch your controllers or request handlers here based on the route vars
}
}
// Route was not found, URL didn't match
class MyNotFoundHandler implements NotFoundHandlerInterface
{
public function handle(ServerRequestInterface $request): ?ResponseInterface
{
// Handle the request and return null or a response object
// Dispatch your controllers or request handlers here
}
}
// Route was found but is not allowed to be accessible
class MyNotAllowedHandler implements NotAllowedHandlerInterface
{
public function handle(ServerRequestInterface $request, array $notAllowedMethods): ?ResponseInterface
{
// Handle the request and return null or a response object
// Dispatch your controllers or request handlers here
}
}
```
Then configure the middleware. You **must** pass a FoundHandler the other two are optional!
Check the [FastRoute documentation](https://github.com/nikic/FastRoute) for how to configure FastRoutes dispatcher and it's routes.
```php
$dispatcher = SimpleDispatcher(function(RouteCollector $r) {
// Your routes...
});
$fastRouteMiddleware = new FastRouteMiddleware(
$dispatcher,
new MyFoundHandler(),
new MyNotFoundHandler(),
new MyNotAllowedHandler()
);
// Pass the middleware to your middleware handler implementation
```
## License
MIT License
Copyright (c) 2018 by Florian Krämer.