PHPackages                             teamone/redis - 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. [Caching](/categories/caching)
4. /
5. teamone/redis

ActiveLibrary[Caching](/categories/caching)

teamone/redis
=============

Teamone Redis

v1.1.1(2y ago)12611Apache-2.0PHP

Since Dec 11Pushed 2y ago1 watchersCompare

[ Source](https://github.com/teamone-cn/teamone-redis)[ Packagist](https://packagist.org/packages/teamone/redis)[ RSS](/packages/teamone-redis/feed)WikiDiscussions main Synced 1mo ago

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

Teamone Redis Client
====================

[](#teamone-redis-client)

简介
--

[](#简介)

[![TeamOne](https://camo.githubusercontent.com/59c1dc510ed0df37b4a6e6ff58cb73b6108058c0e403c2765903c0823575ab75/68747470733a2f2f666f6e742e746877706d616e6167652e636f6d2f696d672f7465616d6f6e652e6a7067)](https://camo.githubusercontent.com/59c1dc510ed0df37b4a6e6ff58cb73b6108058c0e403c2765903c0823575ab75/68747470733a2f2f666f6e742e746877706d616e6167652e636f6d2f696d672f7465616d6f6e652e6a7067)

Teamone Redis Client 是【霆万平头哥】开发的一个 PHP Redis 客户端连接组件，旨在为开发者提供方便、稳定的与 Redis 服务器进行通信的解决方案。该组件具备超时重连功能，能够确保在连接异常时能够自动进行重连操作，保障应用的稳定性和可靠性。

主要特性
----

[](#主要特性)

1. 超时重连：Teamone Redis Client 支持超时重连功能，当连接异常时，会自动进行重连操作，确保与 Redis 服务器的稳定连接。
2. 灵活配置：通过简单的配置，可以轻松指定 Redis 服务器的连接参数，包括主机地址、端口、超时时间、重试间隔、用户名、密码、数据库、连接前缀等。
3. 多实例支持：支持配置多个 Redis 实例，可以根据实际需求进行灵活切换，满足不同业务场景的需求。
4. 简洁易用：提供简洁易用的 API，开发者无需关心底层连接细节，即可方便地进行 Redis 数据操作。
5. 错误处理：具备完善的错误处理机制，能够及时捕获并处理连接和操作过程中的异常情况，保障应用的稳定性。
6. 可以与 WordPress 结合使用，通过将 Redis 作为 WordPress 的缓存存储后端，有效地提升 WordPress 网站的性能和响应速度。通过简单的配置，可以轻松将 Redis 与 WordPress 集成，实现数据的高效缓存和快速访问。

项目目标
----

[](#项目目标)

Teamone Redis Client 旨在为 PHP 开发者提供一个稳定、高效的与 Redis 服务器通信的解决方案。我们将持续改进和完善组件功能，为用户提供更加优秀的开发体验和更高的性能表现。同时，我们欢迎社区的贡献和反馈，共同推动项目的发展和进步。

安装
--

[](#安装)

```
composer require teamone/redis
```

接入指南
----

[](#接入指南)

### 一、配置说明

[](#一配置说明)

```
$configs = [
    // 配置名称: default
    "default" => [
        // 连接驱动，可以自行重写此实现类
        'driver'         => RedisConnector::class,
        // 地址
        'host'           => '127.0.0.1',
        // 端口
        'port'           => 6379,
        // 连接超时时间，0.0 表示不限时
        'timeout'        => 0.0,
         // 重试间隔，单位为毫秒。
        'retry_interval' => 1000,
        // 读取超时时间，0 表示不限时
        'read_timeout'   => 0,
        // 用户名
        'username'       => null,
        // 密码
        'password'       => '123456',
        // 数据库 0~15
        'database'       => 0,
        // 键前缀
        'prefix'         => 'default:',
        // 实例的名称（内部使用，默认 Redis 即可）
        'name'           => 'Redis',
        // 连接失败时，等待多久时间重新连接
        'wait_timeout'   => 5,
    ],
];
```

### 二、初始化并使用

[](#二初始化并使用)

```
use Teamone\Redis\RedisConnector;
use Teamone\Redis\RedisManager;
use Redis;

$configs = [
    "default" => [
        'driver'         => RedisConnector::class,
        'host'           => '127.0.0.1',
        'port'           => 6379,
        'timeout'        => 3.0,
        'retry_interval' => 1000, // 重试间隔，单位为毫秒。
        'read_timeout'   => 0,
        'username'       => null,
        'password'       => '123456',
        'database'       => 0,
        'prefix'         => 'default:',
        'name'           => 'Redis',
        'wait_timeout'   => 5, // 连接失败时，等待多久时间重新连接
    ],
    "queue"   => [
        'driver'         => RedisConnector::class,
        'host'           => '127.0.0.1',
        'port'           => 6379,
        'timeout'        => 3.0,
        'retry_interval' => 1000, // 重试间隔，单位为毫秒。
        'read_timeout'   => 0,
        'username'       => null,
        'password'       => '123456',
        'database'       => 1,
        'prefix'         => 'queue:',
        'name'           => 'Redis',
        'wait_timeout'   => 5, // 连接失败时，等待多久时间重新连接
    ],
];

$name = "default"; // or queue
$manager = new RedisManager($configs);
/** @var Redis $redis */
$redis = $manager->connection($name);

$result = $redis->set("name", "Teamone");
var_dump($result);
```

### 三、执行单元测试

[](#三执行单元测试)

```
./vendor/bin/phpunit ./test/RedisTest.php --filter testConnect
```

###  Health Score

23

—

LowBetter than 27% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity9

Limited adoption so far

Community14

Small or concentrated contributor base

Maturity44

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 75% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~46 days

Total

3

Last Release

797d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/6eb5ed3739a1c5fcc298dae4e784024553b641e74445cac72d29d12e2f66b409?d=identicon)[teamone](/maintainers/teamone)

---

Top Contributors

[![Jukit-Barrett](https://avatars.githubusercontent.com/u/14925130?v=4)](https://github.com/Jukit-Barrett "Jukit-Barrett (9 commits)")[![teamone-cn01](https://avatars.githubusercontent.com/u/124553729?v=4)](https://github.com/teamone-cn01 "teamone-cn01 (2 commits)")[![yang-liangzai](https://avatars.githubusercontent.com/u/126054903?v=4)](https://github.com/yang-liangzai "yang-liangzai (1 commits)")

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/teamone-redis/health.svg)

```
[![Health](https://phpackages.com/badges/teamone-redis/health.svg)](https://phpackages.com/packages/teamone-redis)
```

###  Alternatives

[predis/predis

A flexible and feature-complete Redis/Valkey client for PHP.

7.8k305.7M2.4k](/packages/predis-predis)[snc/redis-bundle

A Redis bundle for Symfony

1.0k39.4M67](/packages/snc-redis-bundle)[react/cache

Async, Promise-based cache interface for ReactPHP

444112.4M40](/packages/react-cache)[wp-media/wp-rocket

Performance optimization plugin for WordPress

7431.3M3](/packages/wp-media-wp-rocket)[illuminate/cache

The Illuminate Cache package.

12835.6M1.4k](/packages/illuminate-cache)[colinmollenhour/php-redis-session-abstract

A Redis-based session handler with optimistic locking

6325.6M14](/packages/colinmollenhour-php-redis-session-abstract)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
