Laravel Eloquentでは、グローバルスコープが各クエリに自動的に適用され、非アクティブユーザーのフィルタリングなどのシナリオに適しています。ローカルスコープは、特定のコンテキストでのみ公開された記事を表示するなどのシナリオに適した手動で呼び出す必要があります。 1。グローバルスコープは、スコープインターフェイスを?qū)g裝し、モデルに登録することにより実裝されます。 2。ローカルスコープは、スコープから始まるモデルのメソッドであり、Scopeverified（）やScopeOfType（）などのパラメーターを取得できます。 3.グローバルスコープを使用する場合、すべてのクエリへの影響を考慮する必要があります。必要に応じて、Globalscopes（）で除外できます。 4.スコープを選択するときは、條件が常に必要かどうかに基づいて決定し、コードの読みやすさとテスト可能性に注意してください。 5.開発効率を向上させるために、閉鎖を通じて単純なグローバル範(fàn)囲を定義できます。

Laravel Eloquentでは、ローカルおよびグローバルなスコープを定義および使用する方法を理解することは、クリーンで再利用可能な、保守可能なコードを書くための鍵です。スコープは、アプリケーション全體で同じ條件を繰り返すことなく、クエリの結(jié)果をフィルタリングするのに役立ちます。それらを最大限に活用する方法は次のとおりです。

ローカルスコープとグローバルスコープの違いは何ですか？

グローバルスコープは、モデルをクエリするたびに自動的に適用されます。常に削除されたユーザーをフィルタリングしたり、アクティブレコードを取得したりするだけです。
一方、ローカルスコープは、必要に応じて手動で適用されます。たとえば、特定のコンテキストで公開された投稿のみを表示します。

それぞれをいつ使用するかを知ることは、ロジックを整理し、バグが意図しないデータ曝露を防ぐのに役立ちます。

グローバルな範(fàn)囲を定義する方法

グローバルスコープを作成するには、 Illuminate\Database\Eloquent\Scopeインターフェイスを?qū)g裝する必要があります。これには、クエリに制約を追加するapply方法でクラスを定義することが含まれます。

たとえば、非アクティブなユーザーをグローバルに除外したいとしましょう。

名前空間アプリ\ scopes;

Illuminate \ database \ eloquent \ builderを使用します。
Illuminate \ database \ eloquent \ Modelを使用します。
Illuminate \ database \ eloquent \ scopeを使用します。

クラスActiveScopeは範(fàn)囲を?qū)g裝します
{
    パブリック機(jī)能の適用（ビルダー$ビルダー、モデル$モデル）
    {
        $ builder-> where（ 'Active'、true）;
    }
}

次に、モデルで：

 app \ scopes \ ActiveUserscopeを使用します。

保護(hù)された靜的関數(shù)booted（）
{
    static :: addglobalscope（new ActiveUserscope）;
}

これで、このモデルのすべてのクエリwhere active = true含まれます。

注：すべてのレコードを取得する必要がある場合はwithoutGlobalScopes()やwithoutGlobalScope(ActiveUserScope::class)などの方法を使用して、グローバルスコープをバイパスできます。

ローカルスコープの作成と使用

ローカルスコープはよりシンプルです。これは、 scopeから始まるモデル內(nèi)のメソッドにすぎず、その後にCamelCaseの名前が続きます。

たとえば、検証済みのユーザーのみを返すスコープを定義するには：

 public function scopeverified（ビルダー$ query）：ビルダー
{
    $ query-> wherenotnull（ 'email_verified_at'）;を返します。
}

次に、次のように呼びます：

ユーザー:: verified（） - > get（）;

パラメーターを追加することもできます。

 public function scopeoftype（Builder $ query、string $ type）：ビルダー
{
    $ query-> where（ 'type'、$ type）を返します。
}

次のように使用します。

 user :: oftype（ 'admin'） - > get（）;

これらのスコープは、コントローラーを亂雑にすることなく、一般的なフィルターを再利用するのに最適です。

グローバルスコープとローカルスコープを選択するタイミング

• 條件を常に適用する必要がある場合は、グローバルスコープを使用します（ソフトデレート、テナント分離、ステータスチェックなど）。
• フィルターがコンテキスト依存の場合（たとえば、カテゴリ、ステータス、またはカスタムユーザーロールごとにフィルタリング）場合はローカルスコープを使用します。

また、読みやすさとテスト可能性を検討してください。

• グローバルスコープは強(qiáng)力ですが、デバッグ時(shí)に追跡するのが難しい場合があります。
• ローカルスコープは、より明確で、一目で理解しやすいです。

いくつかのヒント：

• 將來の開発者が存在することを知っているように、グローバルなスコープを文書化します。
• あまりにも多くのスコープでそれをやり過ぎないでください - 時(shí)には句がより明確な場合もあります。
• グループをコピーしていることに気付いた場合、グループに関連する範(fàn)囲またはベースモデルに関連します。

ボーナスヒント：匿名のグローバルスコープを使用します

スコープが単純な場合は、別のクラスを作成してモデルで直接閉鎖を使用することができます。

 Illuminate \ database \ eloquent \ builderを使用します。
Illuminate \ support \ facades \ authを使用します。

保護(hù)された靜的関數(shù)booted（）
{
    static :: addglobalscope（ 'user_tenant'、function（builder $ builder）{
        $ builder-> where（ 'user_id'、auth :: id（））;
    }）;
}

これは、複數(shù)のモデルで再利用する必要のないクイックフィルターに便利です。

基本的に、スコープはLaravelのツールの1つであり、理解したらコードをきれいにし、表現(xiàn)力を高めます。グローバルルールを適用している場合でも、條件付きフィルターを追加しても、使用する範(fàn)囲とスムーズに動作を維持する方法を把握します。

魔法はありません - スマートで再利用可能なクエリロジックだけです。

以上がLaravel Eloquentでローカルおよびグローバルスコープの定義と使用の詳細(xì)內(nèi)容です。詳細(xì)については、PHP 中國語 Web サイトの他の関連記事を參照してください。