萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

PHP Cookie 即時生效技巧:同步 $_COOKIE 避免頁面刷新延遲

問題背景

setcookie() 發送 Set-Cookie 響應頭,瀏覽器需在**下一次請求**才攜帶該 Cookie,導致當前請求中 $_COOKIE 仍為舊值。若需在設置後立即讀取,必須手動同步 $_COOKIE 超全局變量。

解決方案:封裝 setCookie 方法

/**
 * 設置 Cookie 並即時生效
 * @param string $name   Cookie 名
 * @param mixed  $value  值(支持陣列)
 * @param int    $expire 過期時間戳,默認 1 天
 */
public final function setCookie($name, $value, $expire = null) {
    if (empty($value)) return; // 空值不處理

    $expire = $expire ?: (time() + 86400); // 默認 1 天

    // 關鍵:同步到當前請求的 $_COOKIE
    $_COOKIE[$name] = $value;

    // 發送 Set-Cookie 頭
    if (is_array($value)) {
        foreach ($value as $k => $v) {
            if (empty($v)) continue;
            setcookie($name . "[$k]", $v, $expire);
        }
    } else {
        setcookie($name, $value, $expire);
    }
}

使用示例

// 設置單值
$obj->setCookie('user_id', 1001);
// 當前請求即可讀取
echo $_COOKIE['user_id']; // 1001

// 設置陣列
$obj->setCookie('prefs', ['theme' => 'dark', 'lang' => 'zh']);
// 當前請求可讀取
print_r($_COOKIE['prefs']); // Array ( [theme] => dark [lang] => zh )

原理解析

  1. setcookie() 只發送響應頭,**不修改** 當前請求的 $_COOKIE。
  2. 手動賦值 $_COOKIE[$name] = $value 讓當前腳本「看到」新值。
  3. 下次請求瀏覽器自動攜帶 Cookie,$_COOKIE 自然包含新值,無衝突。

注意事項

  • 域/路徑一致性:若項目多子域/多路徑,需在 setcookie() 第 4、5 參數顯式指定 domain、path,並同步到 $_COOKIE 鍵名(陣列寫法自動處理)。
  • HttpOnly/Secure:生產環境建議第 6、7 參數設置 true, true(需 HTTPS)。
  • 陣列深度:PHP Cookie 陣列僅支持一維,多維需自行序列化(JSON)。
  • 大小限制:單 Cookie ≤ 4KB,總數 ≤ 300,超出會被瀏覽器忽略。

擴展:刪除 Cookie 同步

public final function deleteCookie($name) {
    unset($_COOKIE[$name]); // 即時移除
    setcookie($name, '', time() - 3600); // 發送過期頭
}

總結

「設置 Cookie → 同步 $_COOKIE → 發送響應頭」三步走,解決 PHP Cookie 即時生效痛點。封裝為工具方法後,業務代碼無感知,體驗絲滑。

copyright © 萬盛學電腦網 all rights reserved