Action參數綁定是通過直接綁定URL地址中的變量作為操作方法的參數,可以簡化方法的定義甚至路由的解析。
Action參數綁定功能默認是開啟的,其原理是把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
~~~
- 序言
- 基礎
- 獲取ThinkPHP
- 環境要求
- 目錄結構
- 入口文件
- 自動生成
- 模塊
- 控制器
- 開發規范
- 配置
- 配置格式
- 配置加載
- 讀取配置
- 動態配置
- 擴展配置
- 批量配置
- 架構
- 模塊化設計
- URL模式
- 多層MVC
- CBD模式
- 命名空間
- 自動加載
- 應用模式
- 項目編譯
- 系統流程
- 路由
- 路由定義
- 規則路由
- 正則路由
- 靜態路由
- 閉包支持
- 實例說明
- 控制器
- 控制器定義
- 前置和后置操作
- Action參數綁定
- 偽靜態
- URL大小寫
- URL生成
- AJAX返回
- 跳轉和重定向
- 輸入變量
- 請求類型
- 空操作
- 空控制器
- 插件控制器
- 操作綁定到類
- 模型
- 模型定義
- 模型實例化
- 字段定義
- 連接數據庫
- 切換數據庫
- 分布式數據庫支持
- 連貫操作
- WHERE
- TABLE
- ALIAS
- DATA
- FIELD
- ORDER
- LIMIT
- PAGE
- GROUP
- HAVING
- JOIN
- UNION
- DISTINCT
- LOCK
- CACHE
- COMMENT
- RELATION
- USING
- fetchSql
- TOKEN
- STRICT
- INDEX
- 命名范圍
- CURD操作
- 數據創建
- 數據寫入
- 數據讀取
- 數據更新
- 數據刪除
- ActiveRecord
- 字段映射
- 查詢語言
- 查詢方式
- 表達式查詢
- 快捷查詢
- 區間查詢
- 組合查詢
- 統計查詢
- SQL查詢
- 動態查詢
- 子查詢
- 自動驗證
- 自動完成
- 參數綁定
- 虛擬模型
- 模型分層
- 視圖模型
- 關聯模型
- 高級模型
- Mongo模型
- 視圖
- 模板定義
- 模板主題
- 模板賦值
- 模板渲染
- 獲取模板地址
- 獲取內容
- 模板引擎
- 模板
- 變量輸出
- 系統變量
- 使用函數
- 默認值輸出
- 使用運算符
- 標簽庫
- 模板繼承
- 修改定界符
- 三元運算
- 包含文件
- 內置標簽
- Volist標簽
- Foreach標簽
- For標簽
- Switch標簽
- 比較標簽
- 范圍判斷標簽
- IF標簽
- Present標簽
- Empty標簽
- Defined標簽
- Assign標簽
- Define標簽
- 標簽嵌套
- import標簽
- 使用PHP代碼
- 原樣輸出
- 模板注釋
- 模板布局
- 模板替換
- 調試
- 調試模式
- 異常處理
- 日志記錄
- 頁面Trace
- Trace方法
- 變量調試
- 性能調試
- 錯誤調試
- 模型調試
- 緩存
- 數據緩存
- 快速緩存
- 查詢緩存
- 靜態緩存
- 安全
- 輸入過濾
- 表單合法性檢測
- 表單令牌
- 防止SQL注入
- 目錄安全文件
- 保護模板文件
- 上傳安全
- 防止XSS攻擊
- 其他安全建議
- 擴展
- 類庫擴展
- 驅動擴展
- 緩存驅動
- 數據庫驅動
- 日志驅動
- Session驅動
- 存儲驅動
- 模板引擎驅動
- 標簽庫驅動
- 行為擴展
- 標簽擴展
- Widget擴展
- 應用模式
- 部署
- PATH_INFO支持
- URL重寫
- 模塊部署
- 域名部署
- 入口綁定
- 替換入口
- 專題
- SESSION支持
- Cookie支持
- 多語言支持
- 數據分頁
- 文件上傳
- 驗證碼
- 圖像處理
- RESTFul
- RPC
- SAE
- IP獲取和定位
- 附錄
- 常量參考
- 配置參考
- 升級指導
- 鳴謝