WordPress 4.9.3中$_COOKIE与session_start()问题：已解决但求原理

嘿，很高兴你已经搞定了问题！虽然你没说具体是怎么修复的，但这种「Cookie明明设置好了，回到首页却读不出来」的情况，在WordPress老版本里太常见了，我帮你梳理几个最可能的原因，你对照下应该能找到答案：

1. 钩子执行顺序踩坑了 #

WordPress的钩子有严格的执行顺序，如果你在**init钩子之前**就尝试读取Cookie，大概率会出问题。比如你把读取Cookie的代码直接塞到了主题header.php的最顶部，或者用了wp_loaded之前的钩子——这时候PHP还没完成全局变量的初始化，哪怕Cookie在浏览器里存在，PHP也读不到$_COOKIE里的对应值。

后来你可能把读取逻辑移到了init或者template_redirect钩子（优先级设高一点，比如10之后），这时候WordPress已经完成了基础初始化，自然就能正确读取Cookie了。

举个正确的读取示例：

// 把Cookie检查放在init钩子之后执行
add_action('init', 'check_user_custom_cookie', 15);
function check_user_custom_cookie() {
    global $show_custom_content;
    // 现在读取Cookie就没问题了
    $show_custom_content = isset($_COOKIE['user_has_visited_inner']) && $_COOKIE['user_has_visited_inner'] === 'yes';
}

2. 缓存把动态逻辑「吃掉」了 #

WordPress 4.9.3的站点十有八九装了缓存插件（比如WP Super Cache、W3 Total Cache），或者用了主机自带的静态缓存。当用户从内页返回首页时，如果首页是已经缓存好的静态HTML，那你的PHP代码根本不会执行——自然也就不会检查Cookie，直接显示通用元素了。

你可能后来做了这几件事之一：

• 给首页禁用了静态缓存
• 把Cookie相关的动态内容设置为「缓存排除项」
• 用了缓存插件的「动态片段」功能，让检查Cookie的部分每次都动态生成

3. Cookie的路径/域设置错误 #

设置Cookie的时候，如果path参数没设对，会导致Cookie只能在特定路径下访问。比如你在内页设置Cookie时，path写成了当前内页的路径（比如/2024/05/post-name/），那回到首页（根路径/）时，浏览器根本不会把这个Cookie发送给服务器，PHP自然读不到。

正确的Cookie设置应该把path设为/，让全站都能访问：

// 内页设置Cookie的正确姿势
add_action('template_redirect', 'set_user_visited_cookie');
function set_user_visited_cookie() {
    if (is_single() || is_page()) { // 判断是否是内页
        // 路径设为/，域用当前站点的域名，支持HTTPS
        setcookie(
            'user_has_visited_inner',
            'yes',
            time() + 3600 * 24 * 7, // 有效期7天
            '/',
            $_SERVER['HTTP_HOST'],
            is_ssl()
        );
    }
}

另外，如果你的站点同时有www和非www域名，Cookie的domain参数没统一的话，也会出现Cookie跨域名读不到的情况，调整后就正常了。

4. 输出缓冲或HTTP头的小问题 #

虽然这个概率低，但也有可能：如果你的代码在读取Cookie之前，不小心输出了空格、换行或者HTML内容（比如主题文件里的空白字符），会导致HTTP头提前发送——不过读取Cookie其实不需要修改HTTP头，所以更多是钩子顺序的连带问题。但如果你之前用了某些会输出内容的函数，干扰了正常的执行流程，调整后也会解决问题。

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