README

PSR-15 中间件，用于使用 symfony/routing 组件并将路由属性存储在请求中。

要求

• PHP ^8.1
• PSR-7 http 库
• PSR-17 http 工厂

安装

此软件包可以通过 Composer 以 delolmo/symfony-router 的方式安装和自动加载。

composer require delolmo/symfony-router

您可能还想安装 php-http/discovery 以自动检测已知的 PSR-17 HTTP 工厂实现。

示例

考虑使用 Symfony 的 PhpFileLoader 从以下文件加载路由定义

# routes.php

use App\Controller\BlogController;
use Symfony\Component\Routing\RouteCollection;
use Symfony\Component\Routing\Route;

$routes = new RouteCollection();
$routes->add('blog_list', new Route('/blog', array(
    'request-handler' => [BlogController::class, 'list']
)));
$routes->add('blog_show', new Route('/blog/{slug}', array(
    'request-handler' => [BlogController::class, 'show']
)));

return $routes;

对于此示例，我们将使用 middlewares/utils 作为符合 PSR-15 的调度器。有关更多 PSR-15 实现，请参阅 链接。

此示例使用基本匿名函数来打印路由的属性

use Laminas\Diactoros\Response\HtmlResponse;
use Laminas\Diactoros\ServerRequest;
use Middlewares\Utils\Dispatcher;
use Middlewares\Utils\Factory;
use Symfony\Component\Config\FileLocator;
use Symfony\Component\Routing\Loader\PhpFileLoader;
use Symfony\Component\Routing\RequestContext;
use Symfony\Component\Routing\Router;

$fileLocator = new FileLocator(array(__DIR__));

$router = new Router(
    new PhpFileLoader($fileLocator),
    'routes.php',
    array('cache_dir' => __DIR__ . '/cache'),
    new RequestContext('/')
);

$factory = Factory::getRequestFactory();

$dispatcher = new Dispatcher([
    new DelOlmo\Middleware\SymfonyRouterMiddleware($router, $factory),
    function($request, $next) {
        return new HtmlResponse(json_encode($request->getAttributes()));
    }
]);

// Try matching a /blog request
$response = $dispatcher->dispatch(new ServerRequest([], [], '/blog'));

// Will return {"_route": "blog_list", "request-handler" => ["App\Controller\BlogController", "list"]}
$c->get('emitter')->emit($response);

// Try matching a /blog/hello-world request
$response = $dispatcher->dispatch(new ServerRequest([], [], '/blog/hello-world'));

// Will return {"_route": "blog_show", "request-handler" => ["App\Controller\BlogController", "show"], "slug" => "hello-world"}
$c->get('emitter')->emit($response);

选项

构造函数接受两个参数

__construct(
    \Symfony\Component\Routing\Router $router,
    \Psr\Http\Message\ResponseFactoryInterface $responseFactory
)

要使用的路由实例和创建错误响应（如 404 或 405）的 PSR-17 工厂。