FrankenPHP 1.4 中配置 Redis 存储 Session 与标准 PHP 一致：需启用 redis 扩展、正确设置 session.save_handler 和 session.save_path，并在 session_start() 前完成配置。
FrankenPHP 1.4 是基于 PHP 的现代 SAPI（Server API），专为高性能、低延迟 Web 服务设计，支持原生 HTTP/3、FastCGI over QUIC，并深度集成 PHP 运行时。它本身不内置 session 存储逻辑，而是复用 PHP 标准的 session 管理机制 —— 换句话说：*FrankenPHP 的 session 行为完全由 PHP 的 `session.` 配置和底层 handler 决定**，和传统 PHP-FPM 或 CLI 模式一致。
因此，配置 Redis 替代原生文件存储 session，在 FrankenPHP 1.4 中和在其他 PHP SAPI 中方法相同，只需确保：
- PHP 已安装并启用
redis扩展（非phpredis的旧别名，而是官方redis扩展） - Redis 服务可访问（本地或远程）
- 在 PHP 配置中正确设置
session.save_handler和session.save_path
✅ 步骤一：确认 redis 扩展已启用
运行以下命令验证：
frankenphp php -m | grep redis
或创建一个 info.php：
立即学习“PHP免费学习笔记（深入）”；
<?php phpinfo();
查看输出中是否包含 redis 模块，且版本 ≥ 5.3.7（推荐 ≥ 6.0）。若无，请先安装：
# Ubuntu/Debian（以 php8.2 为例） sudo apt install php8.2-redis # 或源码编译安装后，确保 extension=redis.so 出现在 php.ini 中
⚠️ 注意：FrankenPHP 使用自己的 PHP 二进制（如
frankenphp php），需确认该二进制加载的是你修改的php.ini。可通过frankenphp php --ini查看加载路径。
✅ 步骤二：配置 PHP 使用 Redis 存储 Session
有两种等效方式，推荐方式二（代码内动态配置），因 FrankenPHP 常以单文件或嵌入模式启动，便于环境隔离：
方式一：修改 php.ini
在 php.ini（FrankenPHP 加载的那个）中添加或修改：
; 启用 Redis 作为 session 处理器 session.save_handler = redis ; 连接地址格式：tcp://host:port?auth=密码&database=库号&timeout=秒 session.save_path = "tcp://127.0.0.1:6379?auth=myredispass&database=2" ; 可选：强制签名 session cookie（增强安全） session.use_strict_mode = 1 session.cookie_httponly = 1 session.cookie_secure = 1 ; 若走 HTTPS
✅ 修改后重启 FrankenPHP（或重新加载配置）。
方式二：在应用入口（如 public/index.php）顶部动态设置（更灵活）
<?php
// 必须在 session_start() 之前调用
if (extension_loaded('redis')) {
ini_set('session.save_handler', 'redis');
ini_set('session.save_path', 'tcp://127.0.0.1:6379?auth=myredispass&database=2');
ini_set('session.use_cookies', '1');
ini_set('session.cookie_httponly', '1');
ini_set('session.cookie_secure', '1'); // 生产环境建议开启
}
session_start();
$_SESSION['test'] = 'hello from frankenphp + redis';
echo $_SESSION['test'];? 关键点：
session_start()必须在所有ini_set之后、且在任何输出之前调用。
✅ 步骤三：验证 Session 是否写入 Redis
执行以下 PHP 脚本（或用 redis-cli）检查：
<?php
$redis = new Redis();
$redis->connect('127.0.0.1', 6379);
$redis->auth('myredispass');
$redis->select(2);
// 查找 PHPSESSID 开头的 key（实际前缀是 'PHPREDIS_SESSION:'，但取决于扩展行为）
$keys = $redis->keys('PHPREDIS_SESSION:*');
print_r($keys);
if (!empty($keys)) {
echo "Session found: " . $redis->get($keys[0]) . "\n";
}或者终端直连：
redis-cli -h 127.0.0.1 -p 6379 -a myredispass -n 2 keys "PHPREDIS_SESSION:*" redis-cli -h 127.0.0.1 -p 6379 -a myredispass -n 2 get "PHPREDIS_SESSION:abc123..."
✅ 补充说明：多实例 / 负载均衡场景
FrankenPHP 常用于边缘部署或轻量微服务，若你有多个 FrankenPHP 实例（如 Docker 多副本或不同机器），只要它们都指向同一个 Redis 实例（或 Redis Cluster），即可天然实现 session 共享 —— 不需要额外粘性会话（sticky session）。
Redis 的原子性与高并发读写能力，使其比文件存储更适合 FrankenPHP 这类低延迟、高吞吐场景。
❌ 常见问题排查
-
session_start(): Failed to read session data→ 检查session.save_path地址/端口/密码是否匹配 Redis 实际配置；确认 Redis 允许远程连接（bind和protected-mode no） -
Class 'Redis' not found→redis扩展未启用，或 FrankenPHP 使用了另一个 PHP ini 文件 - Session 写入但无法读取 → 检查
session.name是否一致（默认PHPSESSID），以及 Cookie 是否被浏览器拦截（注意Secure/SameSite属性） - 使用 Unix socket？支持，格式为
unix:///var/run/redis/redis-server.sock?database=2
FrankenPHP 本身不干预 session 生命周期，它只是高效地运行业务 PHP 代码。所以 Redis 替代 session，本质是「让 PHP 自己用 Redis 存」——配置对了，就自然生效。
