## 路由 (Fast Route) 使用经过改造后 [Fast-Route](https://github.com/nikic/FastRoute) 作为路由组件,改造后支持 Mix 系列的全部功能。 ## 组件 使用 [composer]([https://www.phpcomposer.com/](https://www.phpcomposer.com/)) 安装: ~~~ composer require mix/fast-route ~~~ ## 依赖注入配置 - [manifest/beans/route.php](https://github.com/mix-php/mix-skeleton/blob/master/manifest/beans/route.php) ## 路由调用 路由类是在 StartCommand::class 中使用的,因此用户可随意修改执行逻辑,具体调用方式如下: ~~~ $routeDefinitionCallback = function (Mix\FastRoute\RouteCollector $collector) { $collector->get('/profile/{id:\d+}', [\App\Web\Controllers\ProfileController::class, 'index'], [\App\Web\Middleware\ActionMiddleware::class] ); }; $globalMiddleware = [\App\Web\Middleware\GlobalMiddleware::class]; $router = new \Mix\FastRoute\Router($routeDefinitionCallback, $globalMiddleware); $server = new \Mix\Http\Server\Server('0.0.0.0', 9502); $server->start($router); ~~~ ## 文件加载路由 除了上面的使用闭包加载路由,还可以选择把闭包写到一个或者多个文件中来拆分路由。 ~~~ // 路径可以是单个文件,也可以是目录 $path = sprintf('%s/routes/api.php', app()->basePath); $router = new \Mix\FastRoute\Router($path, $globalMiddleware); ~~~ - 也可以在依赖配置中注入路径:[manifest/beans/route.php#L12](https://github.com/mix-php/mix-skeleton/blob/master/manifest/beans/route.php#L12) ## 路由规则 >[danger] 注意:Mix 并不支持 TP 那种默认路由规则 `http://yourdomain/Module/Controller/Action`,每个路由都需要自己去配置 该组件采用闭包的形式定义路由,例如: ~~~php function (Mix\FastRoute\RouteCollector $collector) { // 单个,支持 get | post | put | delete | patch | head | options $collector->get('/profile/{id:\d+}', [\App\Web\Controllers\ProfileController::class, 'index'], [\App\Web\Middleware\ActionMiddleware::class] ); // 全部 // >= v2.2.9 $collector->any('/profile/{id:\d+}', [\App\Web\Controllers\ProfileController::class, 'index'], [\App\Web\Middleware\ActionMiddleware::class] ); // 自定义多个 // >= v2.2.9 $collector->match(['GET', 'OPTIONS'], '/profile/{id:\d+}', [\App\Web\Controllers\ProfileController::class, 'index'], [\App\Web\Middleware\ActionMiddleware::class] ); // 使用闭包自定义执行控制器 $collector->match(['GET', 'OPTIONS'], '/profile/{id:\d+}', function (\Mix\Http\Message\ServerRequest $request, \Mix\Http\Message\Response $response) { return call_user_func([new \App\Web\Controllers\ProfileController(), 'index'], $request, $response); }, [\App\Web\Middleware\ActionMiddleware::class] ); } ~~~ 规则详解: - ` /profile/{id:\d+}` 匹配的 url 规则 - `[\App\Web\Controllers\ProfileController::class, 'index']` 匹配后执行的方法,callable 类型 - `[\App\Web\Middleware\ActionMiddleware::class]` 该路由的中间件 通过 `Mix\Http\Message\ServerRequest` 获取变量值: ~~~php $id = $request->getAttribute('id'); ~~~ 更多规则请查看: - [https://github.com/nikic/FastRoute](https://github.com/nikic/FastRoute)