Dans Laravel Eloquent, la portée globale est automatiquement appliquée à chaque requête, adaptée à des scénarios tels que le filtrage des utilisateurs inactifs; La portée locale doit être appelée manuellement, adaptée à des scénarios tels que l'affichage d'articles publiés uniquement dans un contexte spécifique. 1. La portée globale est implémentée en implémentant l'interface de portée et en s'inscrivant dans le modèle, comme l'ajout de la condition (?active?, vrai). 2. La portée locale est une méthode dans le modèle, en commen?ant par la portée et peut prendre des paramètres, tels que ScopeVerified () ou ScopeOfType (). 3. Lors de l'utilisation de la portée globale, son impact sur toutes les requêtes doit être pris en considération et, si nécessaire, vous pouvez l'exclure par sans Globalscopes (). 4. Lors de la sélection d'une portée, décidez si les conditions sont toujours nécessaires et faites attention à la lisibilité et à la testabilité du code. 5. Une portée globale simple peut être définie par les fermetures pour améliorer l'efficacité du développement.

Dans Laravel éloquent, comprendre comment définir et utiliser des portées locales et mondiales est la clé pour écrire du code propre, réutilisable et maintenable. Les portées vous aident à filtrer les résultats de la requête sans répéter les mêmes conditions sur votre application. Voici comment en tirer le meilleur parti.

Quelle est la différence entre les lunettes locales et mondiales?

Les portées globales s'appliquent automatiquement à chaque fois que vous interrogez un modèle - comme toujours filtrer les utilisateurs supprimés ou récupérer uniquement les enregistrements actifs.
Les portées locales , en revanche, sont appliquées manuellement en cas de besoin - par exemple, affichant uniquement des publications publiées dans certains contextes.

Savoir quand utiliser chacun aide à garder votre logique organisée et empêche les bogues de l'exposition involontaire des données.

Comment définir une portée mondiale

Pour créer une lunette globale , vous devez implémenter l'interface Illuminate\Database\Eloquent\Scope . Cela implique de définir une classe avec une méthode apply qui ajoute des contraintes à la requête.

Par exemple, disons que vous souhaitez exclure les utilisateurs inactifs à l'échelle mondiale:

 Namespace App \ Scopes;

Utiliser illuminate \ database \ eloquent \ builder;
Utiliser illuminate \ database \ eloquent \ modèle;
Utiliser illuminate \ database \ eloquent \ scope;

Class ActiveUserSerscope implémente la portée
{
    Fonction publique s'applique (Builder $ Builder, Model $ modèle)
    {
        $ builder-> où ('actif', true);
    }
}

Ensuite, dans votre modèle:

 Utilisez App \ Scopes \ ActiveUserscope;

Fonction statique protégée démarrée ()
{
    static :: addGlobalscope (new ActiveUserscope);
}

Maintenant, chaque requête de ce modèle comprendra where active = true .

Remarque: vous pouvez contourner les lunettes globales à l'aide de méthodes comme withoutGlobalScopes() ou withoutGlobalScope(ActiveUserScope::class) si vous avez besoin de récupérer tous les enregistrements.

Créer et utiliser des lunettes locales

Une lunette locale est plus simple - c'est juste une méthode à l'intérieur de votre modèle qui commence par scope , suivie du nom dans Camelcase.

Par exemple, pour définir une portée qui ne renvoie que les utilisateurs vérifiés:

 Fonction publique ScopeVierified (Builder $ Query): Builder
{
    return $ query-> wherenotnull ('email_verified_at');
}

Ensuite, appelez-le comme ceci:

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

Vous pouvez également ajouter des paramètres:

 Fonction publique ScopeOfType (Builder $ Query, String $ type): Builder
{
    retourner $ query-> où ('type', $ type);
}

Et utilisez-le comme:

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

Ces portées sont idéales pour réutiliser des filtres communs sans encombrer vos contr?leurs.

Quand choisir Global vs Local Scopes

• Utilisez des portées globales lorsque la condition doit toujours être appliquée (comme les traits molle, l'isolement des locataires, les contr?les d'état).
• Utilisez des lunettes locales lorsque le filtre dépend du contexte (par exemple, filtrage par catégorie, statut ou r?les utilisateur personnalisés).

Considérez également la lisibilité et la testabilité:

• Les portées mondiales sont puissantes mais peuvent être plus difficiles à retrouver lors du débogage.
• Les portées locales sont plus explicites et plus faciles à comprendre en un coup d'?il.

Quelques conseils:

• Documenter toutes les portées mondiales afin que les futurs développeurs sachent qu'ils existent.
• N'en faites pas trop avec trop de lunettes - parfois une clause simple où est plus claire.
• Des portées liées au groupe dans des traits ou des modèles de base si vous vous retrouvez à les copier.

Conseil bonus: utilisant des étendues mondiales anonymes

Si votre portée est simple, vous pouvez ignorer la création d'une classe distincte et utiliser une fermeture directement dans le modèle:

 Utiliser illuminate \ database \ eloquent \ builder;
Utiliser illuminate \ support \ FACADES \ Auth;

Fonction statique protégée démarrée ()
{
    static :: addglobalscope ('user_tenant', fonction (builder $ builder) {
        $ builder-> où ('user_id', auth :: id ());
    });
}

Ceci est pratique pour les filtres rapides qui n'ont pas besoin de réutilisation sur plusieurs modèles.

Fondamentalement, les étendues sont l'un de ces outils de Laravel qui, une fois, une fois, rendre votre code plus propre et plus expressif. Que vous appliquiez une règle globale ou que vous ajoutiez un filtre conditionnel, sachant quelle portée utiliser et comment maintient les choses en douceur.

Pas de magie - juste une logique de requête intelligente et réutilisable.

Ce qui précède est le contenu détaillé de. pour plus d'informations, suivez d'autres articles connexes sur le site Web de PHP en chinois!