Laravel Middleware (middleware) Combat pratique: contrôle de l'autorisation et journalisation

Dans Laravel, le middleware est utilisé pour implémenter le contrôle et la journalisation de l'autorisation. 1) Créez du middleware de contrôle d'autorisation et décidez d'autoriser l'accès en vérifiant les autorisations des utilisateurs. 2) Créez du middleware de journalisation pour enregistrer des informations détaillées sur les demandes et les réponses.

introduction

Dans le développement de Laravel, le middleware est un outil puissant et flexible qui peut exécuter une logique spécifique avant ou après la demande atteint l'application. Aujourd'hui, nous plongerons dans la façon d'utiliser le middleware pour implémenter le contrôle et la journalisation des autorisations, deux fonctionnalités qui sont très courantes et importantes dans les projets réels. Grâce à cet article, vous apprendrez à créer et à utiliser des middleware, à comprendre comment cela fonctionne et à maîtriser certains conseils pratiques et meilleures pratiques.

Examen des connaissances de base

Dans Laravel, le middleware est la couche intermédiaire qui gère les demandes HTTP. Ils peuvent être utilisés pour filtrer les demandes, modifier les demandes et les réponses et exécuter une logique commune. Le concept de middleware est similaire à un pipeline. Lorsque les demandes passent par ce pipeline, elles peuvent être interceptées et traitées par middleware.

Laravel fournit plusieurs middleware intégrés, tels que auth Middleware pour vérifier si l'utilisateur est connecté csrf pour empêcher les attaques de contrefaçon de demande croisée. Nous pouvons facilement créer des middleware personnalisés pour répondre aux besoins spécifiques.

Analyse du concept de base ou de la fonction

Définition et fonction du middleware

Le middleware est une classe de Laravel qui implémente les méthodes handle . Cette méthode reçoit l'objet de demande et une fermeture (représentant la prochaine étape de traitement de la demande), peut traiter la demande, puis décider de passer la demande au middleware suivant ou de renvoyer directement la réponse.

Le middleware a une fonction très large, de la journalisation simple de demande au contrôle complexe d'autorisation, il peut être implémenté via middleware. Son avantage est qu'il peut être retiré du contrôleur, ce qui rend le code plus clair et plus maintenable.

Un exemple de middleware simple:

 namespace app \ http \ middleware;

Utiliser la fermeture;
Utiliser illuminate \ http \ request;

Classe LogRequestMiddleware
{
    Poignée de la fonction publique (demande $ demande, fermeture $ suivant)
    {
        // Journal du journal avant que la demande ne soit traitée \ log :: info ('requête reçue:'. $ Request-> méthode (). ''. $ Request-> url ());

        // Passez la demande au middleware ou contrôleur suivant Retour $ Next ($ request);
    }
}

Comment ça marche

Lorsqu'une demande entre dans une application Laravel, elle passe par un pipeline middleware. Chaque middleware peut traiter la demande, puis décider de passer la demande au middleware suivant ou de renvoyer la réponse directement.

L'Ordre d'exécution du middleware est défini par $middleware et $routeMiddleware dans le fichier Kernel.php . Les demandes sont passées par le middleware dans l'ordre dans ces tableaux.

Lors du traitement d'une demande, le middleware peut:

1. Modifier l'objet de demande
2. Exécuter une logique (comme la journalisation)
3. Décidez de passer la demande au middleware ou contrôleur suivant
4. Modifier l'objet de réponse (dans la méthode terminate )

Le principe de travail du middleware est similaire au modèle d'oignon. Demandes entrent à partir de la couche externe, traitées par plusieurs middleware, et enfin arrivez au contrôleur, puis passez-la de la couche intérieure à la couche extérieure, puis renvoyez-la au client après le traitement par le middleware.

Exemple d'utilisation

Contrôle d'autorisation Middleware

Dans les projets réels, le contrôle de l'autorisation est une exigence commune. Nous pouvons créer un middleware pour vérifier si l'utilisateur a la permission d'accéder à un certain itinéraire.

 namespace app \ http \ middleware;

Utiliser la fermeture;
Utiliser illuminate \ http \ request;
Utiliser illuminate \ support \ FACADES \ Auth;

