session改存redis迁到FrankenPHP配置要动吗-php教程-PHP中文网

frankenphp 中 session.save_handler 配置依然生效，但需确保 php.ini 路径正确、redis.so 扩展显式加载、session.cookie_domain 显式设置且避免 save_path 中使用 database 查询参数。

session改存redis迁到frankenphp配置要动吗

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 或静默忽略。

Pub Session Logs

使用 jq 搜索和分析您自己的会话日志。还有 50+ 模型用于图像生成、视频生成、语音合成、语音识别、音乐、聊天等

下载

先运行 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')，或在路由前统一注入。