Hyperf 3.x如何配置多组不同的Redis连接_在redis.php定义不同Key-php教程-PHP中文网

hyperf 3.x 多 redis 连接需三步：一、在 redis.php 中用不同键名（如 cache、queue）定义多组完整配置，driver 显式声明；二、在 dependencies.php 中按 hyperf\redis\redis::class.'.cache' => redisfactory 格式显式绑定；三、业务中以 $rediscache 命名注入对应连接。

hyperf 3.x如何配置多组不同的redis连接_在redis.php定义不同key

Hyperf 3.x 支持在 config/autoload/redis.php 中通过不同配置键（key）定义多组 Redis 连接，但必须配合依赖注入的显式绑定才能生效——光写多个配置项，不改 dependencies.php，Redis 类型注入默认只会取 default 那一组。

redis.php 里怎么写多个连接配置

每个连接需用独立的数组键名（如 cache、session、queue），不能都叫 default。每组必须包含完整连接参数，尤其是 database 和 host 等关键字段：

database 值可以相同也可以不同，取决于你是否想用逻辑库隔离（Redis 单实例最多支持 16 个 DB，默认是 0）
driver 字段建议显式写出，比如 'driver' => 'redis'，避免某些版本下 fallback 行为不一致
若某组走集群模式，cluster.enable 必须为 true，且 nodes 数组不能为空；非集群组不能混用 cluster 键，否则会报错 Invalid cluster configuration

示例片段：

return [
    'default' => [
        'driver' => 'redis',
        'host' => '127.0.0.1',
        'port' => 6379,
        'database' => 0,
        'password' => null,
    ],
    'cache' => [
        'driver' => 'redis',
        'host' => '127.0.0.1',
        'port' => 6379,
        'database' => 1,
        'password' => null,
    ],
    'queue' => [
        'driver' => 'redis',
        'host' => '192.168.5.10',
        'port' => 6380,
        'database' => 0,
        'password' => 'qpass123',
    ],
];

dependencies.php 必须手动绑定每个连接名

Hyperf 不会自动把 redis.php 里所有 key 都注册为可注入的服务。你得在 config/autoload/dependencies.php 中显式声明每个连接对应的工厂类：

绑定格式是 Hyperf\Redis\Redis::class . '.{connection_name}' => \Hyperf\Redis\RedisFactory::class
注意：键名必须带 .cache、.queue 后缀，且和 redis.php 中的 key 完全一致（大小写敏感）
如果漏掉某一项，比如只绑了 default 和 cache，但代码里尝试注入 Redis $queue，容器会抛出 Entry "Redis::queue" cannot be resolved

正确写法示例：

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

return [
    Hyperf\Redis\Redis::class . '.cache' => Hyperf\Redis\RedisFactory::class,
    Hyperf\Redis\Redis::class . '.queue' => Hyperf\Redis\RedisFactory::class,
];

业务代码中如何使用指定连接

不能直接 public function __construct(Redis $redis) —— 这只会拿到 default 连接。必须用「命名注入」语法，即在参数名前加连接名前缀：

变量名必须是 $redisCache 或 $redisQueue，且首字母小写 + 连接名驼峰化（cache → redisCache，queue → redisQueue）
Hyperf 的 DI 容器靠这个命名规则匹配 dependencies.php 里注册的键
如果你定义的是 session 连接，变量名就得是 $redisSession，不是 $sessionRedis 或 $redis_session

典型用法：

use Hyperf\Redis\Redis;

class UserService
{
    public function __construct(
        private Redis $redisDefault,
        private Redis $redisCache,
        private Redis $redisQueue
    ) {}

    public function storeUser($id, $data)
    {
        $this->redisDefault->set("user:{$id}", json_encode($data));
        $this->redisCache->setex("cache:user:{$id}", 3600, json_encode($data));
        $this->redisQueue->rpush('user_update_queue', json_encode(['id' => $id]));
    }
}

容易忽略的兼容性细节

Hyperf 3.x 对多连接的支持依赖于底层 hyperf/redis 包的版本。如果你用的是 hyperf/redis ^3.0，以下几点必须核对：

redis.php 中的连接配置键名，不能含冒号 :、点 . 或空格，否则 DI 容器解析失败
若某组配置启用了 ssl 或 sentinel 模式，对应连接器类（如 Hyperf\Redis\SentinelRedisFactory）必须在 dependencies.php 中单独注册，不能复用 RedisFactory
集群模式下，database 字段会被忽略（Redis Cluster 不支持逻辑库），但配置里仍要保留，否则部分旧版 hyperf/redis 会触发 notice 级警告