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

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

什麼是Eloquent 查詢作用域？

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

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

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

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

這是最常見(jiàn)也最容易上手的一種方式。比如你想篩選出所有“激活”的用戶，可以在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)，而且不需要每次都重複寫同樣的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ò)濾規(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();

---

常見(jiàn)誤區(qū)與註意事項(xiàng)

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

---

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

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