怎样在LNMP环境中配置phpMyAdmin使用Redis存储Session？-phpMyAdmin-PHP中文网

phpMyAdmin会话由PHP统一控制，必须配置PHP的session.save_handler=redis和session.save_path，并启用redis扩展、重启PHP-FPM；config.inc.php中任何redis相关设置均无效。

phpMyAdmin 会话根本不由自己控制，改的是 PHP 的 session.save_handler

phpmyadmin 没有独立的 session 配置项，它完全复用 php 运行时的会话设置。你改 config.inc.php 里的任何 redis 相关字段（比如加 $cfg['servers'][$i]['session_save_path']）都无效——php 根本不认这个键。真正起作用的只有 php 自身的 session.save_handler 和 session.save_path。

常见错误现象：php -i | grep session.save_handler 输出仍是 files；多台 phpMyAdmin 节点之间登录态无法共享；Nginx 负载均衡后频繁跳回登录页。

确认当前 handler：运行 php -i | grep session.save_handler 或访问 phpinfo() 页面查输出
必须确保 PHP 已加载 redis 扩展（不是 predis），且版本兼容（PHP 8.2+ 需 redis 扩展 ≥ 5.3.7）
扩展未启用时，session.save_handler = redis 会被静默忽略，降级回 files

LNMP 下必须完成的三步：装 Redis、启扩展、改 php.ini

在 Ubuntu/Debian 环境下（CentOS 类似，仅包名略有差异）：

安装 Redis 服务：sudo apt install redis-server && sudo systemctl enable --now redis-server
安装 PHP Redis 扩展：sudo apt install php-redis（自动注册 extension=redis.so）
修改对应 PHP 的 php.ini（注意是 FPM 的配置，非 CLI）：
路径通常为 /etc/php/*/fpm/php.ini，确认后追加以下四行：

session.save_handler = redis
session.save_path = "tcp://127.0.0.1:6379?database=2&auth=mypass"
session.cookie_httponly = 1
session.gc_maxlifetime = 1440

⚠️ 注意：& 是 INI 文件中的字面量，不是 HTML 实体；database=2 表示使用 Redis DB 2；auth 参数仅当 Redis 配置了 requirepass 时才需要。

高可用部署时别硬写多个地址，sentinel 才是正解

原生 PHP redis handler 不支持 Redis Cluster，也不支持逗号分隔的多地址（如 "tcp://r1:6379,tcp://r2:6379"），那样只会连第一个且无故障转移能力。

Ai Session Analysis

用于分析本地AI编程助手会话数据（如Claude Code、Codex、Kimi Code）。当用户请求分析编程会话时触发。

下载

正确做法是启用 Redis Sentinel 模式（要求 PHP redis 扩展 ≥ 5.3.2）：

在 Redis 配置中部署至少 3 个 Sentinel 实例，并定义主节点别名（如 mymaster）
将 session.save_path 改为：sentinel://mymaster@sentinel1:26379,sentinel2:26379?retry_interval=100
确保 PHP 进程能解析 sentinel1 等主机名（或直接填 IP）
测试连接：redis-cli -p 26379 -a sentinel-pass SENTINEL get-master-addr-by-name mymaster

容易被忽略的关键对齐点：session.gc_maxlifetime 和 Redis TTL

PHP 的 session.gc_maxlifetime 决定了 session_destroy() 或 GC 清理的阈值，但它**不控制 Redis key 的过期时间**——Redis key 的 TTL 由 PHP 扩展内部根据该值自动设置。

如果只改了 session.gc_maxlifetime = 1440（24 分钟），但 Redis 实例全局设置了 maxmemory-policy allkeys-lru，且内存吃紧，key 可能被提前驱逐；更隐蔽的问题是：若你在 Redis 里手动执行 EXPIRE 覆盖了 PHP 设置的 TTL，会导致会话提前失效。

务必做到：