Class CheckPermissionMiddleware
{
    Poignée de la fonction publique (demande $ demande, fermeture $ suivant, autorisation $)
    {
        if (auth :: user () -> can ($ permission)) {
            retourner $ suivant ($ demande);
        }

        return réponse () -> json (['error' => 'non autorisé'], 403);
    }
}

Lorsque vous utilisez ce middleware, vous pouvez spécifier les autorisations requises dans la définition de routage:

 Route :: get ('/ admin', function () {
    // Seuls les utilisateurs avec l'autorisation «manage-admin» peuvent y accéder}) -> middleware («permission: manage-admin»);

Journalisation du middleware

La journalisation est également une exigence commune, nous pouvons créer un middleware pour enregistrer les détails de chaque demande.

 namespace app \ http \ middleware;

Utiliser la fermeture;
Utiliser illuminate \ http \ request;
Utiliser illuminate \ support \ FACADES \ Log;

Classe LogRequestMiddleware
{
    Poignée de la fonction publique (demande $ demande, fermeture $ suivant)
    {
        // Journal des informations sur la demande de journal :: info («demande reçue», [
            'méthode' => $ demande-> méthode (),
            'url' => $ request-> url (),
            'Headers' => $ request-> Headers-> all (),
            'body' => $ demande-> all (),
        ]));

        retourner $ suivant ($ demande);
    }

    Fonction publique Termine (demande $ demande, $ Response)
    {
        // Enregistrer le journal des informations de réponse :: info ('réponse envoyée', [
            'status' => $ réponse-> getStaturScode (),
            'contenu' => $ réponse-> getContent (),
        ]));
    }
}

Erreurs courantes et conseils de débogage

Certains problèmes courants peuvent survenir lors de l'utilisation du middleware:

• Problème de commande middleware : si le middleware est incorrectement exécuté, cela peut entraîner des erreurs logiques. Par exemple, la vérification de l'autorisation Middleware doit être exécutée avant de journaliser le middleware pour éviter les demandes de journalisation non autorisées.
• Erreur de passage des paramètres middleware : lors de l'utilisation du middleware avec des paramètres, assurez-vous que le passage des paramètres est correct. Par exemple, dans CheckPermissionMiddleware , le paramètre $permission doit être passé correctement.
• Middleware non enregistré : assurez-vous que le middleware est correctement enregistré dans le fichier Kernel.php , sinon le middleware ne sera pas exécuté.

Lors du débogage de ces problèmes, vous pouvez utiliser le système de journalisation de Laravel pour enregistrer l'exécution du middleware ou utiliser des outils de débogage (tels que XDebug) pour suivre le processus de demandes.

Optimisation des performances et meilleures pratiques

Il existe des optimisations de performances et des meilleures pratiques à noter lors de l'utilisation de middleware:

• Évitez d'effectuer des opérations longues en middleware : le middleware doit être aussi léger que possible pour éviter d'effectuer des requêtes de base de données ou d'autres opérations longues dans le middleware pour éviter d'affecter le temps de réponse de la demande.
• En utilisant le cache : dans le middleware de vérifier l'autorisation, vous pouvez utiliser Cache pour stocker les informations d'autorisation de l'utilisateur pour éviter d'interroger la base de données à chaque fois que vous demandez.
• Optimisation de la journalisation : Dans le middleware de journalisation, le niveau de détail du journal peut être ajusté en fonction de l'environnement (tel que l'environnement de production ou l'environnement de développement) pour éviter d'enregistrer trop d'informations sur les journaux dans l'environnement de production.

Lors de l'écriture de middleware, vous devez également prêter attention à la lisibilité et à la maintenabilité du code:

• Utilisez la dénomination claire : la classe et les noms de méthode du middleware doivent exprimer clairement leurs fonctions.
• Ajoutez des commentaires : ajoutez des commentaires aux parties clés du middleware pour expliquer ses principes de rôle et de mise en œuvre.
• Gardez la responsabilité unique du middleware : chaque middleware doit être responsable d'une seule fonction, en évitant de mettre plusieurs logiques non pertinentes dans le même middleware.

Grâce à cet article, vous auriez dû maîtriser comment utiliser le middleware dans Laravel pour implémenter le contrôle et la journalisation des autorisations. Espérons que ces connaissances et techniques fonctionneront dans votre projet et vous aideront à écrire plus efficace et plus facile à maintenir le code.

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!