查询范围如何在 Laravel 中工作？

Question

我正在看 Laracasts: Laravel 5.4 from Scratch 系列，并且遇到了查询范围的概念。

在视频中，我们这样设置了一个类：

<?php

namespace App;

use Illuminate\Database\Eloquent\Model;

class Task extends Model
{

    public function scopeIncomplete($query)
    {

        return $query->where('completed', 0);

    }
}

我的第一个问题：

为什么像这样的方法： public function scopeIncomplete($query) 这样调用：App\Task::incomplete() 和 :: 运算符？

那不是静态调用的非静态方法吗？

我的第二个问题：

$query 来自哪里？

据我所知，这是“现有”查询，但它的名称如下：App\Task::incomplete()->where('id', '>', 1)->get();

所以我不太确定这个变量是从哪里来的。

也许稍后会更深入地解释它，但我无法理解它是如何工作的。

Answer 1

这是相当广泛的，因为它涵盖了关于 Eloquent 的两个大主题。

---

第一个是指 Eloquent 使用外观模式将静态调用传递给非静态方法。

外观模式利用 IoC 容器将方法调用传递给类的绑定或新实例。

外观模式利用重载和魔术方法__callStatic。

---

第二个问题是指 Eloquent 的重载，它将未注册的方法调用传递给查询构建器对象（特别是 \Illuminate\Database\Eloquent\Builder）。这就是允许在 Eloquent 模型本身上调用 where() 和各种其他 Query Builder 方法的原因。在 Model 类中，您可以看到：

/**
 * Handle dynamic method calls into the model.
 *
 * @param  string  $method
 * @param  array  $parameters
 * @return mixed
 */
public function __call($method, $parameters)
{
    if (in_array($method, ['increment', 'decrement'])) {
        return $this->$method(...$parameters);
    }

    return $this->newQuery()->$method(...$parameters);
}

由于模型中没有定义 where() 或不完整()，它们将被传递给由 Model::newQuery() 返回的 Builder 类。

在 Builder __call 方法中，您有：

    if (method_exists($this->model, $scope = 'scope'.ucfirst($method))) {
        return $this->callScope([$this->model, $scope], $parameters);
    }

所以这是检查模型内部定义的范围并传递包含此 Builder 实例的 $parameters。

总而言之，对 Model::incomplete() 的调用将会：

模型 __call() -> 构建器 __call() -> 模型范围不完整（构建器 $builder）