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

1。全局范圍

說明：

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

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

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

要在 Laravel 中創(chuàng)建 全局范圍，需要使用一個實現 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. 將全局范圍附加到模型：

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

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

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

現在使用 Post::all() 將自動應用 active = 1 過濾器。

3. 暫時省略全局范圍：

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);  // ??????  ???????
    }
}

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

2。本地范圍

說明：

本地范圍 充當模型內的特定查詢范圍，僅在您顯式調用它時才適用。 它不會像全局范圍那樣在每個查詢期間自動應用。

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

通過向模型添加公共方法來創(chuàng)建本地作用域，其第一個參數 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();

將參數添加到本地范圍：

參數可以傳遞到本地作用域。

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');
    }
}

范圍現在可以與 status 參數一起使用：

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

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

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

'published' 是參數。

3。動態(tài)范圍

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

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

范圍現在可以動態(tài)調用：

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

這就像 scopePublished() 方法一樣。

4。多個范圍

可以鏈接多個作用域。 例如，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);  // ??????  ???????
    }
}

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

5。可鏈接范圍

Eloquent 的 本地作用域 是可鏈接的，這意味著可以同時使用多個作用域。

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

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

共有 3 個作用域和一個 orderBy 鏈式作用域。

以上是Bangla 部分查詢范圍中的 Laravel Eloquent ORM）的詳細內容。更多信息請關注PHP中文網其他相關文章！