cloud-castle / http-rate-limiter
HTTP rate limiting для PHP 8.1+: фиксированное окно, PSR-15 middleware и заголовки X-RateLimit-*.
Requires
- php: >=8.1
- cloud-castle/redis: ^1.2
- psr/http-message: ^2.0
- psr/http-server-handler: ^1.0
- psr/http-server-middleware: ^1.0
Requires (Dev)
- cloud-castle/config: ^2.1
- cloud-castle/di: ^1.0
- cloud-castle/provider: ^1.0
- deptrac/deptrac: ^3.0 || ^4.0
- ergebnis/composer-normalize: ^2.45
- friendsofphp/php-cs-fixer: ^3.75
- icanhazstring/composer-unused: ^0.9
- infection/infection: ^0.29 || ^0.33
- php-parallel-lint/php-parallel-lint: ^1.4
- phpmd/phpmd: ^2.15
- phpstan/extension-installer: ^1.4
- phpstan/phpstan: ^1.12 || ^2.1
- phpstan/phpstan-deprecation-rules: ^1.2 || ^2.0
- phpstan/phpstan-phpunit: ^1.4 || ^2.0
- phpstan/phpstan-strict-rules: ^1.6 || ^2.0
- phpunit/phpunit: ^10.5 || ^11.5
- psalm/plugin-phpunit: ^0.19 || ^0.20
- rector/rector: ^1.2 || ^2.0
- roave/security-advisories: dev-latest
- squizlabs/php_codesniffer: ^3.12 || ^4.0
- vimeo/psalm: ^6.0
- webmozart/assert: ^1.11
Suggests
None
Provides
None
Conflicts
None
Replaces
None
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
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