Laravel Eloquent 的 查詢范圍 功能允許將遞歸查詢存儲(chǔ)在方法中以使代碼可重用。這使代碼保持良好且易于理解，尤其是在一次又一次需要相同類型的查詢時(shí)。 查詢范圍將常見查詢定義為方法，然后可以在整個(gè)模型中使用它們。

1。全局范圍

說明：

全局范圍 始終附加到模型。 當(dāng)您使用模型時(shí)，此范圍會(huì)自動(dòng)工作，您不必每次都編寫它。 通常用于檢查登錄狀態(tài)、活躍記錄等

創(chuàng)建全局范圍：

1. 創(chuàng)建全局范圍類：

要在 Laravel 中創(chuàng)建 全局范圍，需要使用一個(gè)實(shí)現(xiàn) Scope 接口的類。

use Illuminate\Database\Eloquent\Scope;
use Illuminate\Database\Eloquent\Model;
use Illuminate\Database\Eloquent\Builder;

class ActiveScope implements Scope
{
    public function apply(Builder $builder, Model $model)
    {
        $builder->where('active', 1);  // ??????  ???????
    }
}

2. 將全局范圍附加到模型：

這應(yīng)該添加到模型的 booted() 方法中。

use App\Models\Post;
use App\Scopes\ActiveScope;

class Post extends Model
{
    protected static function booted()
    {
        static::addGlobalScope(new ActiveScope);
    }
}

現(xiàn)在使用 Post::all() 將自動(dòng)應(yīng)用 active = 1 過濾器。

3. 暫時(shí)省略全局范圍：

use Illuminate\Database\Eloquent\Scope;
use Illuminate\Database\Eloquent\Model;
use Illuminate\Database\Eloquent\Builder;

class ActiveScope implements Scope
{
    public function apply(Builder $builder, Model $model)
    {
        $builder->where('active', 1);  // ??????  ???????
    }
}

這將暫時(shí)刪除全局范圍并返回除 active 過濾器之外的所有帖子。

2。本地范圍

說明：

本地范圍 充當(dāng)模型內(nèi)的特定查詢范圍，僅在您顯式調(diào)用它時(shí)才適用。 它不會(huì)像全局范圍那樣在每個(gè)查詢期間自動(dòng)應(yīng)用。

創(chuàng)建本地范圍：

通過向模型添加公共方法來創(chuàng)建本地作用域，其第一個(gè)參數(shù) Builder 是輸入。

use App\Models\Post;
use App\Scopes\ActiveScope;

class Post extends Model
{
    protected static function booted()
    {
        static::addGlobalScope(new ActiveScope);
    }
}

使用本地范圍：

$posts = Post::withoutGlobalScope(ActiveScope::class)->get();

將參數(shù)添加到本地范圍：

參數(shù)可以傳遞到本地作用域。

use App\Models\Post;

class Post extends Model
{
    // ?????  ?????
    public function scopeActive($query)
    {
        return $query->where('active', 1);
    }

    public function scopeDraft($query)
    {
        return $query->where('status', 'draft');
    }
}

范圍現(xiàn)在可以與 status 參數(shù)一起使用：

// ??????  ?????  ????:
$posts = Post::active()->get();

// ??????  ?????  ????:
$draftPosts = Post::draft()->get();

// ????  ???  ???????:
$activeDraftPosts = Post::active()->draft()->get();

'published' 是參數(shù)。

3。動(dòng)態(tài)范圍

動(dòng)態(tài)作用域是一種本地作用域，可以動(dòng)態(tài)調(diào)用作用域名稱。 Laravel 允許使用 scopeName() 類型名稱。

class Post extends Model
{
    // ?????  ?????
    public function scopeStatus($query, $status)
    {
        return $query->where('status', $status);
    }
}

范圍現(xiàn)在可以動(dòng)態(tài)調(diào)用：

$posts = Post::status('published')->get();

這就像 scopePublished() 方法一樣。

4。多個(gè)范圍

可以鏈接多個(gè)作用域。 例如，status 和 active 范圍可以一起使用：

use Illuminate\Database\Eloquent\Scope;
use Illuminate\Database\Eloquent\Model;
use Illuminate\Database\Eloquent\Builder;

class ActiveScope implements Scope
{
    public function apply(Builder $builder, Model $model)
    {
        $builder->where('active', 1);  // ??????  ???????
    }
}

這將同時(shí)適用于active和status('published')。

5?？涉溄臃秶?/strong>

use App\Models\Post;
use App\Scopes\ActiveScope;

class Post extends Model
{
    protected static function booted()
    {
        static::addGlobalScope(new ActiveScope);
    }
}