tp5.1 框架路由操作-URL生成例項分析
本文例項講述了tp5.1 框架路由操作-URL生成。分享給大家供大家參考,具體如下:
ThinkPHP支援路由URL地址的統一生成,並且支援所有的路由方式,以及完美解決了路由地址的反轉解析,無需再為路由定義和變化而改變URL生成。
如果你開啟了路由延遲解析,需要生成路由對映快取才能支援全部的路由地址的反轉解析。
URL生成使用 \think\facade\Url::build()
方法或者使用系統提供的助手函式url()
,引數一致:
Url::build('地址表示式',['引數'],['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','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'],'\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,例如:
我們定義了路由規則如下:
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','shtml');
域名生成
預設生成的URL地址是不帶域名的,如果你採用了多域名部署或者希望生成帶有域名的URL地址的話,就需要傳入第四個引數,該引數有兩種用法:
自動生成域名
Url::build('index/blog/read','shtml',true); url('index/blog/read',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','blog'); url('index/blog/read','blog');
或者傳入完整的域名
Url::build('index/blog/read','blog.thinkphp.cn'); url('index/blog/read','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
方法只需要呼叫一次即可。
更多關於thinkPHP相關內容感興趣的讀者可檢視本站專題:《ThinkPHP入門教程》、《thinkPHP模板操作技巧總結》、《ThinkPHP常用方法總結》、《codeigniter入門教程》、《CI(CodeIgniter)框架進階教程》、《Zend FrameWork框架入門教程》及《PHP模板技術總結》。
希望本文所述對大家基於ThinkPHP框架的PHP程式設計有所幫助。