萬盛學電腦網

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

PHP Cookie 完整指南:建立、讀取、陣列、時間控制與安全限制實戰

Cookie 核心機制與運作流程

Cookie 是 HTTP 協議的狀態管理機制,伺服器透過 Set-Cookie 標頭寫入瀏覽器,瀏覽器後續請求自動攜帶 Cookie 標頭回傳。本文系統講解 PHP Cookie 全生命周期操作與安全實踐。

Cookie 建立:setcookie() 完全解析

函數簽名

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

參數詳解

參數說明最佳實踐
nameCookie 名稱(鍵名)使用前綴避免衝突,如 app_user_id
value儲存值(字串)敏感資料勿存,複雜結構用 JSON 序列化
expires過期 Unix 時間戳time() + 3600 (1小時),0=會話結束
path生效路徑/ 全站有效,/admin 僅後台
domain生效域名.example.com 含子域,留空=當前域
secure僅 HTTPS 傳輸生產環境必須 true
httponlyJS 無法讀取防 XSS 必須 true

基礎建立範例

<?php
// 簡單 Cookie:1小時有效
setcookie("c1", "my name is Rose", time() + 3600);

// 完整安全配置(生產環境標準)
setcookie(
    "app_session",
    $sessionId,
    time() + 86400,      // 1天
    "/",                 // 全路徑
    ".example.com",      // 含子域
    true,                // 僅 HTTPS
    true                 // HttpOnly
);
?>

Cookie 讀取:$_COOKIE 超全域陣列

<?php
// 讀取單一值
if (isset($_COOKIE['c1'])) {
    echo "c1 的值: " . $_COOKIE['c1'] . "<br>";
}

// 安全讀取模式
$c1 = $_COOKIE['c1'] ?? 'default_value';

// 遍歷所有 Cookie
foreach ($_COOKIE as $key => $value) {
    echo htmlspecialchars($key) . " = " . htmlspecialchars($value) . "<br>";
}
?>

注意:$_COOKIE 僅包含瀏覽器發送的 Cookie,當前請求設定的 Cookie 不會立即出現在 $_COOKIE 中(需下次請求)。

Cookie 時間控制策略

時間設定模式

<?php
// 相對時間:秒數
setcookie("a", "10", time() + 60);      // 60秒後過期
setcookie("a", "10", time() - 60);      // 立即刪除(過去時間)

// 絕對時間:mktime(時,分,秒,月,日,年)
setcookie("a", "10", mktime(0, 0, 0, 11, 1, 2025));  // 2025-11-01 00:00:00 過期

// 會話 Cookie(關閉瀏覽器失效)
setcookie("session_id", $sid);  // 無 expires 參數
?>

實戰:訪問計數器

<?php
$count = ($_COOKIE['visit_count'] ?? 0) + 1;
setcookie("visit_count", $count, time() + 86400 * 30, "/");  // 30天
echo "這是您的第 $count 次訪問!";
?>

Cookie 陣列:結構化資料儲存

建立陣列 Cookie

<?php
setcookie('user[name]', 'Rose');
setcookie('user[email]', 'rose@example.com');
setcookie('user[role]', 'admin');

// 或批次
$userData = ['name'=>'Rose', 'email'=>'rose@example.com', 'role'=>'admin'];
foreach ($userData as $k => $v) {
    setcookie("user[$k]", $v, time()+3600);
}
?>

讀取陣列 Cookie

<?php
if (isset($_COOKIE['user']) && is_array($_COOKIE['user'])) {
    foreach ($_COOKIE['user'] as $key => $value) {
        echo htmlspecialchars($key) . ": " . htmlspecialchars($value) . "<br>";
    }
} else {
    echo "用戶 Cookie 不存在或格式錯誤";
}
?>

瀏覽器與協議限制(必知紅線)

限制項目標準值影響
單個 Cookie 大小4 KB超過會被截斷/拒絕
單域名 Cookie 數量20~50 個(瀏覽器差異)超過會淘汰舊 Cookie
總 Cookie 數量300~1000 個跨域名總計
用戶可禁用瀏覽器設定需優雅降級(如 URL 重寫 Session ID)
同源策略跨域不發送需 domain 參數配置共享

安全強化清單

  1. HttpOnly 標記:防止 XSS 竊取 setcookie(..., true, true)
  2. Secure 標記:強制 HTTPS 傳輸,防止中間人攻擊
  3. SameSite 屬性(PHP 7.3+):setcookie(..., ['samesite' => 'Lax']) 防 CSRF
  4. 敏感資料加密:Cookie 值加密儲存(如 openssl_encrypt)
  5. 簽名驗證:HMAC 簽名防篡改 hash_hmac('sha256', $value, $secret)
  6. 最小權限原則:path/domain 盡可能限縮範圍

進階:PHP 7.3+ 選項陣列語法

<?php
setcookie("modern_cookie", $value, [
    'expires' => time() + 86400,
    'path' => '/',
    'domain' => '.example.com',
    'secure' => true,
    'httponly' => true,
    'samesite' => 'Lax'  // 'Strict' | 'Lax' | 'None'
]);
?>

常見問題排查

現象可能原因解決方案
setcookie 無效輸出前有輸出(空白、BOM、echo)確保 setcookie 在任何輸出前調用,或啟用 output_buffering
子域無法共享domain 未設定或格式錯誤設定 .example.com(前綴點號)
刪除不生效path/domain 不匹配原設定刪除時完全複製原建立參數
中文亂碼未編碼存入前 urlencode(),讀取後 urldecode()

總結

Cookie 是無狀態 HTTP 的狀態延伸。掌握 setcookie() 完整參數、時間控制、陣列結構與安全屬性,配合瀏覽器限制認知,能構建可靠的客戶端狀態管理。現代開發優先考慮 HttpOnly + Secure + SameSite 三重防護,敏感狀態轉用 Server-side Session + Cookie 存 Session ID 架構。

copyright © 萬盛學電腦網 all rights reserved