ThinkPHP的session_driver应填redis或memcached（区分大小写），需安装对应扩展并正确配置session_options；Redis连接须用auth而非password，database指定DB索引；Memcached服务器列表必须为纯数字索引数组；Cookie域需设为.example.com以支持分布式共享。
ThinkPHP 的 session_driver 配置到底该填什么
填错驱动名是 80% 分布式 Session 失败的起点。ThinkPHP 6.x 默认不内置 redis 或 memcached 驱动，必须手动安装扩展并注册——不是改个配置就能用。
常见错误现象：SessionHandlerInterface 报错、session_start(): Failed to initialize storage module、写入 session 后读不到。
-
session_driver值必须是redis（TP6.1+）或memcached，不能写成Redis、REDIS或phpredis - Redis 驱动依赖
ext-redis，不是ext-predis；Memcached 驱动依赖ext-memcached（注意不是ext-memcache） - TP6.0–6.0.12 存在
redis驱动 bug，建议升到 6.0.13+ 或直接用 6.1+ - 配置项路径是
config/session.php，不是.env——.env里的SESSION_TYPE在 TP6 中已被弃用
Redis 连接参数怎么写才不连不上
Redis 驱动默认走 TCP，但生产环境常需 Unix Socket、密码、DB 索引，这些全靠 session_options 控制，且键名和原生 Redis 扩展不完全一致。
典型错误：配了 password 却没加 auth 字段，或把 database 写成 db，导致连接成功但写入失败（默认写进 db 0，而业务 Redis 可能用 db 1）。
立即学习“PHP免费学习笔记（深入）”；
-
host和port是基础，但unix_socket优先级高于host，填了就忽略 host/port - 带密码必须显式写
'auth' => 'your_pass'，仅写'password'无效 -
database指定 DB 索引，如1；不填则为0，和redis-cli默认行为一致 -
timeout单位是秒（非毫秒），设太小会导致高并发下频繁超时，建议 ≥ 2
示例有效配置：
'session_options' => [
'host' => '127.0.0.1',
'port' => 6379,
'auth' => 'a1b2c3',
'database' => 2,
'timeout' => 3,
],
Memcached 驱动为什么总提示 addServer failed
不是 IP 写错，而是 ThinkPHP 的 Memcached 驱动对服务器列表格式极度敏感：它不接受数组索引键名，只认纯数字索引顺序，且必须含 host 和 port 两个字段。
错误现象：配置里写了 ['server1' => ['host'=>'x','port'=>11211]]，结果启动就报 addServer failed；或者用了 127.0.0.1:11211 字符串格式，驱动根本解析不了。
- 服务器列表必须是纯数字索引数组：
[ ['host'=>'127.0.0.1','port'=>11211], ['host'=>'192.168.1.10','port'=>11211] ] - 每个节点必须有
host和port，缺一不可；weight可选，但不能写成weight: 10（冒号语法错） - Memcached 扩展必须启用
memcached.sess_locking（默认开），否则并发请求可能丢失 session - TP 对 Memcached 的
expire参数支持有限，实际过期时间由服务端配置和session.gc_maxlifetime共同决定，别只信配置里的expire
Session ID 跨机器不一致？检查 Cookie 域和 Path
Redis/Memcached 存的是数据，但 Session ID 仍靠 Cookie 传递。分布式环境下，不同子域（如 a.example.com 和 b.example.com）若没统一 Cookie 域，用户登录后跳转就丢 session。
典型表现：单机测试正常，上 Nginx + 多 PHP-FPM 实例后，刷新几次就登出；或 HTTPS 和 HTTP 站点间无法共享 session。
-
cookie_domain必须设为.example.com（开头带点），不能是www.example.com或空字符串 -
cookie_path设为/，避免路径隔离（如设成/admin后前台就拿不到） -
cookie_secure在 HTTPS 环境下必须为true，否则浏览器拒绝发送 Cookie；但开发环境设true会导致本地 HTTP 访问失效 - 如果用 CDN 或反向代理，确认
X-Forwarded-Proto被正确传递，否则cookie_secure判断会出错
这事跟 Redis 无关，但 90% 的人排查半天最后卡在这儿。
