URL生成

ThinkPHP5.0支持路由URL地址的统一生成,并且支持所有的路由方式,以及完美解决了路由地址的反转解析,无需再为路由定义和变化而改变URL生成。

版本 更新功能
5.0.10 增加app_host配置参数用于设置当前生成URL的根地址
增加https_agent_name配置参数用于设置当前CDN或者代理的https标识名

URL生成使用\think\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地址生成不会检测路由的有效性,只是按照给定的路由地址和参数生成符合条件的路由规则。

使用控制器的方法生成

如果你的路由地址是采用控制器的方法,并且路由定义如下:

						
							// 这里采用配置方式定义路由 动态注册的方式一样有效
							'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,例如:

我们定义了路由规则如下:

						
							'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/[email protected]','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方法只需要调用一次即可。

文档最后更新时间:2018-04-25 19:37:14

文档
目录

深色
模式

切换
宽度