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