FrankenPHP 中 session.save_handler 配置依然生效，但需确保 php.ini 路径正确、redis.so 扩展显式加载、session.cookie_domain 显式设置且避免 save_path 中使用 database 查询参数。
FrankenPHP 里 session.save_handler 配置依然生效
FrankenPHP 是基于 SAPI 的 PHP 运行时，不是传统 FPM 或 CLI，但它仍完整兼容 PHP 的 ini 配置机制。只要你在 php.ini 或 .user.ini 中设置了 session.save_handler = redis 和 session.save_path，FrankenPHP 启动时就会加载并使用 Redis Session 处理器——不需要额外代码接管或重写 SessionHandlerInterface。
但要注意：FrankenPHP 默认不读取系统级 /etc/php/*/cli/php.ini，而是优先加载项目根目录下的 php.ini 或通过 FRANKENPHP_PHP_INI_PATH 环境变量指定路径。若你沿用旧环境的全局配置，很可能实际没生效。
- 检查方式：在 FrankenPHP 服务中执行
phpinfo()，搜索session.save_handler，确认值为redis且Loaded Configuration File指向你修改的那个文件 - 若用 Docker，确保
php.ini已 COPY 进镜像，并挂载到正确路径（如/etc/php/8.3/mods-available/session.ini不会被自动加载） - FrankenPHP 不支持
session.auto_start = 1，必须显式调用session_start()，否则即使配置对了也无 session 写入
redis.so 扩展必须启用，且不能依赖 .so 路径硬编码
FrankenPHP 使用自己的 PHP 构建，扩展加载逻辑与常规 PHP-FPM 不同：它不自动扫描 extension_dir 下所有 .so 文件，必须显式声明启用哪些扩展。
常见错误是直接复用宝塔或 apt 安装的 php.ini 片段，里面写了 extension=redis.so，但 FrankenPHP 的 extension_dir 可能是空的，或 redis.so 根本不在该路径下，导致启动时报 PHP Warning: Module 'redis' already loaded in Unknown on line 0 或静默忽略。
立即学习“PHP免费学习笔记（深入）”；
- 先运行
php -m | grep redis确认扩展已加载；若无输出，说明未启用 - 不要写
extension=redis.so，改用绝对路径：extension=/usr/lib/php/20230831/redis.so（路径需用find /usr -name "redis.so" 2>/dev/null实际查） - FrankenPHP 官方镜像默认不含 redis 扩展，需自己编译或用
docker-php-ext-install redis（若基础镜像支持）
连接串里的 database 参数在 FrankenPHP 下容易被忽略
PHP 原生 Redis Session 处理器对 session.save_path 解析较弱，FrankenPHP 未做额外兼容。如果你写的是 tcp://127.0.0.1:6379?database=1，部分 FrankenPHP 版本会把整个 query string 当作 host 解析，连错端口或直接 fallback 到默认 db 0。
这不是 bug，而是底层 phpredis 扩展解析逻辑在不同 SAPI 下行为不一致导致的——尤其当 URL 中含特殊字符（如 &、=）时更易出问题。
- 最稳写法是去掉 query 参数，改用
tcp://127.0.0.1:6379?auth=yourpass+ 在代码里用ini_set('session.redis_database', '1')单独设（仅限 phpredis ≥ 5.3.7） - 若用密码，务必用
auth参数，不要塞进user:pass@host格式，FrankenPHP 会截断 - 测试是否真连对库：用
redis-cli -n 1 keys "PHPREDIS_SESSION:*"查键，而不是只看 db 0
多实例部署时，session.cookie_domain 必须显式设置
FrankenPHP 常用于边缘部署或单机多租户场景，比如一个进程跑多个子域名应用。此时即使 Redis 共享了，若 session.cookie_domain 没统一设为 .example.com，浏览器发请求时不会带上跨子域的 Cookie，PHPSESSID 就无法传递过去，看起来像“Redis 没存进去”，其实是压根没触发写入。
这个参数不像 session.save_handler 那样能写进 php.ini 全局生效——FrankenPHP 的 cookie 设置受响应头控制，必须在每个入口脚本开头调用 ini_set('session.cookie_domain', '.example.com')，或在路由前统一注入。
- 不要依赖
php.ini里的session.cookie_domain，FrankenPHP 对它的支持不稳定 - 若用 HTTPS，必须加
session.cookie_secure = 1，否则 Chrome 会拒绝发送 Cookie - 开发时用
localhost测试？不行——浏览器不支持.localhost，得换成本地域名如app.test并配 hosts
