WordPress中functions.php存库后$_SESSION变量无法传递至目标页面求助

在WordPress环境中直接使用原生session_start()很容易出现会话丢失的问题，核心原因是WordPress有自身的会话管理逻辑，且原生会话初始化时机、配置容易和WordPress的流程冲突。以下是针对性的解决步骤：

1. 用WordPress钩子正确初始化会话 #

不要在页面里随意调用session_start()，改用init钩子统一处理会话初始化，确保在所有输出前执行，同时避免冲突：

// 放到functions.php里
add_action('init', 'wp_custom_init_session');
function wp_custom_init_session() {
    if (!session_id()) {
        // 配置会话Cookie的安全参数，适配站点环境
        $cookie_domain = ($_SERVER['HTTP_HOST'] !== 'localhost') ? '.' . $_SERVER['HTTP_HOST'] : false;
        session_set_cookie_params([
            'domain'   => $cookie_domain,
            'path'     => '/',
            'httponly' => true,
            'secure'   => is_ssl(), // 仅在HTTPS站点启用
            'samesite' => 'Strict'
        ]);
        session_start();
    }
}

2. 修正表单提交后的会话赋值逻辑 #

你当前的会话赋值代码可能时机不对，应该在admin_post的处理函数里完成赋值，确保会话已经初始化：

// 处理表单提交的函数（放到functions.php）
add_action('admin_post_order_form_submit', 'handle_order_form_submission');
add_action('admin_post_nopriv_order_form_submit', 'handle_order_form_submission');

function handle_order_form_submission() {
    // 确保会话已启动（保险措施）
    if (!session_id()) session_start();

    // 接收并 sanitize 表单数据
    if (isset($_POST['last_name'])) {
        $_SESSION['last_name'] = sanitize_text_field($_POST['last_name']);
    }

    // 执行数据库插入逻辑...

    // 改用WordPress原生跳转函数，确保会话Cookie正确传递
    wp_redirect(add_query_arg('success', '1', home_url('/client/upload-client/')));
    exit; // 必须加exit终止后续代码执行
}

同时要给表单添加隐藏字段，指定处理动作：

<input type="hidden" name="action" value="order_form_submit">

3. 目标页面正确读取会话变量 #

在upload-client/页面模板中，确保会话已初始化后再读取：

// 目标页面模板代码
if (isset($_SESSION['last_name'])) {
    echo '姓氏：' . esc_html($_SESSION['last_name']);
    // 用完后建议销毁该变量，避免重复使用
    unset($_SESSION['last_name']);
} else {
    echo '会话中未找到姓氏信息';
}

4. 排查常见问题 #

• 检查缓存插件：暂时禁用WP Rocket、W3 Total Cache等缓存插件，缓存会导致会话无法实时传递。
• 查看调试日志：在wp-config.php中开启调试模式define('WP_DEBUG', true);，检查是否有headers already sent报错（这类错误会直接导致会话启动失败）。
• 服务器会话目录权限：服务器的默认会话存储目录（通常是/tmp）可能权限不足，可在wp-config.php中自定义存储路径：

  define('SESSION_SAVE_PATH', WP_CONTENT_DIR . '/sessions');
  

  然后在wp-content下创建sessions文件夹，设置权限为700。
• 浏览器隐私设置：不要用隐私模式测试，部分浏览器隐私模式会阻止会话Cookie存储。

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