Eyoucms程序开发:路由地址
路由地址定义
版本 | 新增功能 |
---|---|
5.0.4 | 路由到类和控制器的方法支持传入额外参数 |
路由地址表示定义的路由表达式最终需要路由到的地址以及一些需要的额外参数,支持下面5种方式定义:
定义方式 | 定义格式 |
---|---|
方式1:路由到模块/控制器 | '[模块/控制器/操作]?额外参数1=值1&额外参数2=值2...' |
方式2:路由到重定向地址 | '外部地址'(默认301重定向) 或者 ['外部地址','重定向代码'] |
方式3:路由到控制器的方法 | '@[模块/控制器/]操作' |
方式4:路由到类的方法 | '\完整的命名空间类::静态方法' 或者 '\完整的命名空间类@动态方法' |
方式5:路由到闭包函数 | 闭包函数定义(支持参数传入) |
其中方式5我们将会在下一个章节闭包支持中详细描述。
路由到模块/控制器/操作
这是最常用的一种路由方式,把满足条件的路由规则路由到相关的模块、控制器和操作,然后由App类调度执行相关的操作。
同时会进行模块的初始化操作(包括配置读取、公共文件载入、行为定义载入、语言包载入等等)。
路由地址的格式为:
[模块/控制器/]操作?参数1=值1&参数2=值2...
解析规则是从操作开始解析,然后解析控制器,最后解析模块,例如:
// 路由到默认或者绑定模块
'blog/:id'=>'blog/read',
// 路由到index模块
'blog/:id'=>'index/blog/read',
Blog类定义如下:
namespace app\index\controller;
class Blog {
public function read($id){
return 'read:'.$id;
}
}
路由地址中支持多级控制器,使用下面的方式进行设置:
'blog/:id'=>'index/group.blog/read'
表示路由到下面的控制器类,
index/controller/group/Blog
Blog类定义如下:
namespace app\index\controller\group;
class Blog {
public function read($id){
return 'read:'.$id;
}
}
还可以支持路由到动态的模块、控制器或者操作,例如:
// action变量的值作为操作方法传入
':action/blog/:id' => 'index/blog/:action'
// 变量传入index模块的控制器和操作方法
':c/:a'=> 'index/:c/:a'
如果关闭路由功能的话,默认也会按照该规则对URL进行解析调度。
额外参数
在这种方式路由跳转的时候支持额外传入参数对(额外参数指的是不在URL里面的参数,隐式传入需要的操作中,有时候能够起到一定的安全防护作用,后面我们会提到)。例如:
'blog/:id'=>'blog/read?status=1&app_id=5',
上面的路由规则定义中额外参数status
和app_id
参数都是URL里面不存在的,属于隐式传值,当然并不一定需要用到,只是在需要的时候可以使用。
路由到操作方法
路由地址的格式为:
@[模块/控制器/]操作
这种方式看起来似乎和第一种是一样的,本质的区别是直接执行某个控制器类的方法,而不需要去解析 模块/控制器/操作这些,同时也不会去初始化模块。
例如,定义如下路由后:
'blog/:id'=>'@index/blog/read',
系统会直接执行
Loader::action('index/blog/read');
相当于直接调用 \app\index\controller\blog类的read方法。
Blog类定义如下:
namespace app\index\controller;
class Blog {
public function read($id){
return 'read:'.$id;
}
}
通常这种方式下面,由于没有定义当前模块名、当前控制器名和当前方法名 ,从而导致视图的默认模板规则失效,所以这种情况下面,如果使用了视图模板渲染,则必须传入明确的参数。
路由到类的方法
路由地址的格式为(动态方法):
\类的命名空间\类名@方法名
或者(静态方法)
\类的命名空间\类名::方法名
这种方式更进一步,可以支持执行任何类的方法,而不仅仅是执行控制器的操作方法,例如:
'blog/:id'=>'\app\index\service\Blog@read',
执行的是 \app\index\service\Blog
类的read
方法。
也支持执行某个静态方法,例如:
'blog/:id'=>'\app\index\service\Blog::read',
V5.0.4+
版本开始,支持传入额外的参数作为方法的参数调用(用于参数绑定),例如:
'blog/:id'=>'\app\index\service\Blog::read?status=1',
路由到重定向地址
重定向的外部地址必须以“/”或者http开头的地址。
如果路由地址以“/”或者“http”开头则会认为是一个重定向地址或者外部地址,例如:
'blog/:id'=>'/blog/read/id/:id'
和
'blog/:id'=>'blog/read'
虽然都是路由到同一个地址,但是前者采用的是301重定向的方式路由跳转,这种方式的好处是URL可以比较随意(包括可以在URL里面传入更多的非标准格式的参数),而后者只是支持模块和操作地址。举个例子,如果我们希望avatar/123
重定向到
/member/avatar/id/123_small的话,只能使用:
'avatar/:id'=>'/member/avatar/id/:id_small'
路由地址采用重定向地址的话,如果要引用动态变量,直接使用动态变量即可。
采用重定向到外部地址通常对网站改版后的URL迁移过程非常有用,例如:
'blog/:id'=>'http://blog.thinkphp.cn/read/:id'
表示当前网站(可能是http://thinkphp.cn )的 blog/123地址会直接重定向到 http://blog.thinkphp.cn/read/123。
相关文档
- 【冲顶神器功能介绍】实用功能盘点!助力高效操作,超省心
- 旺道SEO系统是什么?有啥用?核心功能大揭秘
- 手机网站排名优化软件到底是啥?有哪些重要功能?
- 企业网站管理系统挑选有门道?功能需求与操作简便性超关键
- 论坛短消息群发功能介绍,常见问题及操作步骤详解
- 淘宝新手上路指南!APP基本功能介绍及购物注意事项
- 想网上推广?刷论坛推广软件功能及靠谱选择方法来啦
- 免费Discuz论坛怎么用?有啥好处?功能全活儿超适合新手
- 免费论坛群发器好用吗?核心功能模块拆解及基本概念介绍
- 百中搜优化软件是啥?有啥用?功能模块大揭秘
- 企业门户:现代办公数字化平台,功能模块搭建要点有哪些?
- 凡科建站:网站建设领域有名堂,功能强大助你轻松建站
- 百度空间介绍:能创建个人网页,有写日志等多种功能
- 站优云:网络人关注的平台,其功能模块你了解多少?
- 关键词排名工具是啥?能帮上忙吗?查询核心功能模块了解下
- 天津SEO旺道是啥?能否助力网站优化?功能实效需考量
- 百度移动应用受众多手机用户青睐,功能亮点大揭秘
- 枫林SEO走红网络,这工具的关键词分析功能太绝了
- 快速排名工具怎么选怎么用?核心功能选择要点你知道吗?
- 谷歌站长平台工具:搜索效果报告 功能解读
上一篇: Eyoucms程序开发:路由参数
下一篇: Eyoucms程序开发:资源路由