Spiral Framework is compliant with PSR-7, PSR-15, and PSR-17 community standards; it allows you to swap HTTP layer
implementation for any alternative.
Note
By default,Psr\Http\Server\RequestHandlerInterfaceis implemented and bound toSpiral\Router\Router. You would have to disable the bootloaderSpiral\Bootloader\Http\RouterBootloaderin your application.
As an example, we can replace the default spiral router with one based on FastRoute. The implementation is provided by https://github.com/middlewares/fast-route.
composer require middlewares/fast-route middlewares/request-handler
Create a bootloader to bind this implementation to our http server. We can either bind a handler
via Spiral\Bootloader\Http\HttpBootloader or simply declare Psr\Http\Server\RequestHandlerInterface in SINGLETONS:
use FastRoute;
use Middlewares;
use Psr\Http\Message\ResponseFactoryInterface;
use Psr\Http\Server\RequestHandlerInterface;
use Spiral\Boot\Bootloader\Bootloader;
use Psr\Http\Message\ServerRequestInterface;
class FastRouteBootloader extends Bootloader
{
const SINGLETONS = [
RequestHandlerInterface::class => [self::class, 'psr15Handler']
];
private function createRoutes(FastRoute\RouteCollector $router): void
{
$router->addRoute('GET', '/hello/{name}', function (ServerRequestInterface $request) {
$name = $request->getAttribute('name');
return \sprintf('Hello %s', $name);
});
}
private function psr15Handler(ResponseFactoryInterface $responseFactory): RequestHandlerInterface
{
$dispatcher = FastRoute\simpleDispatcher(function (FastRoute\RouteCollector $r) {
$this->createRoutes($r);
});
return new Middlewares\Utils\Dispatcher([
new Middlewares\FastRoute($dispatcher, $responseFactory),
new Middlewares\RequestHandler(),
]);
}
}
Note
Make sure thatSpiral\Bootloader\Http\HttpBootloaderis enabled.
Add this Bootloader to your application, the route /name/{name} will be available immediately.
You can also implement your own handler. To save time, we will implement a handler directly in the bootloader:
use Psr\Http\Message\ResponseFactoryInterface;
use Psr\Http\Message\ResponseInterface;
use Psr\Http\Message\ServerRequestInterface;
use Psr\Http\Server\RequestHandlerInterface;
use Spiral\Boot\Bootloader\Bootloader;
class HttpHandlerBootloader extends Bootloader implements RequestHandlerInterface
{
const SINGLETONS = [
RequestHandlerInterface::class => self::class
];
private ResponseFactoryInterface $responseFactory;
public function __construct(ResponseFactoryInterface $responseFactory)
{
$this->responseFactory = $responseFactory;
}
public function handle(ServerRequestInterface $request): ResponseInterface
{
$response = $this->responseFactory->createResponse(200);
$response->getBody()->write("hello world");
return $response;
}
}
Note
You can find a lot of open-source routers that implement this interface.