參數綁定是通過直接綁定URL地址中的變量作為操作方法的參數,可以簡化方法的定義甚至路由的解析。
參數綁定功能默認是開啟的,其原理是把URL中的參數(不包括模塊、控制器和操作名)和操作方法中的參數進行綁定。
要啟用參數綁定功能,首先確保你開啟了URL_PARAMS_BIND
設置:
'URL_PARAMS_BIND' => true, // URL變量綁定到操作方法作為參數
按變量名綁定
默認的參數綁定方式是按照變量名進行綁定,例如,我們給Blog控制器定義了兩個操作方法read和archive方法,由於read操作需要指定一個id參數,archive方法需要指定年份(year)和月份(month)兩個參數,那么我們可以如下定義:
namespace Home\Controller; use Think\Controller; class BlogController extends Controller{ public function read($id){ echo 'id='.$id; } public function archive($year='2013',$month='01'){ echo 'year='.$year.'&month='.$month; } }
注意這里的操作方法並沒有具體的業務邏輯,只是簡單的示范。
URL的訪問地址分別是:
http://serverName/index.php/Home/Blog/read/id/5 http://serverName/index.php/Home/Blog/archive/year/2013/month/11
兩個URL地址中的id參數和year和month參數會自動和read操作方法以及archive操作方法的同名參數綁定。
變量名綁定不一定由訪問URL決定,路由地址也能起到相同的作用
輸出的結果依次是:
id=5
year=2013&month=11
按照變量名進行參數綁定的參數必須和URL中傳入的變量名稱一致,但是參數順序不需要一致。也就是說
http://serverName/index.php/Home/Blog/archive/month/11/year/2013
和上面的訪問結果是一致的,URL中的參數順序和操作方法中的參數順序都可以隨意調整,關鍵是確保參數名稱一致即可。
如果使用下面的URL地址進行訪問,參數綁定仍然有效:
http://serverName/index.php?s=/Home/Blog/read/id/5 http://serverName/index.php?s=/Home/Blog/archive/year/2013/month/11 http://serverName/index.php?c=Blog&a=read&id=5 http://serverName/index.php?c=Blog&a=archive&year=2013&month=11
如果用戶訪問的URL地址是(至於為什么會這么訪問暫且不提):
http://serverName/index.php/Home/Blog/read/
那么會拋出下面的異常提示: 參數錯誤:id
報錯的原因很簡單,因為在執行read操作方法的時候,id參數是必須傳入參數的,但是方法無法從URL地址中獲取正確的id參數信息。由於我們不能相信用戶的任何輸入,因此建議你給read方法的id參數添加默認值,例如:
public function read($id=0){ echo 'id='.$id; }
這樣,當我們訪問 http://serverName/index.php/Home/Blog/read/
的時候 就會輸出
id=0
當我們訪問 http://serverName/index.php/Home/Blog/archive/
的時候,輸出:
year=2013&month=01
始終給操作方法的參數定義默認值是一個避免報錯的好辦法
按變量順序綁定
第二種方式是按照變量的順序綁定,這種情況下URL地址中的參數順序非常重要,不能隨意調整。要按照變量順序進行綁定,必須先設置URL_PARAMS_BIND_TYPE
為1:
'URL_PARAMS_BIND_TYPE' => 1, // 設置參數綁定按照變量順序綁定
操作方法的定義不需要改變,URL的訪問地址分別改成:
http://serverName/index.php/Home/Blog/read/5 http://serverName/index.php/Home/Blog/archive/2013/11
輸出的結果依次是:
id=5
year=2013&month=11
這個時候如果改成
http://serverName/index.php/Home/Blog/archive/11/2013
輸出的結果就變成了:
year=11&month=2013
顯然就有問題了,所以不能隨意調整參數在URL中的傳遞順序,要確保和你的操作方法定義順序一致。
可以看到,這種參數綁定的效果有點類似於簡單的規則路由。
按變量順序綁定的方式目前僅對PATHINFO地址有效,所以下面的URL訪問參數綁定會失效:
http://serverName/index.php?c=Blog&a=read&id=5 http://serverName/index.php?c=Blog&a=archive&year=2013&month=11
但是,兼容模式URL地址訪問依然有效:
http://serverName/index.php?s=/Home/Blog/read/5 http://serverName/index.php?s=/Home/Blog/archive/2013/11
如果你的操作方法定義都不帶任何參數或者不希望使用該功能的話,可以關閉參數綁定功能:
'URL_PARAMS_BIND' => false