Maison >développement back-end >tutoriel php >Comment fonctionne le middleware Laravel et comment l'utiliser

Comment fonctionne le middleware Laravel et comment l'utiliser

王林
王林original
2023-08-02 10:13:171360parcourir

Le principe de fonctionnement et les compétences d'utilisation du middleware Laravel

1. Introduction
Dans le framework Laravel, le middleware est une fonction très importante qui peut être utilisée pour exécuter certaines fonctions avant ou après que la requête n'atteigne la route de l'application. Le middleware fournit non seulement un moyen concis et flexible de gérer les demandes, mais peut également être utilisé pour gérer une série d'opérations telles que l'authentification, le contrôle des autorisations et la journalisation. Cet article présentera le principe de fonctionnement et les compétences d'utilisation du middleware Laravel, et fournira des exemples de code pour illustrer.

2. Comment fonctionne le middleware
Dans le framework Laravel, le middleware est défini dans le répertoire app/Http/Middleware. Vous pouvez créer un nouveau fichier middleware via la ligne de commande ou manuellement. Le concept de base du middleware est une fonction de fermeture, qui accepte deux paramètres : un objet de requête et une fonction de fermeture, et renvoie un objet de réponse. app/Http/Middleware目录中,可以通过命令行或者手动创建一个新的中间件文件。中间件的核心概念是一个闭包函数,它接受两个参数:一个请求对象和一个闭包函数,同时返回一个响应对象。

当应用程序收到一个HTTP请求时,该请求会通过应用程序的中间件层。在中间件层中,请求会按照定义的顺序逐个通过中间件进行处理。中间件可以对请求进行预处理、身份验证、修改请求参数、记录日志等操作,然后将请求传递给下一个中间件或路由处理。

如果一个中间件对请求进行了处理,它可以选择返回一个响应对象,将该响应直接发送给客户端,从而终止整个请求-响应过程。否则,请求将继续向下传递,直到找到一个中间件处理请求或最终到达路由。

三、中间件的使用技巧

  1. 注册中间件
    在使用中间件之前,需要将其注册到应用程序中。在Laravel框架中,可以通过编辑app/Http/Kernel.php文件的$middleware属性来注册全局中间件,或者通过$routeMiddleware属性来注册路由中间件。例如,我们可以将一个名为CheckToken的中间件注册为全局中间件:
protected $middleware = [
    AppHttpMiddlewareCheckToken::class,
];
  1. 路由中间件
    除了全局中间件之外,Laravel还提供了一种称为路由中间件的机制。路由中间件允许您为特定的路由定义中间件,从而使中间件仅应用于该路由。要定义一个路由中间件,可以在$routeMiddleware属性中添加一个键-值对。例如,我们可以定义一个名为CheckRole的路由中间件:
protected $routeMiddleware = [
    'checkRole' => AppHttpMiddlewareCheckRole::class,
];

然后,在路由定义中使用该中间件:

Route::get('/admin', function () {
    //
})->middleware('checkRole');
  1. 中间件的顺序
    中间件在应用程序中的注册顺序非常重要,它决定了中间件的执行顺序。在$middleware属性或路由定义中,优先级较高的中间件会先被执行。可以使用php artisan route:list命令来查看中间件的执行顺序。
  2. 中间件的路由分组
    除了为特定路由定义中间件之外,Laravel还允许为路由分组定义中间件。这样,指定分组的路由将自动应用其中间件。例如,要为所有后台路由定义一个admin中间件组,可以这样做:
Route::group(['middleware' => 'admin'], function () {
    //
});

这样,所有在该分组中定义的路由将应用admin中间件。

四、示例代码
为了进一步理解和使用中间件,以下是一个简单的示例代码。假设我们有一个需要身份验证的API接口,我们可以使用中间件来处理身份验证,并在未通过验证时返回一个错误响应。

  1. 创建一个新的中间件:
php artisan make:middleware Authenticate
  1. app/Http/Middleware/Authenticate.php文件中,编写如下代码:
<?php

namespace AppHttpMiddleware;

use Closure;
use IlluminateHttpRequest;

class Authenticate
{
    public function handle(Request $request, Closure $next)
    {
        $token = $request->header('Authorization');

        if ($token != 'secret_token') {
            return response()->json(['error' => 'Unauthorized'], 401);
        }

        return $next($request);
    }
}
  1. 将中间件注册为全局中间件,在app/Http/Kernel.php文件的$middleware属性中添加如下代码:
protected $middleware = [
    AppHttpMiddlewareAuthenticate::class,
];
  1. 在路由定义中使用中间件:
Route::get('/api', function () {
    //
})->middleware('auth');

上述代码将会检查请求头中的Authorization字段,并与secret_token

