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/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'); ~~~