0Pricing
PHP Academy · Lekcja

Ograniczanie częstotliwości i wersjonowanie API

Ograniczaj żądania za pomocą RateLimiter i przejrzyście wersjonuj API

Ograniczanie częstotliwości i wersjonowanie API to bezpłatna lekcja PHP Academy na CoddyKit. To lekcja 4 z 4. Możesz przeczytać całą lekcję poniżej za darmo — a potem ćwiczyć ją interaktywnie w przeglądarce z wbudowanym edytorem kodu i tutorem AI dostępnym 24/7. To część ścieżki edukacyjnej PHP Academy, a Twój postęp synchronizuje się między webem a aplikacją CoddyKit. Kurs PHP Academy zawiera 4 lekcji w sumie.

Dlaczego ograniczać liczbę żądań?

Ograniczanie liczby żądań chroni API przed nadużyciami, atakami DoS i niekontrolowanymi klientami. Zapewnia sprawiedliwy podział zasobów między wszystkich użytkowników.

Wbudowany mechanizm throttle w Laravelu

Należy zastosować middleware throttle, aby ograniczyć liczbę żądań w określonym przedziale czasu.

<?php
Route::middleware("throttle:60,1")->group(function () {
    // 60 requests per 1 minute per user/IP
    Route::apiResource("posts", PostController::class);
});

Niestandardowe ograniczniki liczby żądań

Zdefiniuj nazwane ograniczniki liczby żądań z niestandardową logiką w dostawcy usług.

<?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() => ...);

Warstwowe ograniczanie liczby żądań

Zwracaj różne limity w zależności od planu uwierzytelnionego użytkownika.

<?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()),
    };
});

Nagłówki odpowiedzi dotyczące limitu żądań

Po przekroczeniu limitu Laravel zwraca kod HTTP 429 wraz z nagłówkami: X-RateLimit-Limit, X-RateLimit-Remaining, Retry-After.

Strategie wersjonowania API

Trzy powszechnie stosowane podejścia:

  1. Prefiks adresu URL: /api/v1/users
  2. Parametr zapytania: /api/users?version=1
  3. Nagłówek Accept: Accept: application/vnd.myapp.v1+json

Prefiks adresu URL jest najczęściej stosowanym rozwiązaniem w interfejsach API Laravel.

Wersjonowanie za pomocą prefiksu adresu URL

Grupuj trasy według prefiksu wersji.

<?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);
});

Kontrolery zależne od wersji

Organizuj kontrolery według wersji w podkatalogach: App\Http\Controllers\Api\V1\ i App\Http\Controllers\Api\V2\.

Wycofywanie starych wersji

Dodaj nagłówek Deprecation lub Sunset do odpowiedzi starych wersji, aby powiadomić klientów o planowanym usunięciu.

<?php
// Middleware for v1 routes:
$response->headers->set("Deprecation", "version="v1"");
$response->headers->set("Sunset", "2026-01-01");

Zasoby API a wersjonowanie

Używaj zasobów API zależnych od wersji: V1\UserResource i V2\UserResource, aby definiować różne struktury odpowiedzi dla poszczególnych wersji.

Testowanie limitów żądań

W testach zastąp ogranicznik liczby żądań atrapą, aby uniknąć wzajemnego zakłócania testów.

<?php
RateLimiter::shouldReceive("tooManyAttempts")->andReturn(false);

Podsumowanie

Zastosuj throttle:60,1 do podstawowego ograniczania liczby żądań. Użyj RateLimiter::for() do definiowania niestandardowych, warstwowych limitów. Wersjonuj API za pomocą prefiksów adresów URL oraz kontrolerów i zasobów zależnych od wersji.

Szybkie sprawdzenie

Jaki kod stanu HTTP zwraca Laravel po przekroczeniu limitu liczby żądań?

Często zadawane pytania

Czy lekcja „Ograniczanie częstotliwości i wersjonowanie API” jest bezpłatna?

Tak — pełny tekst „Ograniczanie częstotliwości i wersjonowanie API” jest dostępny za darmo tutaj w sieci. Aby ćwiczyć ją interaktywnie (wbudowany edytor kodu i tutor AI dostępny 24/7) i odblokować resztę kursu PHP Academy, przejdź na CoddyKit PRO. Kurs PHP Academy zawiera 4 lekcji w sumie.

Co nauczysz się w „Ograniczanie częstotliwości i wersjonowanie API”?

Ograniczaj żądania za pomocą RateLimiter i przejrzyście wersjonuj API Ćwiczysz PHP Academy z praktycznym kodem, który uruchamiasz bezpośrednio w przeglądarce, a tutor AI dostępny 24/7 odpowiada na Twoje pytania podczas pracy nad lekcją.

Czy potrzebuję doświadczenia, aby zacząć PHP Academy?

Nie wymagamy żadnego doświadczenia. PHP Academy w CoddyKit jest strukturyzowany dla początkujących i zaawansowanych użytkowników, więc możesz zacząć tutaj lub od początku i uczyć się w swoim tempie. To lekcja 4 z 4.

Ile czasu zajmuje lekcja „Ograniczanie częstotliwości i wersjonowanie API”?

Większość lekcji CoddyKit trwa około 5–10 minut. Każda lekcja to mały, interaktywny krok, dzięki czemu robisz systematyczne postępy i zawsze wracasz dokładnie do tego samego miejsca — na webie i w aplikacji.

Czy mogę pisać i uruchamiać kod w tej lekcji PHP Academy?

Tak. Każda lekcja PHP Academy zawiera wbudowany edytor kodu, więc piszesz i uruchamiasz prawdziwy kod bezpośrednio w przeglądarce i od razu otrzymujesz sprzężenie zwrotne od AI — bez konfiguracji na komputerze.

Wszystkie lekcje w tym kursie

  1. Trasy API i kontrolery zasobów
  2. Zasoby API i odpowiedzi JSON
  3. Uwierzytelnianie za pomocą Laravel Sanctum
  4. Ograniczanie częstotliwości i wersjonowanie API
← Powrót do PHP Academy