參數綁定是把當前請求的變量作為操作方法(也包括架構方法)的參數直接傳入,參數綁定并不區分請求類型。
>[danger] 參數綁定傳入的值會經過全局過濾,如果你有額外的過濾需求可以在操作方法中單獨處理。
## 按名稱綁定
參數綁定方式默認是按照變量名進行綁定,例如,我們給`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;
}
~~~
## 按順序綁定
>[danger] 在使用路由定義的情況下 不建議使用順序綁定
還可以支持按照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
~~~
>[danger] 按順序綁定參數的話,操作方法的參數只能使用路由變量或者PATHINFO變量,而不能使用get或者post變量。
- 序言
- 基礎
- 安裝
- 開發規范
- 目錄結構
- 配置
- 架構
- 架構總覽
- 入口文件
- URL訪問
- 模塊設計
- 命名空間
- 容器和依賴注入
- Facade
- 鉤子和行為
- 中間件
- 路由
- 路由定義
- 變量規則
- 路由地址
- 閉包支持
- 路由參數
- 路由緩存
- 跨域請求
- 注解路由
- 路由分組
- MISS路由
- 資源路由
- 快捷路由
- 路由別名
- 路由綁定
- 域名路由
- URL生成
- 控制器
- 控制器定義
- 前置操作
- 跳轉和重定向
- 空操作和空控制器
- 分層控制器
- 資源控制器
- 控制器中間件
- 請求
- 請求對象
- 請求信息
- 輸入變量
- 請求類型
- HTTP頭信息
- 偽靜態
- 參數綁定
- 請求緩存
- 響應
- 響應輸出
- 響應參數
- 重定向
- 文件下載
- 數據庫
- 連接數據庫
- 查詢構造器
- 查詢數據
- 添加數據
- 更新數據
- 刪除數據
- 查詢表達式
- 鏈式操作
- where
- table
- alias
- field
- strict
- limit
- page
- order
- group
- having
- join
- union
- distinct
- lock
- cache
- comment
- fetchSql
- force
- partition
- failException
- sequence
- 聚合查詢
- 時間查詢
- 高級查詢
- 視圖查詢
- JSON字段
- 子查詢
- 原生查詢
- 查詢事件
- 獲取器
- 事務操作
- 監聽SQL
- 存儲過程
- 數據集
- 分布式數據庫
- 模型
- 定義
- 新增
- 更新
- 刪除
- 查詢
- JSON字段
- 獲取器
- 修改器
- 搜索器
- 數據集
- 自動時間戳
- 只讀字段
- 軟刪除
- 類型轉換
- 數據完成
- 查詢范圍
- 模型輸出
- 模型事件
- 模型關聯
- 一對一關聯
- 一對多關聯
- 遠程一對多
- 多對多關聯
- 多態關聯
- 關聯預載入
- 關聯統計
- 關聯輸出
- 視圖
- 視圖渲染
- 視圖賦值
- 視圖過濾
- 模板引擎
- 模板
- 變量輸出
- 使用函數
- 運算符
- 原樣輸出
- 模板注釋
- 模板布局
- 模板繼承
- 包含文件
- 輸出替換
- 標簽庫
- 內置標簽
- 循環標簽
- 比較標簽
- 條件判斷
- 資源文件加載
- 標簽嵌套
- 原生PHP
- 定義標簽
- 標簽擴展
- 錯誤和日志
- 異常處理
- 日志處理
- 調試
- 調試模式
- Trace調試
- 性能調試
- SQL調試
- 變量調試
- 遠程調試
- 驗證
- 驗證器
- 驗證規則
- 錯誤信息
- 驗證場景
- 路由驗證
- 內置規則
- 獨立驗證
- 靜態調用
- 表單令牌
- 雜項
- 緩存
- Session
- Cookie
- 多語言
- 分頁
- 上傳
- 命令行
- 啟動內置服務器
- 查看版本
- 自動生成目錄結構
- 創建類庫文件
- 生成類庫映射文件
- 清除緩存文件
- 生成配置緩存文件
- 生成數據表字段緩存
- 生成路由映射緩存
- 輸出路由定義
- 自定義指令
- 擴展庫
- 驗證碼
- 圖像處理
- Time
- 數據庫遷移工具
- Swoole
- Workerman
- MongoDb
- 單元測試
- 安全和性能
- 安全建議
- 優化建議
- 附錄
- 助手函數
- 升級指導
- 更新日志