composer怎么安装Redis插件_composer怎么配置Redis缓存连接【总结】

PHP redis扩展未启用是class ‘Redis’ not found主因，需pecl install redis、配置php.ini并重启服务；predis纯PHP适合开发，phpredis性能高宜用于生产；连不上需检查socket路径、超时及config:clear。

composer install redis 扩展失败：缺 PHP 模块，不是插件问题

composer 安装的 phpredis 或 predis/predis 只是 PHP 客户端库，不等于 Redis 服务本身，更不自动启用 PHP 的 redis 扩展。常见报错如 Class 'Redis' not found，本质是 PHP 缺少已编译启用的 redis 扩展模块，和 Composer 装了啥无关。

• 先运行 php -m | grep redis，没输出说明扩展根本没装好
• pecl install redis 是编译安装扩展的正确命令，不是 composer require
• 装完必须在 php.ini 中确认有 extension=redis.so（linux/macos）或 extension=php_redis.dll（windows）
• 改完 php.ini 后要重启 Web Server（如 apache/nginx）或 PHP-FPM，否则不生效

composer require predis/predis vs phpredis：选哪个？

两者都能连 Redis，但底层机制不同，影响连接稳定性、类型支持和错误表现。

• predis/predis 纯 PHP 实现，无需额外扩展，composer require predis/predis 装完就能用，适合开发环境或受限主机
• phpredis 是 C 扩展，性能更高，支持更多 Redis 6+ 特性（如 RESP3、ACL），但依赖系统级安装，部署稍重
• laravel 默认用 predis/predis，但生产环境建议切到 phpredis；切换只需改配置里 REDIS_CLIENT 为 phpredis，并确保扩展已启用
• 注意：Laravel 9+ 默认弃用 predis，推荐直接用 phpredis，否则可能遇到 Connection refused 却无明确提示

Laravel 配置 redis.default.host 连不上：检查 socket 和 timeout

配置看似正确，但连不上常因网络层或协议细节被忽略。

• 默认配置走 TCP：host=127.0.0.1 + port=6379；若 Redis 改用 unix socket，必须显式设 host=/var/run/redis/redis-server.sock 并删掉 port
• 超时值太小会导致偶发失败，尤其在高延迟容器网络中；把 timeout 和 read_timeout 都调到 5 以上再试
• 密码不为空时，password 字段不能留空字符串，必须为 NULL 或真实密码；填空字符串会触发 AUTH 命令失败
• Redis 6+ 默认启用 ACL，default 用户可能无权限；临时验证可改用 redis-cli -a yourpass ping 直连测试

cache.store.redis.connection 走错配置：别漏掉 config:clear

改完 config/database.php 或 .env 里的 Redis 配置后，Laravel 不会自动重载——缓存的配置还在内存里。

• 每次改完 Redis 连接参数，必须执行 php artisan config:clear，否则新配置完全不生效
• 如果同时用了 php artisan optimize:clear，它会连带清掉 config cache，但单独清 config 更精准
• 本地开发用 php artisan serve 时，改配置后需手动重启服务；docker 环境则要 docker-compose restart app，不能只 exec 进去跑命令
• 验证是否生效：用 php artisan tinker 执行 config('database.redis.default')，看输出是否和你写的匹配

Redis 连接问题八成出在 PHP 扩展状态、socket 路径拼写、配置缓存未清这三处，而不是 Composer 装了什么包。越早确认 php -i | grep redis 输出和 config:clear 是否执行，越少绕路。