萬盛學電腦網

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

PHP setcookie() 完全指南:設置、讀取、刪除、跨域與安全最佳實踐

Cookie 是 HTTP 協議實現有狀態會話的核心機制。PHP setcookie() 函數負責發送 Set-Cookie 響應頭,配合 $_COOKIE 超全局變量讀取。本文系統講解參數詳解、常見操作、跨域共享、安全屬性與 JavaScript 交互。

語法與參數詳解

setcookie(
    string $name,
    string $value = "",
    int $expires_or_options = 0,
    string $path = "",
    string $domain = "",
    bool $secure = false,
    bool $httponly = false
): bool

// PHP 7.3+ 支援選項陣列語法
setcookie($name, $value, [
    'expires' => time() + 3600,
    'path' => '/',
    'domain' => '.example.com',
    'secure' => true,
    'httponly' => true,
    'samesite' => 'Lax', // None|Lax|Strict
]);
| 參數 | 說明 | 建議值 | |------|------|--------| | name | Cookie 名稱 | 唯一標識 | | value | 值(自動 urlencode) | 避免敏感數據 | | expires | 過期時間戳 | time()+86400 (1天) | | path | 生效路徑 | / (全站) | | domain | 生效域名 | .example.com (含子域名) | | secure | 僅 HTTPS 傳輸 | true (生產必開) | | httponly | 禁止 JS 訪問 | true (防 XSS) | | samesite | CSRF 保護 | Lax 或 Strict |

基礎操作範例

設置 Cookie

<?php
// 簡單會話級 Cookie(瀏覽器關閉失效)
setcookie('lang', 'zh-CN');

// 持久化 1 小時
setcookie('pref_theme', 'dark', time() + 3600, '/');

// 完整參數:跨子域名、僅 HTTPS、防 XSS
setcookie('user_token', $token, [
    'expires' => time() + 86400 * 30,
    'path' => '/',
    'domain' => '.example.com', // 關鍵:前導點支援所有子域名
    'secure' => true,
    'httponly' => true,
    'samesite' => 'Lax',
]);
?>

讀取 Cookie

<?php
// 單個讀取
$lang = $_COOKIE['lang'] ?? 'en';

// 遍歷所有
foreach ($_COOKIE as $name => $value) {
    echo htmlspecialchars("$name = $value") . "
"; } // 調試輸出 print_r($_COOKIE); ?>

刪除 Cookie

<?php
// 設置過期時間為過去
setcookie('user_token', '', time() - 3600, '/', '.example.com', true, true);
// 或 PHP 7.3+ 選項陣列
setcookie('user_token', '', [
    'expires' => time() - 3600,
    'path' => '/',
    'domain' => '.example.com',
    'secure' => true,
    'httponly' => true,
]);
?>

關鍵:刪除時 path、domain、secure、httponly 必須與設置時**完全一致**,否則瀏覽器不會刪除。

進階場景

陣列 Cookie(多值同名)

<?php
setcookie('fruits[]', 'apple');
setcookie('fruits[]', 'banana');
setcookie('fruits[]', 'orange');

// 讀取時自動為陣列
print_r($_COOKIE['fruits']); // ['apple', 'banana', 'orange']
?>

子域名共享(單點登入基礎)

<?php
// 主域名 example.com 設置
setcookie('ssid', $sessionId, [
    'expires' => time() + 86400,
    'path' => '/',
    'domain' => '.example.com', // 關鍵:前導點
    'secure' => true,
    'httponly' => true,
    'samesite' => 'None', // 跨站請求需攜帶,配合 Secure
]);

// 子域名 a.example.com、b.example.com 自動攜帶此 Cookie
?>

JavaScript 交互

原生 JS 讀寫刪除

<script>
// 讀取
function getCookie(name) {
    const match = document.cookie.match(new RegExp('(^| )' + name + '=([^;]+)'));
    return match ? decodeURIComponent(match[2]) : null;
}

// 設置
function setCookie(name, value, days = 30) {
    const exp = new Date(Date.now() + days * 864e5).toUTCString();
    document.cookie = `${name}=${encodeURIComponent(value)};expires=${exp};path=/;SameSite=Lax`;
}

// 刪除
function deleteCookie(name) {
    setCookie(name, '', -1);
}

// 使用
console.log(getCookie('lang'));
setCookie('theme', 'dark', 7);
</script>

安全最佳實踐清單

  1. HttpOnly = true:防止 XSS 竊取 Cookie(除非需 JS 讀取)
  2. Secure = true:生產環境強制 HTTPS 傳輸
  3. SameSite = Lax/Strict:防禦 CSRF,跨站請求不攜帶 Cookie
  4. 域名最小化:.example.com 僅在需要跨子域時使用
  5. 路徑最小化:/api 僅在 API 路徑生效
  6. 不存敏感數據:Token、ID 簽名加密,避免明文存儲
  7. 簽名驗證:HMAC 簽名 Cookie 值,防篡改

常見坑點

  • setcookie() 必須在**任何輸出前**調用(含 BOM、空白、echo)
  • 當前請求 $_COOKIE 不會即時反映 setcookie() 設置,需下次請求生效
  • 同名 Cookie:路徑更具體者優先,瀏覽器發送順序不定
  • 超過 4KB 限制會被瀏覽器拒絕/截斷
  • 域名不匹配(如設置 example.com 但訪問 www.example.com)導致無效

總結

setcookie() 是 PHP 會話管理的基石。掌握 8 參數含義、跨域共享機制、安全屬性組合、JS 交互與避坑指南,能構建安全、可靠、符合現代瀏覽器策略的 Cookie 方案。現代項目推薦:HttpOnly+Secure+SameSite=Lax+最小權限域名路徑,敏感操作配合 CSRF Token 雙重防護。

copyright © 萬盛學電腦網 all rights reserved