Eloquent 查詢作用域通過封裝常用查詢條件提升代碼復(fù)用性和可讀性，分為本地作用域和全局作用域。1. 本地作用域在模型中定義，以 scope 開頭的方法實(shí)現(xiàn)，如 scopeActive() 用于篩選激活用戶，調(diào)用時(shí)直接使用 User::active()->get()；支持帶參數(shù)的查詢，如 scopeRole($query, $role) 可通過 User::role('admin')->get() 使用。2. 全局作用域通過實(shí)現(xiàn) Scope 接口并重寫 apply 方法，在所有查詢中自動(dòng)應(yīng)用統(tǒng)一過濾規(guī)則，如默認(rèn)查詢 status 為 active 的用戶，需在模型中注冊(cè) addGlobalScope，也可通過 withoutGlobalScopes() 暫時(shí)移除。使用時(shí)應(yīng)避免復(fù)雜邏輯、命名清晰、合理使用全局作用域，并通過測(cè)試確保生效。

在 Laravel 中使用 Eloquent 查詢作用域（Query Scopes）能讓你更優(yōu)雅地復(fù)用查詢邏輯。它不是什么高深技巧，但用好了確實(shí)能讓代碼更清晰、更易維護(hù)。

什么是 Eloquent 查詢作用域？

Eloquent 的查詢作用域本質(zhì)上是一個(gè)封裝好的查詢條件，可以附加到模型的查詢中。你可以把它理解為一個(gè)“預(yù)設(shè)過濾器”，比如你經(jīng)常需要查出所有啟用狀態(tài)的用戶，就可以把這個(gè)條件寫成一個(gè)作用域。

有兩種類型的查詢作用域：

• 本地作用域（Local Scopes）：以 scope 開頭的方法，可以在模型中定義。
• 全局作用域（Global Scopes）：實(shí)現(xiàn) Illuminate\Database\Eloquent\Scope 接口，適用于整個(gè)模型的所有查詢。

如何定義和使用本地查詢作用域？

這是最常見也最容易上手的一種方式。比如你想篩選出所有“激活”的用戶，可以在 User 模型里這樣寫：

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

然后在調(diào)用的時(shí)候：

User::active()->get();

你可以組合多個(gè)作用域，比如：

User::active()->verified()->orderBy('created_at')->get();

這種方式的好處是直觀、可讀性強(qiáng)，而且不需要每次都重復(fù)寫同樣的 where 條件。

小提示：如果你的作用域需要參數(shù)，比如根據(jù)角色篩選用戶，也可以加參數(shù)：

public function scopeRole($query, $role)
{
    return $query->where('role', $role);
}

使用時(shí)傳入?yún)?shù)即可：

User::role('admin')->get();

全局作用域更適合統(tǒng)一過濾規(guī)則

如果你希望某些查詢條件自動(dòng)應(yīng)用到所有的查詢中，比如軟刪除機(jī)制中的 deleted_at IS NULL，那就可以使用全局作用域。

創(chuàng)建一個(gè)全局作用域需要實(shí)現(xiàn) Scope 接口，并重寫 apply 方法。例如，我們想默認(rèn)只顯示 status 為 active 的用戶：

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

class ActiveUserScope implements Scope
{
    public function apply(Builder $builder, Model $model)
    {
        $builder->where('status', 'active');
    }
}

然后在模型中注冊(cè)這個(gè)作用域：

use Illuminate\Database\Eloquent\Model;

class User extends Model
{
    protected static function booted()
    {
        static::addGlobalScope(new ActiveUserScope());
    }
}

這樣以后每次查詢 User 模型時(shí)都會(huì)自動(dòng)加上 where status = 'active'。

注意：如果你想臨時(shí)去掉全局作用域，可以用：

User::withoutGlobalScopes()->get();

---

常見誤區(qū)與注意事項(xiàng)

• 不要把復(fù)雜邏輯都塞進(jìn)作用域：作用域適合做單一職責(zé)的條件拼接，太復(fù)雜的邏輯建議抽出來放在 Repository 或 Service 層。
• 命名要清晰簡(jiǎn)潔：比如 scopeVerified() 明顯比 scopeCheckIfEmailConfirmed() 更容易理解。
• 避免過度使用全局作用域：雖然方便，但可能會(huì)讓新手看不清數(shù)據(jù)為什么少了，調(diào)試起來麻煩。
• 記得測(cè)試作用域是否生效：特別是在有多個(gè)作用域嵌套或結(jié)合的情況下，單元測(cè)試能幫你避免很多隱藏問題。

---

基本上就這些。查詢作用域不是一個(gè)必須用的功能，但在合適的地方用好它，會(huì)讓你的代碼看起來更專業(yè)、更整潔。

以上是與Laravel的雄辯查詢范圍合作？的詳細(xì)內(nèi)容。更多信息請(qǐng)關(guān)注PHP中文網(wǎng)其他相關(guān)文章！