tp5.1 框架路由操作-URL生成实例分析
本文实例讲述了tp5.1 框架路由操作-url生成。分享给大家供大家参考,具体如下:
thinkphp支持路由url地址的统一生成,并且支持所有的路由方式,以及完美解决了路由地址的反转解析,无需再为路由定义和变化而改变url生成。
如果你开启了路由延迟解析,需要生成路由映射缓存才能支持全部的路由地址的反转解析。
url生成使用 \think\facade\url::build()
方法或者使用系统提供的助手函数url()
,参数一致:
url::build('地址表达式',['参数'],['url后缀'],['域名'])
url('地址表达式',['参数'],['url后缀'],['域名'])
地址表达式和参数
对使用不同的路由地址方式,地址表达式的定义有所区别。参数单独通过第二个参数传入,假设我们定义了一个路由规则如下:
route::rule('blog/:id','index/blog/read');
就可以使用下面的方式来生成url地址:
url::build('index/blog/read', 'id=5&name=thinkphp'); url::build('index/blog/read', ['id' => 5, 'name' => 'thinkphp']); url('index/blog/read', 'id=5&name=thinkphp'); url('index/blog/read', ['id' => 5, 'name' => 'thinkphp']);
使用模块/控制器/操作生成
如果你的路由方式是路由到模块/控制器/操作,那么可以直接写
// 生成index模块 blog控制器的read操作 url访问地址 url::build('index/blog/read', 'id=5&name=thinkphp'); // 使用助手函数 url('index/blog/read', 'id=5&name=thinkphp');
以上方法都会生成下面的url地址:
/index.php/blog/5/name/thinkphp.html
注意,生成方法的第一个参数必须和路由定义的路由地址保持一致,如果写成下面的方式可能无法正确生成url地址:
url::build('blog/read','id=5&name=thinkphp');
如果你的环境支持rewrite,那么生成的url地址会变为:
/blog/5/name/thinkphp.html
如果你配置了:
'url_common_param'=>true
那么生成的url地址变为:
/index.php/blog/5.html?name=thinkphp
不在路由规则里面的变量会直接使用普通url参数的方式。
需要注意的是,url地址生成不会检测路由的有效性,只是按照给定的路由地址和参数生成符合条件的路由规则。
使用控制器的方法生成
如果你的路由地址是采用控制器的方法,并且路由定义如下:
// 这里采用配置方式定义路由 动态注册的方式一样有效 route::get('blog/:id', '@index/blog/read');
那么可以使用如下方式生成:
// 生成index模块 blog控制器的read操作 url访问地址 url::build('@index/blog/read', 'id=5'); // 使用助手函数 url('@index/blog/read', 'id=5');
那么自动生成的url地址变为:
/index.php/blog/5.html
使用类的方法生成
如果你的路由地址是路由到类的方法,并且做了如下路由规则定义:
// 这里采用配置方式定义路由 动态注册的方式一样有效 route::rule(['blog','blog/:id'],'\app\index\controller\blog@read');
如果路由地址是到类的方法,需要首先给路由定义命名标识,然后使用标识快速生成url地址。
那么可以使用如下方式生成:
// 生成index模块 blog控制器的read操作 url访问地址 url::build('blog?id=5'); url('blog?id=5');
那么自动生成的url地址变为:
/index.php/blog/5.html
直接使用路由地址
我们也可以直接使用路由地址来生成url,例如:
我们定义了路由规则如下:
route::get('blog/:id' , 'index/blog/read');
可以使用下面的方式直接使用路由规则生成url地址:
url::build('/blog/5');
那么自动生成的url地址变为:
/index.php/blog/5.html
url后缀
默认情况下,系统会自动读取url_html_suffix
配置参数作为url后缀(默认为html),如果我们设置了:
'url_html_suffix' => 'shtml'
那么自动生成的url地址变为:
/index.php/blog/5.shtml
如果我们设置了多个url后缀支持
'url_html_suffix' => 'html|shtml'
则会取第一个后缀来生成url地址,所以自动生成的url地址还是:
/index.php/blog/5.html
如果你希望指定url后缀生成,则可以使用:
url::build('index/blog/read', 'id=5', 'shtml'); url('index/blog/read', 'id=5', 'shtml');
域名生成
默认生成的url地址是不带域名的,如果你采用了多域名部署或者希望生成带有域名的url地址的话,就需要传入第四个参数,该参数有两种用法:
自动生成域名
url::build('index/blog/read', 'id=5', 'shtml', true); url('index/blog/read', 'id=5', 'shtml', true);
第四个参数传入true
的话,表示自动生成域名,如果你开启了url_domain_deploy
还会自动识别匹配当前url规则的域名。
例如,我们注册了域名路由信息如下:
route::domain('blog','index/blog');
那么上面的url地址生成为:
http://blog.thinkphp.cn/read/id/5.shtml
指定域名
你也可以显式传入需要生成地址的域名,例如:
url::build('index/blog/read','id=5','shtml','blog'); url('index/blog/read','id=5','shtml','blog');
或者传入完整的域名
url::build('index/blog/read','id=5','shtml','blog.thinkphp.cn'); url('index/blog/read','id=5','shtml','blog.thinkphp.cn');
生成的url地址为:
http://blog.thinkphp.cn/read/id/5.shtml
也可以直接在第一个参数里面传入域名,例如:
url::build('index/blog/read@blog', 'id=5'); url('index/blog/read@blog', 'id=5'); url('index/blog/read@blog.thinkphp.cn', 'id=5');
生成锚点
支持生成url的锚点,可以直接在url地址参数中使用:
url::build('index/blog/read#anchor@blog','id=5'); url('index/blog/read#anchor@blog','id=5');
锚点和域名一起使用的时候,注意锚点在前面,域名在后面。
生成的url地址为:
http://blog.thinkphp.cn/read/id/5.html#anchor
隐藏或者加上入口文件
有时候我们生成的url地址可能需要加上index.php
或者去掉index.php
,大多数时候系统会自动判断,如果发现自动生成的地址有问题,可以直接在调用build
方法之前调用root
方法,例如加上index.php
:
url::root('/index.php'); url::build('index/blog/read','id=5');
或者隐藏index.php
:
url::root('/'); url::build('index/blog/read','id=5');
root
方法只需要调用一次即可。