定义方式定义格式
方式1:路由到模块/控制器'[模块/控制器/操作]?额外参数1=值1&额外参数2=值2…'
方式2:路由到重定向地址'外部地址'(默认301重定向) 或者 ['外部地址','重定向代码']
方式3:路由到控制器的方法'@[模块/控制器/]操作'
方式4:路由到类的方法'\完整的命名空间类::静态方法' 或者 '\完整的命名空间类@动态方法'
方式5:路由到闭包函数闭包函数定义(支持参数传入)

其中方式5我们将会在下一个章节闭包支持中详细描述。

这是最常用的一种路由方式,把满足条件的路由规则路由到相关的模块、控制器和操作,然后由App类调度执行相关的操作。

同时会进行模块的初始化操作(包括配置读取、公共文件载入、行为定义载入、语言包载入等等)。

路由地址的格式为:

解析规则是从操作开始解析,然后解析控制器,最后解析模块,例如:

Blog类定义如下:

  1. class Blog {
  2. public function read($id){
  3. return 'read:'.$id;
  4. }

路由地址中支持多级控制器,使用下面的方式进行设置:

  1. 'blog/:id'=>'index/group.blog/read'

表示路由到下面的控制器类,

  1. index/controller/group/Blog

Blog类定义如下:

  1. namespace app\index\controller\group;
  2. class Blog {
  3. return 'read:'.$id;
  4. }
  5. }

在这种方式路由跳转的时候支持额外传入参数对(额外参数指的是不在URL里面的参数,隐式传入需要的操作中,有时候能够起到一定的安全防护作用,后面我们会提到)。例如:

  1. 'blog/:id'=>'blog/read?status=1&app_id=5',

上面的路由规则定义中额外参数statusapp_id参数都是URL里面不存在的,属于隐式传值,当然并不一定需要用到,只是在需要的时候可以使用。

路由地址的格式为:

这种方式看起来似乎和第一种是一样的,本质的区别是直接执行某个控制器类的方法,而不需要去解析 模块/控制器/操作这些,同时也不会去初始化模块。例如,定义如下路由后:

  1. 'blog/:id'=>'@index/blog/read',

系统会直接执行

    相当于直接调用 \app\index\controller\blog类的read方法。

    Blog类定义如下:

    1. namespace app\index\controller;
    2. class Blog {
    3. return 'read:'.$id;
    4. }
    5. }

    通常这种方式下面,由于没有定义当前模块名、当前控制器名和当前方法名 ,从而导致视图的默认模板规则失效,所以这种情况下面,如果使用了视图模板渲染,则必须传入明确的参数。

    路由地址的格式为(动态方法):

    这种方式更进一步,可以支持执行任何类的方法,而不仅仅是执行控制器的操作方法,例如:

    执行的是 \app\index\service\Blog类的read方法。也支持执行某个静态方法,例如:

    1. 'blog/:id'=>'\app\index\service\Blog::read',

    V5.0.4+版本开始,支持传入额外的参数作为方法的参数调用(用于参数绑定),例如:

    1. 'blog/:id'=>'\app\index\service\Blog::read?status=1',

    重定向的外部地址必须以“/”或者http开头的地址。

    如果路由地址以“/”或者“http”开头则会认为是一个重定向地址或者外部地址,例如:

    1. 'blog/:id'=>'/blog/read/id/:id'

    1. 'blog/:id'=>'blog/read'

    虽然都是路由到同一个地址,但是前者采用的是301重定向的方式路由跳转,这种方式的好处是URL可以比较随意(包括可以在URL里面传入更多的非标准格式的参数),而后者只是支持模块和操作地址。举个例子,如果我们希望avatar/123重定向到/member/avatar/id/123_small的话,只能使用:

    路由地址采用重定向地址的话,如果要引用动态变量,直接使用动态变量即可。

    采用重定向到外部地址通常对网站改版后的URL迁移过程非常有用,例如: