路由
最后更新于：2022-04-02 07:05:50
## 路由
路由是 MixPHP 的核心组件之一，秉承极简理念，底层使用正则构建，好用又简单，并且可独立使用。
## 组件
使用 [composer]([https://www.phpcomposer.com/](https://www.phpcomposer.com/)) 安装：
~~~
composer require mix/route
~~~
## 依赖注入配置
- [beans/route.php](https://github.com/mix-php/mix-skeleton/tree/v2.1/manifest/beans/route.php)
### 路由规则
>[danger] 注意：Mix 并不支持 TP 那种默认路由规则 `http://yourdomain/Module/Controller/Action`，每个路由都需要自己去配置
路由规则在 rules 字段内定义，例如：
~~~php
// 路由规则
'rules' => [
// 普通路由
'/' => [[\App\Http\Controllers\IndexController::class, 'index'], 'middleware' => [\App\Http\Middleware\ActionMiddleware::class]],
'/profile/{id}' => [[\App\Http\Controllers\ProfileController::class, 'index'], 'middleware' => [\App\Http\Middleware\ActionMiddleware::class]],
'POST /file/upload' => [[\App\Http\Controllers\FileController::class, 'upload'], 'middleware' => [\App\Http\Middleware\ActionMiddleware::class]],
// 分组路由
'/v2' => [
// 分组中间件
'middleware' => [\App\Http\Middleware\GroupMiddleware::class],
// 分组路由规则
'rules' => [
// 分组路由
'POST /user/create' => [[\App\Http\Controllers\UserController::class, 'create'], 'middleware' => [\App\Http\Middleware\ActionMiddleware::class]],
],
],
],
~~~
规则详解：
- ` '/profile/{id}'` 匹配的 url 规则
- `[\App\Http\Controllers\ProfileController::class, 'index']` 匹配后执行的方法，callable 类型
- `'middleware'` 该路由的中间件
- `'/v2'` 分组路由的 url 前缀，匹配 /v2/user/create
- `'POST /file/upload'` 前面的 POST 定义限制的请求方法，可定义多个，如：GET|POST
### RESTful 路由规则
框架支持的全部请求方法如下：
~~~
GET|POST|PUT|PATCH|DELETE|OPTIONS|HEAD|TRACE
~~~
通过HTTP请求方法匹配，能够很简单的构建出 `RESTful` 风格。
~~~php
// 路由规则
'rules' => [
'GET /user' => [[\App\Http\Controllers\UserController::class, 'index']],
'POST /user' => [[\App\Http\Controllers\UserController::class, 'save']],
'GET /user/{id}' => [[\App\Http\Controllers\UserController::class, 'read']],
'PUT /user/{id}' => [[\App\Http\Controllers\UserController::class, 'update']],
'DELETE /user/{id}' => [[\App\Http\Controllers\UserController::class, 'delete']],
],
~~~
### 路由变量
上一节中 `{id}` 就是路由变量，下面演示一下普通变量的使用：
~~~php
// 路由规则
'rules' => [
'GET /user/{id}.html' => [[\App\Http\Controllers\UserController::class, 'read']],
],
~~~
匹配的URL与指向的功能如下：
| URL | 控制器::方法 |
| --- | --- |
| http://site.com/user/123456.html | \App\Http\Controllers\UserController::read |
代码中可以通过 `Mix\Http\Message\ServerRequest` 获取变量值：
~~~php
$id = $request->getAttribute('id');
~~~
### 路由变量规则
路由变量也是可以定义规则的，规则是正则表达式，在 `patterns` 字段内定义。
>[info] 定义了变量规则后，当变量所在URL段不符合规则时，框架会抛出 404 错误。
### 默认变量规则
如果你没有为变量定义规则，默认为 `defaultPattern` 字段内定义的规则，如果你连 `defaultPattern` 也没有定义，则默认为 `[\w-]+`。
## 路由调用
路由类是在 StartCommand::class 中使用的，因此用户可随意修改执行逻辑，具体调用方式如下：
[>> \App\Web\Commands\StartCommand::class <<](https://github.com/mix-php/mix-skeleton/tree/v2.1/app/Web/Commands/StartCommand.php#L87)
';