phpEnv环境下如何使用Workerman连接Redis？-php教程-PHP中文网

phpEnv下Workerman连接Redis失败的核心原因是redis扩展未启用或配置错误，需确认PHP版本、编译安装redis.so、正确配置php.ini，并在onWorkerStart中初始化独立连接。

phpenv环境下如何使用workerman连接redis？

Workerman 在 phpEnv 环境下连接 Redis，核心障碍不是 Workerman 本身，而是 phpEnv 默认不启用 redis 扩展，且常忽略 php.ini 的加载路径和扩展目录配置 —— 这会导致 new Redis() 报错 Class 'Redis' not found 或连接后立即断开。

确认 phpEnv 中 redis.so 是否已编译并启用

phpEnv 是多版本 PHP 环境管理工具，每个 PHP 版本有独立的 php.ini 和扩展目录。不能假设系统级安装的 redis 扩展对当前 phpEnv 切换的版本生效。

先查当前使用的 PHP 版本：php -v
再查该版本是否加载了 redis 扩展：php -m | grep redis（无输出即未启用）
若未启用，需进入对应 PHP 源码或二进制目录，手动编译安装：
① 进入 phpenv/versions/{x.x}/src（若有源码）或下载匹配的 phpredis release；
② 执行 phpize && ./configure && make && sudo make install；
③ 编辑该版本对应的 php.ini（路径通常为 ~/.phpenv/versions/{x.x}/etc/php.ini），添加 extension=redis.so；
④ 重启 Web 服务或 CLI 环境后验证 php -m | grep redis

Workerman 启动时连接 Redis 失败的常见原因

即使扩展已启用，Workerman 常驻进程仍可能因环境隔离导致连接失败，尤其在 CLI 模式下运行时。

Connection refused：Redis 服务未启动，或监听地址不是 127.0.0.1:6379；用 redis-cli -h 127.0.0.1 -p 6379 ping 测试通路
Auth failed：phpEnv 下的 CLI 环境不读取 .env 或配置文件，密码必须显式传入：$redis->auth('your_password')
read_write_timeout 中断：Workerman 长连接场景下，Predis 默认 60 秒超时会主动断连；改用 new Predis\Client([...], ['read_write_timeout' => 0])
扩展与 Predis 混用冲突：不要同时 require redis.so 和 predis/predis 并在同个进程里混用类；选一个并保持一致

Workerman Worker 中安全复用 Redis 连接

Workerman 多进程模型下，每个 Worker 进程应持有独立的 Redis 连接实例，不能全局共享单例 —— 否则会触发连接被其他进程关闭、fd 冲突等问题。

redis-tools

按类别查找Redis命令、检测服务器连接、监控键数量和内存占用，支持离线速查表。

下载

避免在 Worker::runAll() 外创建 $redis 实例

应在 $worker->onWorkerStart 回调中初始化连接：

$worker->onWorkerStart = function ($worker) {
    $redis = new Redis();
    $redis->connect('127.0.0.1', 6379);
    $redis->auth('pass123');
    // 存入 worker 属性，供 onMessage 使用
    $worker->redis = $redis;
};

若用 Predis，同样在 onWorkerStart 中 new Client，不要在 onMessage 里每次新建 —— 避免连接数爆炸

phpEnv + Workerman + Redis 的最小可运行验证片段

把以下代码保存为 start.php，在 phpEnv 指定版本下执行 php start.php，能连通即说明环境打通：

require_once __DIR__ . '/vendor/autoload.php';
use Workerman\Worker;

$worker = new Worker('text://0.0.0.0:1234');
$worker->count = 1;

$worker->onWorkerStart = function ($worker) {
    $redis = new Redis();
    try {
        $redis->connect('127.0.0.1', 6379, 2); // 第三个参数是连接超时（秒）
        $redis->auth('your_password'); // 若有密码
        $redis->set('workerman_test', 'ok', 10);
        echo "Redis connected and set key\n";
        $worker->redis = $redis;
    } catch (Exception $e) {
        echo "Redis connect failed: " . $e->getMessage() . "\n";
        exit(1);
    }
};

$worker->onMessage = function ($connection, $data) use ($worker) {
    $val = $worker->redis->get('workerman_test');
    $connection->send("Redis says: $val");
};

Worker::runAll();

真正容易被忽略的是：phpEnv 切换版本后，CLI 的 php.ini 路径、扩展目录、甚至 LD_LIBRARY_PATH 都可能变化，而 Workerman 启动完全依赖 CLI 环境 —— 不验证当前 CLI 的 php --ini 输出，就盲目改配置，90% 会卡在第一步。