Builder::where
源码
public function where($column, $operator = null, $value = null, $boolean = 'and')
{
if (is_array($column)) {
return $this->whereNested(function ($query) use ($column) {
foreach ($column as $key => $value) {
$query->where($key, '=', $value);
}
}, $boolean);
}
if (func_num_args() == 2) {
list($value, $operator) = [$operator, '='];
} elseif ($this->invalidOperatorAndValue($operator, $value)) {
throw new InvalidArgumentException('Illegal operator and value combination.');
}
if ($column instanceof Closure) {
return $this->whereNested($column, $boolean);
}
if (! in_array(strtolower($operator), $this->operators, true)) {
list($value, $operator) = [$operator, '='];
}
if ($value instanceof Closure) {
return $this->whereSub($column, $operator, $value, $boolean);
}
if (is_null($value)) {
return $this->whereNull($column, $boolean, $operator != '=');
}
$type = 'Basic';
$this->wheres[] = compact('type', 'column', 'operator', 'value', 'boolean');
if (! $value instanceof Expression) {
$this->addBinding($value, 'where');
}
return $this;
}
解读
public function where($column, $operator = null, $value = null, $boolean = 'and')
{
//如果参数column是一个数组，将假设这个数组是一个“字段”-“值”对应的关系对
//并且默认这些查询条件是并列存在的关系，即需满足所有的where数组，参见示例1
//如果传递了两个参数，将假设$popertor为“=”，否则将会抛出一个异常，参见示例2
//如果$column是一个闭包，暂时不能理解如果是一个闭包会发生什么，只知道允许$column是一个闭包。o(╯□╰)o
//参数$operator有一个允许的范围，如果不在允许范围之内，则默认$operator为“=”，参见示例4
//如果第三个参数$value是一个闭包，同$column闭包，不能理解...，参见示例3
//如果$value是空的
}
示例1
User::where([
"name" => "Zoe",
"gender" => "male"
], null, null, "or") -> get();
不管后面的三个参数如何变，最终的sql都是：“select * from `usr_userinfo` where (`id` = ? and `nickname` = ?)”。
示例2
User::where("id", "4")->...
等于User::where("id", "=", 4)->...
示例3
User::where("foo", "=", function($query){
$query -> from((new CmsUser()) -> getTable()) -> where("fiz", "biz");
}) -> toSql();
//select * from `usr_userinfo` where `foo` = (select * from `cms_user` where `fiz` = ?)
示例4
允许的operator参数
'=', '<', '>', '<=', '>=', '<>', '!=',
'like', 'like binary', 'not like', 'between', 'ilike',
'&', '|', '^', '<<', '>>',
'rlike', 'regexp', 'not regexp',
'~', '~*', '!~', '!~*', 'similar to',
'not similar to'
启示
一般是通过模型调用静态方法where去实现查询，但在model里面并没有where这一个方法，可以清楚的是，最终是通过调用builder::where来实现最终的查询。那么，在model里面是怎么找到builder::where的呢？
在Eloquent::model下面看到了如下代码：
public function __call($method, $parameters)
{
if (in_array($method, ['increment', 'decrement'])) {
return call_user_func_array([$this, $method], $parameters);
}
$query = $this->newQuery();
return call_user_func_array([$query, $method], $parameters);
}
public static function __callStatic($method, $parameters)
{
$instance = new static;
return call_user_func_array([$instance, $method], $parameters);
}
通过__call和__callStatic这两个魔术方法实现了对不可访问的方法的访问（another time, I will note them）。
在builder里面，laravel对函数功能进行了特别细致和合理的划分，比如对builder类中属性$binding的操作。首先有一个设置$binding的函数setBindings(array $bindings, $type = "where")，对$this->binding进行初始化。与之相对的，builder还提供了获取$this->builder的函数getBindings()和getRawBindings()（暂时不能区分两者）。然后提供了对$this->binding的添加操作addBinding($value, $type = "where")，和mergeBindings(Builder $query)。
这些函数其实就是针对属性$this->binding的增删改查，对$this->binding生命周期的控制（参见vue2.0的生命周期）。一个优秀的程序无非就是由这些“元”操作组成，在语言层面，各种语言已经为我们封装了一层。写程序，就是在程序层面，针对不同的业务，将整个流程分解成一个个不可细分、可以重复使用的“元”模块，一个个“元”类，一个个“元”函数。
对于流程，我们会不断的重复，因为业务不可能只是针对单人或者单次。我们就像拼积木一样对整个过程进行拆解，在类和函数的内部，我们不能信任任何输入，我们需要在每一个“元”保持输入的可靠性，这大概就是“低内聚、高耦合”了吧。对输入进行检查，检查类型和值，只有得到符合要求的数据时才能进行下一步功能操作，输出时也要对数据进行过滤，给对方想要的数据，只给对方想要的数据。
而流程针对用户，则体现为我做了什么、我要做什么、我没有做什么、我应该怎么做、做完之后我该怎么办、如果我没做又会怎么样。比如今天Boss让我做一个针对案件的通知管理，因为这个通知不是“我”发出去的，也无法修改，更不可以删除，所以从增删改查的角度，我只是对通知做了一个显示，完全没有考虑到如果通知没法出去怎么办？应该在哪些步骤发通知，发了还是没发？没发要怎么发？说来也是奇怪，Boss最近好像心情比较好，之前拿一些比较棘手的问题去资讯他，他都会不是很耐烦，今天我完全没搞懂应该怎么写，他还耐心的给我解释了好久，很奇怪。大概是因为流程很重要吧。
vue2.0生命周期
beforeCreate
created
beforeMount
mounted
beforeUpdate
updated
activated
deactivated
beforeDestroy
destroyed
网友评论