Lorsqu'une application reçoit une requête HTTP, la requête passe par la couche middleware de l'application. Dans la couche middleware, les requêtes sont traitées une par une via le middleware dans un ordre défini. Le middleware peut prétraiter, authentifier, modifier les paramètres de la demande, enregistrer les journaux, etc. sur la demande, puis transmettre la demande au middleware ou à la route suivante pour traitement.

Si un middleware traite la demande, il peut choisir de renvoyer un objet de réponse et d'envoyer la réponse directement au client, mettant ainsi fin à l'ensemble du processus demande-réponse. Sinon, la requête continuera à être transmise jusqu'à ce qu'elle trouve un middleware pour gérer la requête ou atteigne enfin un itinéraire.

3. Conseils pour l'utilisation du middleware🎜
  1. Enregistrement du middleware🎜Avant d'utiliser le middleware, vous devez l'enregistrer dans l'application. Dans le framework Laravel, vous pouvez enregistrer un middleware global en modifiant l'attribut $middleware du fichier app/Http/Kernel.php, ou via $routeMiddleware code > propriétés pour enregistrer le middleware de routage. Par exemple, nous pouvons enregistrer un middleware nommé <code>CheckToken comme middleware global :
rrreee
  1. Middleware de routage 🎜Sauf En plus du middleware global middleware, Laravel fournit également un mécanisme appelé middleware de routage. Le middleware de route vous permet de définir un middleware pour une route spécifique afin que le middleware s'applique uniquement à cette route. Pour définir un middleware de route, ajoutez une paire clé-valeur dans l'attribut $routeMiddleware. Par exemple, nous pouvons définir un middleware de routage nommé CheckRole :
rrreee🎜 Ensuite, utiliser le middleware dans la définition de la route : 🎜rrreee
    L'ordre des middlewares 🎜L'ordre dans lequel les middlewares sont enregistrés dans l'application est très important, car il détermine l'ordre dans lequel les middlewares sont exécutés. Dans l'attribut $middleware ou la définition de route, le middleware ayant la priorité la plus élevée sera exécuté en premier. Vous pouvez utiliser la commande php artisan route:list pour afficher l'ordre d'exécution du middleware.
  1. Regroupement de routes de middleware 🎜En plus de définir un middleware pour des routes spécifiques, Laravel permet également de définir un middleware pour des regroupements de routes. De cette façon, la route du groupe spécifié verra automatiquement son middleware appliqué. Par exemple, pour définir un groupe middleware admin pour toutes les routes en arrière-plan, vous pouvez faire ceci :
rrreee🎜De cette façon, toutes les routes définies dans ce groupe appliqueront administrateurmiddleware. 🎜🎜4. Exemple de code🎜Afin de mieux comprendre et utiliser le middleware, voici un exemple de code simple. Supposons que nous ayons une interface API qui nécessite une authentification, nous pouvons utiliser un middleware pour gérer l'authentification et renvoyer une réponse d'erreur lorsque l'authentification n'est pas réussie. 🎜
  1. Créez un nouveau middleware :
rrreee
  1. Dans app/Http/Middleware/Authenticate.phpDans le fichier, écrivez le code suivant :
rrreee
  1. Enregistrez le middleware en tant que middleware global dans app/Http/Kernel.php Ajoutez ce qui suit code à l'attribut <code>$middleware du fichier code> :
rrreee
  1. Utiliser le middleware dans la définition de la route :
rrreee🎜Le code ci-dessus vérifiera le champ Autorisation dans l'en-tête de la requête et le comparera avec secret_token. Si la vérification réussit, passez au middleware ou à la route suivante. Sinon, renvoyez une réponse d'erreur au format JSON avec le code d'état 401. 🎜🎜Ce n'est qu'un exemple simple, les scénarios d'utilisation réels et la logique du middleware peuvent être plus complexes. Cependant, en apprenant et en maîtrisant le fonctionnement du middleware Laravel et comment l'utiliser, vous pourrez mieux les comprendre et les utiliser pour améliorer les performances et la sécurité de votre application. 🎜🎜Pour résumer, cet article présente le principe de fonctionnement et les compétences d'utilisation du middleware Laravel, et fournit un exemple de code simple. En appliquant correctement le middleware, vous pouvez mieux contrôler le processus de traitement des demandes et obtenir des applications plus efficaces et plus sécurisées. J'espère que cet article pourra vous être utile. 🎜

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!

Déclaration:
Le contenu de cet article est volontairement contribué par les internautes et les droits d'auteur appartiennent à l'auteur original. Ce site n'assume aucune responsabilité légale correspondante. Si vous trouvez un contenu suspecté de plagiat ou de contrefaçon, veuillez contacter admin@php.cn