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

如果你开启了路由延迟解析 需要生成路由映射缓存才能支持全部的路由地址的反转解析。

URL生成使用 thinkfacadeUrl::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'],'appindexcontrollerblog@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方法只需要调用一次即可。