PHPackages                             qnvip-com/php-rate-limit-middleware - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. qnvip-com/php-rate-limit-middleware

ActiveLibrary[Utility & Helpers](/categories/utility)

qnvip-com/php-rate-limit-middleware
===================================

A PHP middleware package for rate limiting and IP filtering with CIDR support

1.3.0(5mo ago)09MITPHPPHP >=7.1CI failing

Since Nov 24Pushed 3mo agoCompare

[ Source](https://github.com/maxlee123456/php-rate-limit-middleware)[ Packagist](https://packagist.org/packages/qnvip-com/php-rate-limit-middleware)[ RSS](/packages/qnvip-com-php-rate-limit-middleware/feed)WikiDiscussions master Synced 1mo ago

READMEChangelogDependencies (1)Versions (2)Used By (0)

PHP Rate Limit Middleware
=========================

[](#php-rate-limit-middleware)

一个用于请求频率限制和IP过滤的PHP中间件包。

功能特性
----

[](#功能特性)

- IP 白名单和黑名单（支持 IPv4/IPv6 网段）
- 请求频率限制（基于 Redis）
- 自动黑名单机制（可配置启用/禁用）
- Redis 异常容错处理
- 可配置的策略执行模式（阻止/非阻止）
- **全面的策略节点日志记录**
- 中间件集成
- **可自定义的日志处理器（支持 PSR-3 标准）**
- **请求数最大值跟踪记录到文件或Redis**

版本
--

[](#版本)

当前版本: 1.1.0

查看 [CHANGELOG.md](CHANGELOG.md) 了解详细的版本历史。

安装
--

[](#安装)

使用Composer安装：

```
composer require php-rate-limit-middleware/php-rate-limit-middleware
```

### Redis 扩展要求

[](#redis-扩展要求)

如果要使用限流功能，需要安装 Redis 扩展：

#### Windows:

[](#windows)

1. 下载适合您PHP版本的 php\_redis.dll
2. 将其放置在 PHP 扩展目录中
3. 在 php.ini 中添加: `extension=php_redis.dll`
4. 重启 Web 服务器

#### Linux/macOS (使用 PECL):

[](#linuxmacos-使用-pecl)

```
pecl install redis
```

然后在 php.ini 中添加: `extension=redis`

#### 使用 Composer 替代方案

[](#使用-composer-替代方案)

如果不方便安装 PHP 扩展，可以使用 Composer 包作为替代：

```
composer require phpredis/phpredis
```

使用方法
----

[](#使用方法)

```