Utilisation de portées de requête éloquentes à Laravel.

La portée de la requête éloquente améliore la clarté du code et la réutilisabilité en encapsulant la logique de requête commune. 1. La portée locale est définie avec des méthodes commençant par la portée, telles que ScopeActive () est utilisée pour filtrer les utilisateurs compatibles; 2. La portée dynamique prend en charge le passage des paramètres, comme Scopestatus ($ statut) pour réaliser un filtrage à l'état flexible; 3. La portée globale est automatiquement appliquée à toutes les requêtes, adaptées à l'isolement des données mais doit être utilisée avec prudence; 4. Plusieurs portées peuvent être combinées dans des chaînes pour améliorer l'expression et la maintenance sémantiques; 5. Les requêtes complexes peuvent être traitées de manière centralisée par des jugements conditionnels pour améliorer la flexibilité.

Dans Laravel, les éloges éloquentes des requêtes sont une caractéristique très pratique mais souvent sous-estimée. Il peut vous aider à encapsuler la logique de requête couramment utilisée, ce qui rend le code plus clair et plus réutilisable. Si vous écrivez souvent du double où les conditions ou souhaitez organiser la logique de requête dans votre modèle, l'utilisation de Scopes de requête est un bon choix.

Qu'est-ce que la portée de la requête éloquente?

En termes simples, la portée de la requête éloquente est une méthode définie dans le modèle pour ajouter quelques conditions de requête courantes. Vous pouvez le comprendre comme un "filtre prédéfini". Chaque fois que cette portée est appelée, les conditions de requête que vous avez définies seront automatiquement ajoutées.

Par exemple, si vous souhaitez filtrer tous les utilisateurs avec activé d'état, vous pouvez définir une portée active() , de sorte que lorsque vous vérifiez les utilisateurs actifs à l'avenir, vous n'avez pas à écrire where('status', 1) à chaque fois.

Comment définir et utiliser des lunettes locales

La définition d'une portée locale est simple, il vous suffit de créer une méthode commençant par scope dans le modèle.

 Scopeactive de fonction publique ($ Query)
{
    retourner $ query-> où ('statut', 1);
}

Ensuite, vous pouvez l'utiliser comme ceci:

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

Remarque: Le premier paramètre de la portée doit être $query , représentant le constructeur de requête actuel.

Les scénarios d'application courants comprennent:

• Filtre Publié Contenu: scopePublished()
• Filtre les enregistrements marqués comme supprimés en douceur: scopeNotDeleted()
• Requête par plage de temps: scopeLastWeek()

Comment utiliser des portées paramétrées

Parfois, vous voulez que la portée reçoive des paramètres. Par exemple, non seulement pour vérifier l'utilisateur avec "Status 1", mais souhaite également passer dans différentes valeurs d'état.

Cela peut être fait pour le moment:

 Fonction publique Scopestatus ($ Query, $ statut)
{
    retourner $ query-> où ('statut', $ status);
}

Passer les paramètres lorsque vous utilisez:

 User :: Status (2) -> get ();

Cette méthode est très adaptée aux scénarios où un transfert de valeur flexible est requis, tel que la recherche par mot-clé, le décalage de pagination, l'intervalle de temps, etc.

À quoi dois-je prêter attention lors de l'utilisation des étendues mondiales?

En plus des portées locales, Laravel prend en charge les lunettes mondiales, qui sont automatiquement appliquées chaque fois que le modèle est interrogé. Convient à l'isolement unifié des données, tels que l'accès uniquement aux données actuelles du locataire dans un système multi-locataire.

Pour utiliser la portée globale, vous devez créer une classe pour implémenter Illuminate\Database\Eloquent\Scope , puis appelez addGlobalScope() dans booted() du modèle.

 Fonction statique protégée démarrée ()
{
    statique :: addglobalscope ('locataire', fonction ($ builder) {
        $ builder-> où ('locant_id', locant_current_id ());
    });
}

Cependant, il convient de noter qu'une fois la portée globale ajoutée, elle ne peut pas être facilement supprimée . Si vous souhaitez le contourner temporairement, vous ne pouvez l'annuler qu'à l'aide de withoutGlobalScopes() .

Une petite astuce: combiner plusieurs lunettes

Vous pouvez combiner plusieurs lunettes comme les blocs de construction, tels que:

 User :: Active () -> Verified () -> récent () -> get ();

Chaque portée renvoie une instance de constructeur de requête, il peut donc être appelé dans une chaîne. Cette écriture est non seulement sémantique, mais aussi facile à tester et à maintenir.

De plus, si une requête est particulièrement complexe, plusieurs jugements conditionnels peuvent être encapsulés dans une portée, comme:

 Fonction publique ScopeFilter ($ Query, $ filtres)
{
    if (! vide ($ filters ['status'])) {
        $ query-> où ('statut', $ filters ['status']);
    }

    if (! vide ($ filters ['search'])) {
        $ query-> où ('name', 'like', '%'. $ filters ['search']. '%');
    }
}

De cette façon, les paramètres du filtre transmis à partir de l'extrémité avant peuvent être traités de manière centralisée.

Fondamentalement, c'est tout. Les portées de requête ne sont pas compliquées, mais sont très utiles dans le développement réel. L'utiliser rationnellement peut rendre votre modèle de calque de modèle et plus facile à écrire une logique de requête cohérente.

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!