php 路由 fast route,路由 FastRoute

## 路由 (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)