Limitation du débit et versionnement d’API
Limiter les requêtes avec RateLimiter et versionner proprement votre API.
Limitation du débit et versionnement d’API est une leçon PHP Academy gratuite sur CoddyKit. Ceci est la leçon 4 sur 4. Tu peux lire la leçon complète ci-dessous gratuitement — puis la pratiquer en direct dans le navigateur avec un éditeur de code intégré et un tuteur IA 24/7. Elle fait partie du parcours d'apprentissage PHP Academy, et ta progression se synchronise sur le web et l'application CoddyKit. Le cours PHP Academy comprend 4 leçons au total.
Pourquoi limiter le débit ?
La limitation du débit protège les API contre les abus, les attaques par déni de service et les clients hors de contrôle. Elle garantit une répartition équitable des ressources entre tous les utilisateurs.
Limiteur intégré de Laravel
Appliquez l’intergiciel throttle pour limiter le nombre de requêtes par période.
<?php
Route::middleware("throttle:60,1")->group(function () {
// 60 requests per 1 minute per user/IP
Route::apiResource("posts", PostController::class);
});Limiteurs de débit personnalisés
Définissez des limiteurs de débit nommés avec une logique personnalisée dans un fournisseur de services.
<?php
// In AppServiceProvider::boot():
RateLimiter::for("api", function (Request $request) {
return Limit::perMinute(60)->by($request->user()?->id ?: $request->ip());
});
// Apply:
Route::middleware("throttle:api")->group(fn() => ...);Limitation de débit par niveaux
Renvoyez des limites différentes selon le forfait de l’utilisateur authentifié.
<?php
RateLimiter::for("api", function (Request $request) {
return match($request->user()?->plan) {
"pro" => Limit::perMinute(300)->by($request->user()->id),
"free" => Limit::perMinute(60)->by($request->user()?->id ?: $request->ip()),
default => Limit::perMinute(30)->by($request->ip()),
};
});En-têtes de réponse de limitation de débit
Lorsque la limite est atteinte, Laravel renvoie le code HTTP 429 avec les en-têtes suivants : X-RateLimit-Limit, X-RateLimit-Remaining, Retry-After.
Stratégies de gestion des versions d’API
Trois approches courantes :
- Préfixe d’URL :
/api/v1/users - Paramètre de requête :
/api/users?version=1 - En-tête Accept :
Accept: application/vnd.myapp.v1+json
Le préfixe d’URL est l’approche la plus courante dans les API Laravel.
Gestion des versions par préfixe d’URL
Regroupez les routes sous un préfixe de version.
<?php
Route::prefix("v1")->group(function () {
Route::apiResource("users", \App\Http\Controllers\Api\V1\UserController::class);
});
Route::prefix("v2")->group(function () {
Route::apiResource("users", \App\Http\Controllers\Api\V2\UserController::class);
});Contrôleurs spécifiques à chaque version
Organisez les contrôleurs par version dans des sous-répertoires : App\Http\Controllers\Api\V1\ et App\Http\Controllers\Api\V2\.
Abandon des anciennes versions
Ajoutez un en-tête Deprecation ou Sunset aux réponses des anciennes versions afin d’informer les clients de leur suppression prochaine.
<?php
// Middleware for v1 routes:
$response->headers->set("Deprecation", "version="v1"");
$response->headers->set("Sunset", "2026-01-01");Ressources d’API et gestion des versions
Utilisez des ressources d’API spécifiques à chaque version : V1\UserResource et V2\UserResource pour définir des structures de réponse différentes selon la version.
Tester les limites de débit
Lors des vérifications, simulez le limiteur de débit afin d’éviter les interférences entre les vérifications.
<?php
RateLimiter::shouldReceive("tooManyAttempts")->andReturn(false);Résumé
Appliquez throttle:60,1 pour une limitation de débit élémentaire. Utilisez RateLimiter::for() pour des limites personnalisées et par niveaux. Versionnez les API avec des préfixes d’URL, des contrôleurs et des ressources spécifiques à chaque version.
Vérification rapide
Quel code d’état HTTP Laravel renvoie-t-il lorsque la limite de débit est dépassée ?
Questions Fréquemment Posées
La leçon « Limitation du débit et versionnement d’API » est-elle gratuite ?
Oui — le texte complet de « Limitation du débit et versionnement d’API » est gratuit à lire ici sur le web. Pour la pratiquer de manière interactive (un éditeur de code intégré et un tuteur IA 24/7) et déverrouiller le reste du cours PHP Academy, passe à CoddyKit PRO. Le cours PHP Academy comprend 4 leçons au total.
Qu'est-ce que j'apprendrai dans « Limitation du débit et versionnement d’API » ?
Limiter les requêtes avec RateLimiter et versionner proprement votre API. Tu pratiques PHP Academy avec du code pratique que tu exécutes directement dans le navigateur, et un tuteur IA 24/7 répond à tes questions au fur et à mesure que tu avances dans la leçon.
Dois-je avoir de l'expérience pour commencer PHP Academy ?
Aucune expérience préalable n'est requise. PHP Academy sur CoddyKit est structuré pour les débutants jusqu'aux apprenants avancés, donc tu peux commencer ici ou depuis le début et avancer à ton rythme. Ceci est la leçon 4 sur 4.
Combien de temps prend la leçon « Limitation du débit et versionnement d’API » ?
La plupart des leçons CoddyKit prennent environ 5–10 minutes. Chacune est courte et interactive, tu progresses régulièrement et tu repiques exactement où tu t'es arrêté sur le web et l'app.
Peux-tu écrire et exécuter du code dans cette leçon PHP Academy ?
Oui. Chaque leçon PHP Academy inclut un éditeur de code intégré, tu écris et exécutes du vrai code directement dans ton navigateur et tu reçois des retours IA instantanés — aucune configuration locale requise.
Toutes les leçons de ce cours
- Routes d’API et contrôleurs de ressources
- Ressources d’API et réponses JSON
- Authentification avec Laravel Sanctum
- Limitation du débit et versionnement d’API