Comment étendre une classe Laravel en utilisant la méthode macro?
Jul 31, 2025 am 11:45 AMVous pouvez utiliser des méthodes de macro pour étendre les classes qui utilisent des fonctionnalités macroables dans Laravel. 1. Assurez-vous que la classe cible (telle que la demande, la collection) utilise des fonctionnalités macroables; 2. Enregistrez les macros via ClassName :: macro (?méthodyname?, fermeture) dans la méthode de démarrage du fournisseur de services (telles que AppServiceProvider); 3. Appelez les méthodes personnalisées via des instances dans l'application, telles que $ request-> Isapirequest () ou $ collection-> AveRareStringLength (); 4. Notez que les macros sont valides à l'échelle mondiale, évitent de nommer les conflits et garantissent que la logique ne dépend pas du contexte statique, sauf si défini comme des macros statiques; Cette méthode est un schéma d'extension léger qui ne nécessite pas d'héritage ou de remplacement.
L'extension d'une classe Laravel à l'aide de la méthode macro
est un moyen propre et flexible d'ajouter des fonctionnalités personnalisées aux classes de base de Laravel - en particulier celles qui utilisent le trait Macroable
, comme Request
, Response
, Collection
, URL
et autres.

Voici comment vous pouvez le faire correctement:
? Quand pouvez-vous utiliser des macros?
Vous pouvez utiliser des macros uniquement sur les classes qui utilisent le trait Illuminate\Support\Traits\Macroable
. La plupart des cours de services publics de Laravel, comme:

-
Illuminate\Support\Collection
-
Illuminate\Http\Request
-
Illuminate\Http\Response
-
Illuminate\Routing\UrlGenerator
-
Illuminate\Support\Str
Si la classe n'utilise pas Macroable
, vous ne pouvez pas utiliser macro()
.
? ? étape par étape: ajout d'une macro
Disons que vous souhaitez ajouter une méthode personnalisée à la classe Request
pour vérifier si l'application s'exécute en mode API en fonction du préfixe d'itinéraire.

