## 参数绑定
参数绑定是把当前请求的变量作为操作方法(也包括架构方法)的参数直接传入,参数绑定并不区分请求类型。
>[danger] 参数绑定传入的值会经过全局过滤,如果你有额外的过滤需求可以在操作方法中单独处理。
参数绑定方式默认是按照变量名进行绑定,例如,我们给`Blog`控制器定义了两个操作方法`read`和`archive`方法,由于`read`操作需要指定一个`id`参数,`archive`方法需要指定年份(`year`)和月份(`month`)两个参数,那么我们可以如下定义:
~~~
<?php
namespace app\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/blog/read/id/5
http://serverName/index.php/blog/archive/year/2016/month/06
~~~
两个URL地址中的`id`参数和`year`和`month`参数会自动和`read`操作方法以及`archive`操作方法的`同名参数`绑定。
> 变量名绑定不一定由访问URL决定,路由地址也能起到相同的作用
输出的结果依次是:
~~~
id=5
year=2016&month=06
~~~
按照变量名进行参数绑定的参数必须和URL中传入的变量名称一致,但是参数顺序不需要一致。也就是说
~~~
http://serverName/index.php/blog/archive/month/06/year/2016
~~~
和上面的访问结果是一致的,URL中的参数顺序和操作方法中的参数顺序都可以随意调整,关键是确保参数名称一致即可。
如果用户访问的URL地址是:
~~~
http://serverName/index.php/blog/read
~~~
那么会抛出下面的异常提示: `参数错误:id`
报错的原因很简单,因为在执行read操作方法的时候,id参数是必须传入参数的,但是方法无法从URL地址中获取正确的id参数信息。由于我们不能相信用户的任何输入,因此建议你给read方法的id参数添加默认值,例如:
~~~
public function read($id = 0)
{
return 'id=' . $id;
}
~~~
这样,当我们访问 `http://serverName/index.php/blog/read/` 的时候 就会输出
~~~
id=0
~~~
> 始终给操作方法的参数定义默认值是一个避免报错的好办法(依赖注入参数除外)
为了更好的配合前端规范,支持自动识别小写+下划线的请求变量使用驼峰注入,例如:
~~~
http://serverName/index.php/blog/read/blog_id/5
~~~
可以使用下面的方式接收`blog_id`变量,所以请确保在方法的参数使用驼峰(首字母小写)规范。
~~~
public function read($blogId = 0)
{
return 'id=' . $blogId;
}
~~~
- 序言
- 基础
- 安装
- 开发规范
- 目录结构
- 配置
- 架构
- 请求流程
- 架构总览
- 入口文件
- 多应用模式
- URL访问
- 容器和依赖注入
- 服务
- 门面
- 中间件
- 事件
- 路由
- 路由定义
- 变量规则
- 路由地址
- 路由参数
- 路由中间件
- 路由分组
- 资源路由
- 注解路由
- 路由绑定
- 域名路由
- MISS路由
- 跨域请求
- URL生成
- 控制器
- 控制器定义
- 基础控制器
- 空控制器
- 资源控制器
- 控制器中间件
- 请求
- 请求对象
- 请求信息
- 输入变量
- 请求类型
- HTTP头信息
- 伪静态
- 参数绑定
- 请求缓存
- 响应
- 响应输出
- 响应参数
- 重定向
- 文件下载
- 数据库
- 连接数据库
- 分布式数据库
- 查询构造器
- 查询数据
- 添加数据
- 更新数据
- 删除数据
- 查询表达式
- 链式操作
- where
- table
- alias
- field
- strict
- limit
- page
- order
- group
- having
- join
- union
- distinct
- lock
- cache
- cacheAlways
- comment
- fetchSql
- force
- partition
- failException
- sequence
- replace
- extra
- duplicate
- procedure
- 聚合查询
- 分页查询
- 时间查询
- 高级查询
- 视图查询
- JSON字段
- 子查询
- 原生查询
- 获取查询参数
- 查询事件
- 获取器
- 事务操作
- 存储过程
- 数据集
- 数据库驱动
- 模型
- 定义
- 模型字段
- 新增
- 更新
- 删除
- 查询
- 查询范围
- JSON字段
- 获取器
- 修改器
- 搜索器
- 数据集
- 自动时间戳
- 只读字段
- 软删除
- 类型转换
- 模型输出
- 模型事件
- 模型关联
- 一对一关联
- 一对多关联
- 远程一对多
- 远程一对一
- 多对多关联
- 多态关联
- 关联预载入
- 关联统计
- 关联输出
- 虚拟模型
- 视图
- 模板变量
- 视图过滤
- 模板渲染
- 模板引擎
- 视图驱动
- 错误和日志
- 异常处理
- 日志处理
- 调试
- 调试模式
- Trace调试
- SQL调试
- 变量调试
- 远程调试
- 验证
- 验证器
- 验证规则
- 错误信息
- 验证场景
- 路由验证
- 内置规则
- 表单令牌
- 注解验证
- 杂项
- 缓存
- Session
- Cookie
- 多语言
- 上传
- 命令行
- 启动内置服务器
- 查看版本
- 自动生成应用目录
- 创建类库文件
- 清除缓存文件
- 生成数据表字段缓存
- 生成路由映射缓存
- 输出路由定义
- 自定义指令
- Debug输出级别
- 扩展库
- 数据库迁移工具
- Workerman
- think助手工具库
- 验证码
- Swoole
- 附录
- 助手函数
- 升级指导
- 更新日志