Laravel6x如何安装phpredis扩展-php教程-PHP中文网

先确认是否真未安装：php -m | grep redis无输出，可能是CLI与PHP-FPM配置不一致，需检查php-fpm -i | grep "Loaded Configuration File"定位正确php.ini，Ubuntu/Debian推荐sudo apt install php-redis自动配置，Laravel 6.x若用phpredis扩展须在config/database.php中设'client' => 'phpredis'并清缓存php artisan config:clear。

laravel6x如何安装phpredis扩展

php -m 看不到 redis 模块？先确认是不是真没装

执行 php -m | grep redis 没输出，不代表扩展一定没装——更可能是当前 CLI 使用的 PHP 和 Web 服务器（如 Nginx + PHP-FPM）用的不是同一套配置。Laravel 6.x 运行在 PHP-FPM 下，所以你要查的是 PHP-FPM 对应的 php.ini，而不是 CLI 的那个。

快速定位：运行 php-fpm -i | grep "Loaded Configuration File" 或在 Laravel 中新建一个路由，返回 phpinfo()，看 “Loaded Configuration File” 路径。别只改了 /etc/php/7.4/cli/php.ini，却忘了 /etc/php/7.4/fpm/php.ini。

Ubuntu/Debian 用户直接装系统包最稳：sudo apt install php-redis（自动启用、自动写入 fpm/cli 两处 ini）
macOS 用 Homebrew：brew install php-redis，然后检查 php.ini 是否已追加 extension=redis.so
别用 pecl install redis 后手动加 extension —— 容易漏掉 .so 路径或权限问题，尤其 Alpine 容器里

Laravel 6.x 配置里 client=phpredis 还是 predis？

二者不兼容，选错会导致 Class 'Predis\Client' not found 或 Call to undefined method Illuminate\Redis\Connections\Connection::client() 这类报错。Laravel 6.x 默认用 predis，但如果你装的是 php-redis 扩展，必须显式切换。

打开 config/database.php，找到 redis 数组，把 'client' => env('REDIS_CLIENT', 'predis') 改成：

'client' => env('REDIS_CLIENT', 'phpredis'),

再确保 .env 里有：

redis-tools

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

下载

REDIS_CLIENT=phpredis

改完必须清配置缓存：php artisan config:clear（否则 Laravel 仍读旧值）
如果用了 Horizon 或队列，也要确认 QUEUE_CONNECTION=redis 且 redis 驱动指向的是同一套配置
phpredis 是 C 扩展，性能略高；predis 纯 PHP，调试友好但不支持某些 Redis 6+ 命令（比如 ACL 相关）

new Redis() 成功但 Laravel 报错“Connection refused”？检查 database 配置层级

PHP 扩展装好了、new Redis() 手动连得上，不代表 Laravel 就能用——它默认从 config/database.php 的 redis.default 读配置，而这个数组结构必须完整，缺字段会静默 fallback 到 127.0.0.1:6379，但密码或 database 错了就直接拒连。

重点核对这四行是否都存在且拼写正确（注意是 database 不是 db）：

'host' => env('REDIS_HOST', '127.0.0.1'),
'password' => env('REDIS_PASSWORD', null),
'port' => env('REDIS_PORT', 6379),
'database' => env('REDIS_DB', 0),

如果 Redis 服务启用了密码，REDIS_PASSWORD 不能为空字符串，得是 null 或真实密码；空字符串会被当成密码传过去，导致认证失败
database 字段类型必须是整数，不能是字符串 "0"，否则 phpredis 会忽略它，连到 db 0 却写进 db 1
用 php artisan tinker 测试：Redis::connection()->ping() 返回 "PONG" 才算真正通了

Mac M1/M2 上 pecl install redis 失败？换 brew 或跳过编译

Apple Silicon 下 pecl install redis 经常卡在 make，报 error: unknown type name 'uint64_t' 或找不到 hiredis。这不是 Laravel 的锅，是 PECL 构建链和 macOS SDK 版本不匹配。

首选方案：brew install php-redis（Homebrew 已预编译适配 M-series）
次选：用 Docker 运行 Laravel，容器内用 apk add php7-redis（Alpine）或 apt-get install php-redis（Debian），彻底绕开本地编译
硬要 PECL？先装依赖：brew install autoconf automake libtool，再重试，但成功率不稳定

扩展名、配置项、环境变量三者必须咬合，少对一环，Laravel 6.x 就会安静地走回 file 缓存，你却还在日志里找 Redis 连接错误。