Laravel7x如何设置phpredis密码-php教程-PHP中文网

laravel 7.x 默认不支持 phpredis 客户端的 password 配置项，因其 phpredisconnector 未读取 password 字段，必须通过 options.parameters.password 显式注入，否则连接虽成功但执行命令报 noauth authentication required。

laravel7x如何设置phpredis密码

直接说结论：Laravel 7.x 默认不支持 phpredis 客户端的密码字段，必须手动补全配置项，否则 password 被忽略，连接会报 NOAUTH Authentication required 错误。

为什么 Laravel 7.x 的 php redis 不认 password 配置

Laravel 7.x 的 Redis 连接逻辑在 Illuminate\Redis\Connectors\PhpRedisConnector 中，它只从配置里读取 host、port、database、timeout 等字段，但**完全跳过 password**。即使你在 config/database.php 或 .env 里写了 REDIS_PASSWORD，phpredis 实例初始化时也不会传进去。

这不是 bug，是历史设计遗留——Laravel 7.x 时期官方推荐的是 predis，对 phpredis 的支持仅限基础连接，认证字段没被纳入适配范围。

用 predis 客户端时，password 字段能正常生效（因为 PredisConnector 显式处理了）
用 phpredis 时，password 字段被静默丢弃
错误现象：连接成功但执行任何命令都返回 NOAUTH Authentication required

phpredis 密码必须通过 options 参数注入

要让 phpredis 认密码，得绕过 Laravel 的默认连接器，改用 options 数组把认证信息透传给底层 Redis 扩展实例。

修改 config/database.php 中的 redis.default 配置：

Redis Skill - 高性能缓存管理

Redis 缓存和数据结构管理技能。通过自然语言操作 Redis，支持 String、Hash、List、Set、ZSet、Stream 等数据结构操作。当用户提到 Redis、缓存、消息队列、会话存储时使用此技能。

下载

'default' => [
    'host' => env('REDIS_HOST', '127.0.0.1'),
    'password' => env('REDIS_PASSWORD', null), // 这行保留，但只是占位
    'port' => env('REDIS_PORT', 6379),
    'database' => 0,
    'options' => [
        'prefix' => 'laravel_database_',
        'parameters' => [
            'password' => env('REDIS_PASSWORD'), // ← 关键：这里才是 phpredis 真正读的
        ],
    ],
],

options.parameters.password 是 phpredis 扩展原生识别的参数名，Laravel 不干涉它
如果 REDIS_PASSWORD 为空或 null，parameters 里不要写 password，否则可能触发空密码校验失败
不建议在 parameters 里硬编码密码，始终走 env()

验证连接是否真正带密码

别只信 php artisan tinker 里 Redis::ping() 成功——它可能缓存了未认证的连接。要确认真实行为，得看底层实例是否设置了 AUTH。

在 tinker 中运行：

$client = Redis::connection()->client();
$client->getHost(); // 应该是 127.0.0.1
$client->getPort(); // 应该是 6379
// 尝试发一个需要认证的命令（非 ping）
$client->set('test_auth', 'ok'); // 如果返回 false 或抛异常，说明没认证

如果 set 失败且报 NOAUTH，说明 options.parameters.password 没生效或值为空
如果 set 成功，再用 redis-cli -h 127.0.0.1 -p 6379 连上去执行 GET test_auth，确认数据确实写进去了
注意：Laravel 的 Redis facade 默认用的是 default 连接，确保你改的是同一个 connection 名

容易被忽略的兼容性细节

phpredis 扩展本身对密码处理有版本差异，Laravel 7.x 常见搭配是 phpredis 4.x–5.x，这几个点必须核对：

phpredis 5.0+ 支持 parameters 数组传 password；4.x 版本也支持，但某些旧 patch 可能忽略空字符串
如果 Redis 服务启用了 ACL（Redis 6.0+），password 字段只对应 default 用户，ACL 用户需用 auth user pass 方式，Laravel 7.x 完全不支持这种双参数认证
使用 phpredis 时，database 必须是整数，不能是字符串（比如 "0"），否则连接会静默失败
options.prefix 和 parameters 是两个独立层级，别把 password 错放到 options 顶层