## 路由 (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)
- 欢迎使用 MixPHP
- 安装说明
- 全栈开发
- 微服务开发
- Phar 开发
- 如何部署
- 独立部署
- Nginx
- Supervisord
- 新手教程
- 命令行常识
- 进程管理
- 热更新
- 全局变量
- 调试程序
- 入门须知
- 命名空间
- 自动加载
- 入口文件
- 增改应用
- 自动补全 IDE
- 核心功能
- 配置 (manifest.php)
- 依赖注入
- 事件调度
- 验证器
- 验证器定义
- 验证规则
- 静态调用
- 日志 Monolog
- 缓存
- 协程
- 什么是协程
- 开启协程
- Runtime
- 简介
- 创建协程 xgo + Channel
- 创建协程 xgo + WaitGroup
- xgo
- xdefer
- Channel
- WaitGroup
- Timer + Ticker
- Signal
- Select
- Context
- WorkerPool
- 数据库
- Database
- Database
- Connection
- QueryBuilder
- ExecutedEvent
- Redis
- Redis
- Connection
- CalledEvent
- 命令行
- 简介
- Application
- 创建命令
- 命令参数
- 打印与颜色
- 守护进程
- 后台运行
- Web/API 应用
- 简介
- 编写一个接口
- 服务器
- 路由 FastRoute
- 中间件
- 请求
- 响应
- 文件上传
- 控制器
- 视图
- Auth
- Session
- Guzzle
- HTTP 404/500
- 安全建议
- WebSocket 应用
- 简介
- 服务器
- 客户端
- Client
- JavaScript
- Swoole
- nginx代理
- 60s无消息断线
- Micro 微服务
- 简介
- 编写一个微服务
- Mix Micro
- Go Micro
- gRPC
- JSON-RPC
- 服务注册
- 配置中心
- 熔断与降级
- 调用链追踪
- 服务限流
- Sync Invoke 同步调用
- 简介
- 服务器
- 客户端
- TCP 应用
- 简介
- 服务器
- 客户端
- Telnet
- PHP
- Swoole
- UDP 应用
- 简介
- 服务器
- 客户端
- NC
- Swoole
- 第三方接入
- EasyWeChat
- Sentry
- Doctrine Cache
- 常见问题
- 如何利用 CPU 多核
- 连接多个数据库
- 如何设置跨域
- form-data 上传文件失败
- 输出大于 2M 的文件失败