URL生成


URL生成使用 \think\facade\Route::buildUrl() 方法即可。该方法会返回一个think\route\Url对象实例,因为使用了__toString方法,因此可以直接输出路由地址。

echo \think\facade\Route::buildUrl();

使用路由标识

对使用不同的路由地址方式,地址表达式的定义有所区别。参数单独通过第二个参数传入,假设我们定义了一个路由规则如下:

Route::rule('blog/:id','index/blog/read');

在没有指定路由标识的情况下,可以直接使用路由地址来生成URL地址:

Route::buildUrl('index/blog/read', ['id' => 5, 'name' => 'thinkphp']);

如果我们在注册路由的时候指定了路由标识

Route::rule('blog/:id','index/blog/read')->name('blog_read');

那么必须使用路由标识来生成URL地址

Route::buildUrl('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地址生成不会检测路由的有效性,只是按照给定的路由地址和参数生成符合条件的路由规则。

使用路由地址

我们也可以直接使用路由地址来生成URL,例如:

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

Route::get('blog/:id' , 'blog/read');

可以使用下面的方式直接使用路由规则生成URL地址:

Route::buildUrl('/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后缀生成,则可以使用:

Route::buildUrl('blog/read', ['id'=>5])->suffix('shtml');

域名生成

默认生成的URL地址是不带域名的,如果你采用了多域名部署或者希望生成带有域名的URL地址的话,就需要传入第四个参数,该参数有两种用法:

自动生成域名

Route::buildUrl('index/blog/read',  ['id'=>5])
    ->suffix('shtml')
    ->domain(true);

第四个参数传入true的话,表示自动生成域名,如果你开启了url_domain_deploy还会自动识别匹配当前URL规则的域名。

例如,我们注册了域名路由信息如下:

Route::domain('blog','index/blog');

那么上面的URL地址生成为:

http://blog.thinkphp.cn/read/id/5.shtml

指定域名

你也可以显式传入需要生成地址的域名,例如:

Route::buildUrl('blog/read', ['id'=>5])->domain('blog');

或者传入完整的域名

Route::buildUrl('index/blog/read', ['id'=>5])->domain('blog.thinkphp.cn');

生成的URL地址为:

http://blog.thinkphp.cn/read/id/5.shtml

也可以直接在第一个参数里面传入域名,例如:

Route::buildUrl('index/blog/read@blog',  ['id'=>5]);
Route::buildUrl('index/blog/read@blog.thinkphp.cn',  ['id'=>5]);

生成锚点

支持生成URL的锚点,可以直接在URL地址参数中使用:

Route::buildUrl('index/blog/read#anchor@blog', ['id'=>5]);

锚点和域名一起使用的时候,注意锚点在前面,域名在后面。

生成的URL地址为:

http://blog.thinkphp.cn/read/id/5.html#anchor

加上入口文件

有时候我们生成的URL地址可能需要加上index.php或者去掉index.php,大多数时候系统会自动判断,如果发现自动生成的地址有问题,可以使用下面的方法:

Route::buildUrl('index/blog/read', ['id'=>5])->root('/index.php');

助手函数

系统提供了一个url助手函数用于完成相同的功能,例如:

url('index/blog/read', ['id'=>5])->suffix('html')->domain(true)->root('/index.php');