自定义路由

easySwoole支持路由拦截。其路由利用fastRoute实现,因此其路由规则与其保持一致,该组件的详细文档请参考 GitHub文档

使用指导

若需要在asySwoole使用自定义路由拦截功能,请在应用目录的Http控制器目录下(默认为HttpController)下,建立Router类,
井继承\EasySwoole\Core\Http\AbstractInterface\Router实现register方法,如果在类UNIX系统下请严格注意文件名的大小写,如果获取不到该类则会跳过路由检测,进行框架内置的URL解析。

示例代码

Index控制器

  1. namespace App\HttpController;
  2. use EasySwoole\Core\Http\AbstractInterface\Controller;
  3. class Index extends Controller
  4. {
  5. function index()
  6. {
  7. // TODO: Implement index() method.
  8. $this->response()->write('this is controller index');
  9. }
  10. protected function onRequest($action): ?bool
  11. {
  12. return parent::onRequest($action); // TODO: Change the autogenerated stub
  13. }
  14. function test()
  15. {
  16. $this->response()->write('this is controller test');
  17. }
  18. function test2(){
  19. $this->response()->write('this is controller test2 and your id is '.$this->request()->getRequestParam('id'));
  20. }
  21. }

Router

  1. namespace App\HttpController;
  2. use EasySwoole\Core\Http\Request;
  3. use EasySwoole\Core\Http\Response;
  4. use FastRoute\RouteCollector;
  5. class Router extends \EasySwoole\Core\Http\AbstractInterface\Router
  6. {
  7. function register(RouteCollector $routeCollector)
  8. {
  9. // TODO: Implement register() method.
  10. // /
  11. $routeCollector->get('/',function (Request $request ,Response $response){
  12. $response->write('this router index');
  13. });
  14. // /test/index.html
  15. $routeCollector->get('/test',function (Request $request ,Response $response){
  16. $response->write('this router test');
  17. $response->end();
  18. });
  19. // /user/1/index.html
  20. $routeCollector->get( '/user/{id:\d+}',function (Request $request ,Response $response,$id){
  21. $response->write("this is router user ,your id is {$id}");
  22. $response->end();
  23. });
  24. //传递给 /index控制器 test2方法
  25. $routeCollector->get( '/user2/{id:\d+}','/test2');
  26. }
  27. }

注意:若在路由回调函数中不结束该请求响应,则该次请求将会继续进行Dispatch并尝试寻找对应的控制器进行响应处理。

addRoute方法

定义路由的addRoute方法原型如下,该方法需要三个参数,下面围绕这三个参数我们对路由组件进行更深一步的了解

  1. $routeCollector->addRoute($httpMethod, $routePattern, $handler)

httpMethod


该参数需要传入一个大写的HTTP方法字符串,指定路由可以拦截的方法,单个方法直接传入字符串,需要拦截多个方法可以传入一个一维数组,如下面的例子:

  1. // 拦截GET方法
  2. $routeCollector->addRoute('GET', '/router', '/Index');
  3. // 拦截POST方法
  4. $routeCollector->addRoute('POST', '/router', '/Index');
  5. // 拦截多个方法
  6. $routeCollector->addRoute(['GET', 'POST'], '/router', '/Index');

routePattern


传入一个路由匹配表达式,符合该表达式要求的路由才会被拦截并进行处理,表达式支持{参数名称:匹配规则}这样的占位符匹配,用于限定路由参数

基本匹配

下面的定义将会匹配 http://localhost:9501/users/info

  1. $routeCollector->addRoute('GET', '/users/info', 'handler');

绑定参数

下面的定义将/users/后面的部分作为参数,并且限定参数只能是数字[0-9]

  1. // 可以匹配: http://localhost:9501/users/12667
  2. // 不能匹配: http://localhost:9501/users/abcde
  3. $routeCollector->addRoute('GET', '/users/{id:\d+}', 'handler');

下面的定义不做任何限定,仅将匹配到的URL部分获取为参数

  1. // 可以匹配: http://localhost:9501/users/12667
  2. // 可以匹配: http://localhost:9501/users/abcde
  3. $routeCollector->addRoute('GET', '/users/{name}', 'handler');

有时候路由的部分位置是可选的,可以像下面这样定义

  1. // 可以匹配: http://localhost:9501/users/to
  2. // 可以匹配: http://localhost:9501/users/to/username
  3. $routeCollector->addRoute('GET', '/users/to[/{name}]', 'handler');

获取路由中绑定的参数有两种情况

  1. handler传入了一个闭包,Dispatch会将绑定的参数按顺序传给闭包
  2. handler传入了一个控制器路径,Dispatch会将绑定的参数附加给Request对象

利用该方法还可以实现请求/router/fun1/{id:\d+}但是符合一定条件的请求需要分发给/router/fun2/{id:\d+}处理的情况

  1. // 在闭包中使用
  2. $routeCollector->addRoute('GET', '/router/{id:\d+}', function ($id) {
  3. $Response = Response::getInstance();
  4. $Response->write('Userid : ' . $id);
  5. $Response->end();
  6. });
  7. // --------------------------------------------------------
  8. // 直接调用控制器方法
  9. $routeCollector->addRoute('POST', '/router/{id:\d+}', '/Index');
  10. // 此时可以在控制器中调用Request对象存放的参数
  11. $id = $this->request()->getQueryParam('id');
  12. // --------------------------------------------------------
  13. // 绑定参数并跳转到控制器
  14. $routeCollector->addRoute('GET', '/router2/{id:\d+}', function ($id) {
  15. // 将请求参数附加到Request
  16. Request::getInstance()->withQueryParams(['id' => $id]);
  17. // 按自己的处理逻辑转发请求给控制器
  18. Response::getInstance()->forward('/Index');
  19. });

handler


指定路由匹配成功后需要处理的方法,可以传入一个闭包,当传入闭包时一定要注意处理完成之后要处理结束响应否则请求会继续Dispatch寻找对应的控制器来处理,当然如果利用这一点,也可以对某些请求进行处理后再交给控制器执行逻辑

  1. // 传入闭包的情况
  2. $routeCollector->addRoute('GET', '/router/{id:\d+}', function ($id) {
  3. $Response = Response::getInstance();
  4. $Response->write('Userid : ' . $id);
  5. $Response->end();
  6. });

也可以直接传入控制器路径

  1. $routeCollector->addRoute('GET', '/router2/{id:\d+}', '/Index');

更多使用详情请直接查看FastRouter。