參數綁定是把當前請求的變量作為操作方法(也包括架構方法)的參數直接傳入,參數綁定并不區分請求類型。
> 參數綁定傳入的值會經過全局過濾,如果你有額外的過濾需求可以在操作方法中單獨處理。
## 按名稱綁定
參數綁定方式默認是按照變量名進行綁定,例如,我們給`Blog`控制器定義了兩個操作方法`read`和`archive`方法,由于`read`操作需要指定一個`id`參數,`archive`方法需要指定年份(`year`)和月份(`month`)兩個參數,那么我們可以如下定義:
~~~
<?php
namespace app\index\Controller;
class Blog
{
public function read($id)
{
return 'id='.$id;
}
public function archive($year, $month='01')
{
return 'year='.$year.'&month='.$month;
}
}
~~~
> 注意這里的操作方法并沒有具體的業務邏輯,只是簡單的示范。
URL的訪問地址分別是:
~~~
http://serverName/index.php/index/blog/read/id/5
http://serverName/index.php/index/blog/archive/year/2016/month/06
~~~
兩個URL地址中的`id`參數和`year`和`month`參數會自動和`read`操作方法以及`archive`操作方法的`同名參數`綁定。
> 變量名綁定不一定由訪問URL決定,路由地址也能起到相同的作用
輸出的結果依次是:
~~~
id=5
year=2016&month=06
~~~
按照變量名進行參數綁定的參數必須和URL中傳入的變量名稱一致,但是參數順序不需要一致。也就是說
~~~
http://serverName/index.php/index/blog/archive/month/06/year/2016
~~~
和上面的訪問結果是一致的,URL中的參數順序和操作方法中的參數順序都可以隨意調整,關鍵是確保參數名稱一致即可。
如果用戶訪問的URL地址是(至于為什么會這么訪問暫且不提):
~~~
http://serverName/index.php/index/blog/read/
~~~
那么會拋出下面的異常提示:`參數錯誤:id`
報錯的原因很簡單,因為在執行read操作方法的時候,id參數是必須傳入參數的,但是方法無法從URL地址中獲取正確的id參數信息。由于我們不能相信用戶的任何輸入,因此建議你給read方法的id參數添加默認值,例如:
~~~
public function read($id=0)
{
return 'id='.$id;
}
~~~
這樣,當我們訪問`http://serverName/index.php/index/blog/read/`的時候 就會輸出
~~~
id=0
~~~
> 始終給操作方法的參數定義默認值是一個避免報錯的好辦法(依賴注入參數除外)
`V5.1.21+`版本開始,為了更好的配合前端規范,支持自動識別小寫+下劃線的請求變量使用駝峰注入,例如:
~~~
http://serverName/index.php/index/blog/read/blog_id/5
~~~
可以使用下面的方式接收`blog_id`變量,所以請確保在方法的參數使用駝峰(首字母小寫)規范。
~~~
public function read($blogId=0)
{
return 'id='.$blogId;
}
~~~
## 按順序綁定
> 在使用路由定義的情況下 不建議使用順序綁定
還可以支持按照URL的參數順序進行綁定的方式,合理規劃URL參數的順序綁定對簡化URL地址可以起到一定的幫助。
還是上面的例子,控制器不變,還是使用:
~~~
<?php
namespace app\index\Controller;
class Blog
{
public function read($id)
{
return 'id='.$id;
}
public function archive($year='2016',$month='01')
{
return 'year='.$year.'&month='.$month;
}
}
~~~
我們在配置文件中添加配置參數如下:
~~~
// URL參數方式改成順序解析
'url_param_type' => 1,
~~~
接下來,訪問下面的URL地址:
~~~
http://serverName/index.php/index/blog/read/5
http://serverName/index.php/index/blog/archive/2016/06
~~~
輸出的結果依次是:
~~~
id=5
year=2016&month=06
~~~
按參數順序綁定的話,參數的順序不能隨意調整,如果訪問:
~~~
http://serverName/index.php/index/blog/archive/06/2016
~~~
最后的輸出結果則變成:
~~~
id=5
year=06&month=2016
~~~
復制
> 按順序綁定參數的話,操作方法的參數只能使用路由變量或者PATHINFO變量,而不能使用get或者post變量。