Download the PHP package amphp/http-server-router without Composer
On this page you can find all versions of the php package amphp/http-server-router. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download amphp/http-server-router
More information about amphp/http-server-router
Files in amphp/http-server-router
Package http-server-router
Short Description Routes to request handlers based on HTTP method and path for amphp/http-server.
License MIT
Homepage https://github.com/amphp/http-server-router
Informations about the package http-server-router
http-server-router
AMPHP is a collection of event-driven libraries for PHP designed with fibers and concurrency in mind.
This package provides a routing RequestHandler
for amphp/http-server
based on the request path and method using FastRoute.
Installation
This package can be installed as a Composer dependency.
You should specify amphp/http-server
as a separate dependency.
Usage
Router
implements RequestHandler
, which is used by an HttpServer
to handle incoming requests. Incoming requests are routed by Router
to other RequestHandler
s based on the request path.
Routes can be defined using the addRoute($method, $uri, $requestHandler)
method.
Matched route arguments are available in the request attributes under the Amp\Http\Server\Router
key as an associative array.
Please read the FastRoute documentation on how to define placeholders.
Middleware
You can stack all routes with a common set of middleware using addMiddleware($middleware)
.
Each middleware is called in the order of the addMiddleware()
calls.
The router will not invoke any middleware for the fallback handler.
Note Per-route middleware can be added by using
Amp\Http\Server\Middleware\stackMiddleware()
before passing theRequestHandler
toaddRoute()
.
Fallback
If no routes match a request path, you can specify another instance of RequestHandler
which will handle any unmatched routes. If no fallback handler is provided, a 404 response will be returned using the instance of ErrorHandler
provided to the Router
constructor.
Note Middleware defined by
Router::addMiddleware()
will not be invoked when a request is forwarded to fallback handler. UseAmp\Http\Server\Middleware\stackMiddleware()
to wrap the fallback request handler with any middlewares needed first.
Example
A full example is found in examples/hello-world.php
.
Limitations
The Router
will decode the URI path before matching.
This will also decode any forward slashes (/
), which might result in unexpected matching for URIs with encoded slashes.
FastRoute placeholders match path segments by default, which are separated by slashes.
That means a route like /token/{token}
won't match if the token contains an encoded slash.
You can work around this limitation by using a custom regular expression for the placeholder like /token/{token:.+}
.
Security
If you discover any security related issues, please use the private security issue reporter instead of using the public issue tracker.
License
The MIT License (MIT). Please see LICENSE for more information.
All versions of http-server-router with dependencies
amphp/amp Version ^3
amphp/cache Version ^2
amphp/http Version ^2
amphp/http-server Version ^3
amphp/socket Version ^2
nikic/fast-route Version ^1
psr/log Version ^1|^2|^3