Français
Français
Dans de nombreuses applications PHP, nous devons souvent traiter les informations de la version du client, en particulier lorsque vous interagissez avec les interfaces API, les applications Web ou les appareils mobiles, le numéro de version client est très important. Généralement, il existe de nombreuses façons d'obtenir des informations sur la version client, qui peuvent être obtenues à partir d'en-têtes de demande, de paramètres d'URL ou de cookies. Mais en tout cas, l'implémentation logique de la fonction get_client_version doit souvent être utilisée à plusieurs endroits. Par conséquent, afin d'améliorer la réutilisabilité, la maintenabilité et la clarté du code, nous pouvons gérer ces logiques uniformément par middleware.
Le middleware fait référence à un module fonctionnel exécuté avant qu'une demande entre dans l'application ou avant qu'une réponse ne soit envoyée au client. Il est généralement utilisé pour effectuer certaines tâches courantes, telles que la vérification, la journalisation, le traitement des demandes, la vérification des autorisations, etc. En PHP, en particulier lorsque vous utilisez des cadres comme Laravel, Symfony, le middleware est un concept très important, qui peut nous aider à nous concentrer sur certaines tâches répétitives.
Supposons que nous ayons une fonction get_client_version , qui est utilisée pour obtenir des informations de version client à partir des demandes HTTP, cette fonction peut être utilisée à de nombreux endroits. Si vous devez répéter la même logique à chaque fois, il ne se conforme évidemment pas au principe sec (ne vous répétez pas). Grâce au middleware, nous pouvons encapsuler cette logique dans un flux de traitement commun, en évitant les implémentations répétées dans chaque contrôleur ou itinéraire.
Nous introduirons en étape par étape comment utiliser le middleware pour gérer uniformément la logique de la fonction get_client_version en php.
Tout d'abord, nous devons créer une classe de middleware dans notre application PHP. Ce middleware sera chargé d'obtenir des informations sur la version client.
En supposant que nous utilisons le framework Laravel, la commande pour créer le middleware est la suivante:
php artisan make:middleware ClientVersionMiddleware
Dans le fichier APP / HTTP / middleware / ClientVersionMiddleware.php , nous rédigerons la logique pour obtenir la version client. Par exemple, la version client peut être dans l' en-tête demandé ou transmise par le paramètre Get . Nous pouvons le gérer en fonction des besoins réels.
namespace App\Http\Middleware;
use Closure;
use Illuminate\Http\Request;
class ClientVersionMiddleware
{
public function handle(Request $request, Closure $next)
{
// Supposons que la version client est dans l'en-tête de demande
$clientVersion = $request->header('Client-Version');
// Si les informations de la version ne sont pas trouvées dans l'en-tête de demande，PeutURLObtenir les paramètres de
if (!$clientVersion) {
$clientVersion = $request->query('client_version');
}
// Si les informations de la version ne sont toujours pas trouvées，La version par défaut peut être utilisée
if (!$clientVersion) {
$clientVersion = '1.0.0'; // Numéro de version par défaut
}
// Enregistrer les informations de version dans la demande，Pour une utilisation ultérieure
$request->attributes->set('client_version', $clientVersion);
// Continuer à traiter la demande
return $next($request);
}
}
Dans le code ci-dessus, nous essayons d'abord d'obtenir la valeur du champ Client-Version à partir de l'en-tête de demande, et s'il n'est pas trouvé, il est récupéré à partir du paramètre URL client_version . S'il n'est toujours pas trouvé, nous pouvons définir un numéro de version par défaut.
Ensuite, nous devons enregistrer ce middleware dans l'application. Dans Laravel, nous pouvons enregistrer le middleware dans le fichier APP / HTTP / Kernel.php .
protected $routeMiddleware = [
// Autres middleware...
'client_version' => \App\Http\Middleware\ClientVersionMiddleware::class,
];
Nous pouvons maintenant utiliser ce middleware dans l'itinéraire ou le contrôleur. Par exemple, lorsqu'il est utilisé dans un routage, vous pouvez écrire ceci:
Route::get('/some-endpoint', function (Request $request) {
$clientVersion = $request->get('client_version');
return response()->json(['client_version' => $clientVersion]);
})->middleware('client_version');
Dans cet exemple, nous utilisons le middleware Client_version et obtenons la valeur de client_version dans l'itinéraire. Si le client fournit des informations de version dans la demande, elle sera transmise à l'itinéraire via le middleware.
Après avoir implémenté le middleware et l'appliquer à l'itinéraire, vous pouvez tester l'acquisition du numéro de version avec différentes demandes. Par exemple, vous pouvez le tester de la manière suivante:
Demandez en-tête avec champ de version client
Demande URL avec le paramètre Client_Version
Utilisez des valeurs par défaut lorsqu'aucune information de version n'est fournie
Grâce au middleware, la logique de la fonction get_client_version peut être traitée uniformément, la maintenabilité et la réutilisabilité du code peuvent être considérablement améliorées. Nous avons juste besoin d'écrire la logique pour obtenir la version une fois dans le middleware, puis transmettre les informations de version à toutes les demandes de l'application via le middleware. Cette approche simplifie non seulement le code, mais rend également la gestion des versions plus centralisée et cohérente.