1. Enregistrez la macro
Vous devez enregistrer les macros au début du cycle de vie de l'application - le meilleur endroit est dans un fournisseur de services .
Créer ou utiliser un fournisseur de services existant (par exemple, AppServiceProvider
):
// app / fournisseurs / appserviceprovider.php Utiliser illuminate \ http \ request; Utiliser illuminate \ support \ ServiceProvider; Class AppServiceProvider étend ServiceProvider { Boot de fonction publique () { Request :: macro ('Isapirequest', function () { return $ this-> Route () -> getPrefix () === 'API'; }); // Vous pouvez ajouter plus de macros ici } }
? La méthode
macro
prend deux arguments:
- Nom de la méthode (comme une cha?ne)
- Fermeture qui sera exécutée lorsque la méthode est appelée
2. Utilisez la macro dans votre application
Vous pouvez maintenant appeler isApiRequest()
sur n'importe quelle instance Request
:
Utiliser illuminate \ http \ request; Poignée de la fonction publique (demande $ demande) { if ($ request-> Isapirequest ()) { // gérer la logique de l'API } }
Ou dans un itinéraire:
Route :: get ('/ test', fonction (demande $ demande) { return réponse () -> JSON (['is_api' => $ request-> Isapirequest ()]); });
? Exemple avancé: Collection d'étendue
Ajoutons une macro à Collection
pour calculer la durée moyenne des cha?nes:
Utiliser illuminate \ support \ collection; Utiliser illuminate \ support \ ServiceProvider; Collection :: macro ('AverAreAstringLength', function () { return $ this-> avg (fonction ($ string) { return strlen ($ string); }); });
Usage:
$ collection = Collect (['Hello', 'World', 'Hi']); echo $ collection-> AverAreAstringLength (); // 3.67
?? Remarques importantes
- Les macros sont mondiales - une fois enregistrés, ils sont disponibles partout.
- Enregistrer les macros dans
boot()
d'un fournisseur de services, et nonregister()
. - évitez de nommer les conflits - ne remplacez pas les méthodes existantes sauf si prévu.
- Les fermetures se lient à l'instance de classe -
this
à l'intérieur des références de fermeture à l'objet (par exemple, la demande), vous pouvez donc accéder à ses méthodes et propriétés.
? Macros statiques (facultative)
Vous pouvez également ajouter des macros statiques à l'aide macro()
- la fermeture sera appelée statiquement. Assurez-vous simplement que votre logique ne reposait pas sur le contexte d'instance.
Demande :: macro ('CreateTestRequest', fonction ($ uri) { Return Demande :: Create ($ uri, 'get'); });
Puis appelez:
$ request = request :: CreateTestRequest ('/ api / utilisateurs');
? Résumé
- Utilisez
ClassName::macro('methodName', function () { ... })
pour étendre les classes Laravel. - Fonctionne uniquement sur les classes en utilisant le trait
Macroable
. - Enregistrez les macros dans la méthode
boot()
d'un fournisseur de services. - Idéal pour ajouter des services publics réutilisables sans héritage ni remplacement.
Fondamentalement, c'est une fa?on légère de "singe-patch" Laravel cours - proprement et en toute sécurité.
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!

Outils d'IA chauds

Undress AI Tool
Images de déshabillage gratuites

Undresser.AI Undress
Application basée sur l'IA pour créer des photos de nu réalistes

AI Clothes Remover
Outil d'IA en ligne pour supprimer les vêtements des photos.

Clothoff.io
Dissolvant de vêtements AI

Video Face Swap
échangez les visages dans n'importe quelle vidéo sans effort grace à notre outil d'échange de visage AI entièrement gratuit?!

Article chaud

Outils chauds

Bloc-notes++7.3.1
éditeur de code facile à utiliser et gratuit

SublimeText3 version chinoise
Version chinoise, très simple à utiliser

Envoyer Studio 13.0.1
Puissant environnement de développement intégré PHP

Dreamweaver CS6
Outils de développement Web visuel

SublimeText3 version Mac
Logiciel d'édition de code au niveau de Dieu (SublimeText3)

Sujets chauds

Il existe trois fa?ons d'ajouter des règles de validation personnalisées dans Laravel: en utilisant les fermetures, les classes de règles et les demandes de formulaire. 1. Utilisez les fermetures pour être adaptées à la vérification légère, comme empêcher le nom d'utilisateur "admin"; 2. Créez des classes de règles (telles que ValidUsernamerule) pour rendre la logique complexe plus claire et maintenable; 3. Intégrer plusieurs règles dans les demandes de formulaire et gérer de manière centralisée la logique de vérification. Dans le même temps, vous pouvez définir des invites via des méthodes de messages personnalisés ou des réseaux de messages d'erreur entrants pour améliorer la flexibilité et la maintenabilité.

Les méthodes de base pour les applications Laravel pour implémenter le support multilingue comprennent: la définition des fichiers linguistiques, la commutation de langage dynamique, le routage des URL de traduction et la gestion des clés de traduction dans les modèles de lame. Tout d'abord, organisez les cha?nes de chaque langue dans les dossiers correspondants (tels que EN, ES, FR) dans le répertoire / Resources / Lang, et définissez le contenu de traduction en renvoyant le tableau associatif; 2. Traduire la valeur de clé via l'appel de fonction d'assistance \ _ \ _ () et utilisez l'application :: setLocale () pour combiner des paramètres de session ou de routage pour réaliser la commutation du langage; 3. Pour les URL de traduction, les chemins peuvent être définis pour différentes langues via des groupes de routage préfixés ou par voie d'alias dans les fichiers linguistiques mappés dynamiquement; 4. Gardez les touches de traduction concises et

TOWORKEFFECTECTEMENTSWitHPivottablesInLaravel, FirstAccessPivotDatauSingWithPivot () Orwithtimestamps (), ThepDateEntrieswitHupDateExistPivot (), ManagerLeshipSviaDeTache

LaravelprovidesAcleanAndFlexiblewayToSendNotificationsViamultipleChannelsLikeEmail, SMS, In-Appakets, andpushNotifications.youdefinenotificationChannelsInthevia () MethodofanotificationClass, ANDIDEFINENOTIFICATIONSECHETHODSLIKETOMAIL (), ToDatabase (), Ortovonage

ServiceProvider est le mécanisme de base utilisé dans le cadre Laravel pour l'enregistrement des services et l'initialisation de la logique. Vous pouvez créer un ServiceProvider personnalisé via la commande Artisan; 1. La méthode de registre est utilisée pour lier les services, enregistrer des singletons, définir des alias, etc., et d'autres services qui n'ont pas encore été chargés ne peuvent pas être appelés; 2. La méthode de démarrage s'exécute après que tous les services sont enregistrés et sont utilisés pour enregistrer les écouteurs d'événements, afficher les synthétiseurs, middleware et autres logiques qui dépend d'autres services; Les utilisations courantes incluent les interfaces et les implémentations de liaison, l'enregistrement des fa?ades, le chargement des configurations, l'enregistrement des instructions de ligne de commande et des composants de vue; Il est recommandé de centraliser les liaisons pertinentes à un ServiceProvider pour gérer et de faire attention à l'enregistrement

Les méthodes de base pour gérer les exceptions et les erreurs d'enregistrement dans les applications Laravel incluent: 1. Utilisez la classe App \ Exceptions \ Handler pour gérer de manière centralisée les exceptions non gérées, et enregistrer ou notifier les informations d'exception via la méthode Report (), telles que l'envoi de notifications Slack; 2. Utilisez Monolog pour configurer le système de journal, définissez le niveau de journal et la méthode de sortie dans config / logging.php et activer les journaux d'erreur et supérieurs à l'environnement de production. Dans le même temps, des informations d'exception détaillées peuvent être enregistrées manuellement dans report () en combinaison avec le contexte; 3. Personnalisez la méthode Render () pour retourner une réponse d'erreur de format JSON unifié, améliorant l'efficacité de collaboration de l'extrémité avant et arrière de l'API. Ces étapes sont

L'injection de dépendance gère automatiquement les dépendances de classe via des conteneurs de service dans Laravel sans de nouveaux objets manuels. Son noyau est l'injection de constructeur et l'injection de méthode, comme le passage automatiquement de l'instance de demande dans le contr?leur. Laravel analyse les dépendances via des invites de type et crée récursivement les objets requis. L'interface de liaison et l'implémentation peuvent être utilisées par le fournisseur de services pour utiliser la méthode Bind, ou singleton pour lier un singleton. Lorsque vous l'utilisez, vous devez vous assurer des invites de type, éviter les complications du constructeur, utiliser les liaisons contextuelles avec prudence et comprendre les règles d'analyse automatique. La ma?trise peut améliorer la flexibilité et la maintenance du code.

L'optimisation des performances de Laravel peut améliorer l'efficacité de l'application à travers quatre directions de base. 1. Utilisez le mécanisme de cache pour réduire les requêtes en double, stocker rarement la modification des données via Cache :: Remember () et d'autres méthodes pour réduire la fréquence d'accès à la base de données; 2. Optimiser la base de données de la requête du modèle aux requêtes, évitez les requêtes N 1, spécifiant les requêtes de champ, ajoutant des index, pagination de traitement et de lecture et de séparation d'écriture et réduire les goulots d'étranglement; 3. Utilisez des opérations longues telles que l'envoi d'e-mails et l'exportation de fichiers vers le traitement asynchrone de file d'attente, utilisez le superviseur pour gérer les travailleurs et configurer des mécanismes de réessayer; 4. Utilisez raisonnablement les fournisseurs de middleware et de services pour éviter une logique complexe et un code d'initialisation inutile et retarder le chargement des services pour améliorer l'efficacité du démarrage.
