PHP官方session_regenerate_id替代代码致SESSION为空问题求助

PHP官方手册中提到应避免使用session_regenerate_id()，因为网络不稳定时可能引发登出问题。我采用官方提供的替代代码后，出现新会话中$_SESSION数组为空的异常。添加die语句调试后确认，调用替代函数时新启动的会话里$_SESSION完全为空。

当前使用PHP 8.1.26版本，session_commit()和session_start()均返回true，目前只能换回原session_regenerate_id()函数。使用的替代代码如下：

function regenerateId(): bool {
    // code protecting against logouts due to unstable internet connections 
    // copied from php.net session_regenerate_id page

    // New session ID is required to set proper session ID
    // when session ID is not set due to unstable network.
    $new_session_id = session_create_id();
    $_SESSION['new_session_id'] = $new_session_id;
    // Set destroy timestamp
    $_SESSION['destroyed'] = time();
        
    // Write and close current session;
    session_commit() ;

    // Start session with new session ID
    ini_set('session.use_strict_mode', 0);
    session_id($new_session_id);
    $result = session_start();
    //ini_set('session.use_strict_mode', 1); // gives error, removed from example
    die('<pre>'.$result.'/'.$new_session_id.'<br>'.print_r($_SESSION,true));
            
    // New session does not need them
    unset($_SESSION['destroyed']);
    unset($_SESSION['new_session_id']);
    // die('regenerated: '. $_SESSION['UID']);
    return $result ;
}

请问为何官方代码会导致$_SESSION为空？该如何修复？

原因 #

1. 会话数据未自动迁移：PHP的会话机制中，新会话ID对应的存储单元是全新的，不会自动复制旧会话的数据。原代码仅在旧会话中存入new_session_id和destroyed字段，提交旧会话后启动新会话时，新会话加载的是对应新ID的空存储，自然$_SESSION为空。
2. 官方示例的完整性缺失：你使用的是示例的片段，完整逻辑中还包含后续的旧会话数据迁移和清理步骤，仅截取部分代码会导致数据丢失。

修复方案 #

需要手动将旧会话的全部数据迁移到新会话中，修改后的代码如下：

function regenerateId(): bool {
    // 保存旧会话的全部数据
    $old_session_data = $_SESSION;

    // 生成新会话ID并标记旧会话销毁时间
    $new_session_id = session_create_id();
    $old_session_data['new_session_id'] = $new_session_id;
    $old_session_data['destroyed'] = time();
    
    // 将更新后的旧会话数据写回并关闭
    $_SESSION = $old_session_data;
    session_commit();

    // 启动新会话
    ini_set('session.use_strict_mode', 0);
    session_id($new_session_id);
    $result = session_start();
    ini_set('session.use_strict_mode', 1); // 恢复严格模式，PHP 8.1支持，若报错可检查全局配置

    // 迁移旧会话数据并清理临时字段
    $_SESSION = $old_session_data;
    unset($_SESSION['destroyed']);
    unset($_SESSION['new_session_id']);

    return $result;
}

关键修改说明 #

• 提前备份旧会话的全部数据到临时变量，确保不会丢失原有会话信息
• 在旧会话提交前，将新会话ID和销毁标记存入旧会话数据，用于后续旧会话的清理逻辑
• 新会话启动后，将备份的旧数据赋值给新会话的$_SESSION，再移除临时标记字段

另外，完整的官方逻辑还包含对旧会话的定时清理（比如在每个请求开始时检查并销毁标记过的旧会话），建议结合这部分逻辑使用，避免服务器上堆积无效的旧会话数据。

内容的提问来源于stack exchange，提问作者Roemer