ThinkPHP支援路由URL位址的統一生成,并且支援所有的路由方式,以及完美解決了路由位址的反轉解析,無需再為路由定義和變化而改變URL生成。
>[danger] 如果你開啟了路由延遲解析,需要生成路由映射緩存才能支援全部的路由位址的反轉解析。
URL生成使用 `\think\facade\Route::buildUrl()` 方法即可。該方法會傳回一個`think\route\Url`對象執行個體,因為使用了`__toString`方法,是以可以直接輸出路由位址。
```
echo \think\facade\Route::buildUrl();
```
如果是通過資料傳回用戶端,你可以先強制轉換為字元串類型後再傳回。
```
$url = (string) \think\facade\Route::buildUrl();
```
## 使用路由辨別
對使用不同的路由位址方式,位址表達式的定義有所差別。參數單獨通過第二個參數傳入,假設我們定義了一個路由規則如下:
~~~
Route::rule('blog/:id','blog/read');
~~~
在沒有指定路由辨別的情況下,可以直接使用路由位址來生成URL位址:
~~~
Route::buildUrl('blog/read', ['id' => 5, 'name' => 'thinkphp']);
~~~
如果我們在注冊路由的時候指定了路由辨別
~~~
Route::rule('blog/:id','blog/read')->name('blog_read');
~~~
那麼必須使用路由辨別來生成URL位址
~~~
Route::buildUrl('blog_read', ['id' => 5, 'name' => 'thinkphp']);
~~~
以上方法都會生成下面的URL位址:
~~~
/index.php/blog/5/name/thinkphp.html
~~~
如果你的環境支援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/[email protected]', ['id'=>5]);
Route::buildUrl('index/blog/[email protected]', ['id'=>5]);
~~~
## 生成錨點
支援生成URL的錨點,可以直接在URL位址參數中使用:
~~~
Route::buildUrl('index/blog/read#[email protected]', ['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');
~~~