Search by

cloud-castle / http-rate-limiter

alex-4-17

HTTP rate limiting для PHP 8.1+: фиксированное окно, PSR-15 middleware и заголовки X-RateLimit-*.

v1.3.0 2026-11-07 18:22 UTC

This package is auto-updated.

Last update: 2026-11-07 18:22:37 UTC


README

🇷🇺 Русский · 🇬🇧 English · 🇩🇪 Deutsch · 🇫🇷 Français · 🇪🇸 Español · 🇮🇹 Italiano

CloudCastle Http RateLimiter

CloudCastle Http RateLimiter

Packagist Version License

HTTP rate limiting для PHP 8.1+: фиксированное окно, PSR-15 middleware и заголовки X-RateLimit-*.

Установка

composer require cloud-castle/http-rate-limiter

Быстрый старт

<?php

use CloudCastle\Http\RateLimiter\FixedWindowRateLimiter;
use CloudCastle\Http\RateLimiter\RateLimitMiddleware;

$limiter = new FixedWindowRateLimiter(limit: 60, windowSeconds: 60);
$middleware = new RateLimitMiddleware($limiter);

Возможности

  • Фиксированное окно в памяти процесса
  • PSR-15 middleware с ключом по IP или произвольным resolver
  • Ответ 429 JSON + Retry-After / X-RateLimit-*

Плюсы и минусы

Плюсы: нулевые тяжёлые зависимости; предсказуемые заголовки; удобно встраивается в kernel.

Минусы: in-memory не шарится между воркерами — для кластера нужен внешний storage (позже); пакет моложе аналогов вроде Symfony RateLimiter.

Когда применять

Защита публичных HTTP-эндпоинтов в single-process / PHP-FPM с одним воркером на ключ или как слой поверх внешнего storage.

Разработка

composer install
composer check

Лицензия

MIT © CloudCastle