参数绑定
最后更新于:2022-04-01 21:20:13
方法参数绑定是把URL地址(或者路由地址)中的变量作为操作方法的参数直接传入。
## 操作方法参数绑定
### 按名称绑定
参数绑定方式默认是按照变量名进行绑定,例如,我们给Blog控制器定义了两个操作方法`read`和`archive`方法,由于`read`操作需要指定一个`id`参数,`archive`方法需要指定年份(`year`)和月份(`month`)两个参数,那么我们可以如下定义:
~~~
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的访问地址分别是:
~~~
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
~~~
> 始终给操作方法的参数定义默认值是一个避免报错的好办法
### 按顺序绑定
还可以支持按照URL的参数顺序进行绑定的方式,合理规划URL参数的顺序绑定对简化URL地址可以起到一定的帮助。
还是上面的例子,控制器不变,还是使用:
~~~
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] #### 注意
>****
>按顺序绑定参数的话,操作方法的参数只能使用URL pathinfo变量,而不能使用get或者post变量。
参数绑定有一个特例,如果你的操作方法中定义有`Request`对象作为参数的话,无论参数位置在哪里,都会自动注入,而不需要进行参数绑定。
## 架构方法参数绑定(V5.0.1)
可以对架构函数进行参数绑定,当前请求的路由变量可以自动绑定到架构函数的参数,例如:
~~~
namespace app\index\Controller;
class Blog
{
protected $name;
public function __construct($name = null)
{
$this->name = $name;
}
}
~~~
如果访问
~~~
http://localhost/index/index/index/name/thinkphp
~~~
当前请求的路由变量name的值thinkphp会自动传入架构方法的name变量。
';