萬盛學電腦網

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

PHP HTTP Cookie 完整指南:設定、讀取、安全屬性與最佳實務

Cookie 基本機制

Cookie 是伺服器透過 HTTP 回應標頭 Set-Cookie 送至瀏覽器的小型資料片段,瀏覽器後續請求會自動攜帶在 Cookie 請求標頭中。PHP 將接收到的 Cookie 自動解析為超全域陣列 $_COOKIE。

核心函數:setcookie() / setrawcookie()

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

// PHP 7.3+ 支援選項陣列寫法(推薦)
setcookie('name', 'value', [
    'expires' => time() + 3600,
    'path' => '/',
    'domain' => 'example.com',
    'secure' => true,
    'httponly' => true,
    'samesite' => 'Lax'  // PHP 7.3+:None/Lax/Strict
]);

關鍵參數詳解

讀取與多值 Cookie

// 讀取單值
$value = $_COOKIE['user_pref'] ?? 'default';

// 多值:名稱加 []
setcookie('fruits[]', 'apple');
setcookie('fruits[]', 'banana');
// $_COOKIE['fruits'] => ['apple', 'banana']

關鍵限制:輸出緩衝與標頭順序

setcookie() 必須在**任何輸出之前**呼叫(含空白字元、BOM、echo、HTML、var_dump)。否則觸發 Warning: Cannot modify header information - headers already sent。

解決方案:

  • 腳本最頂端呼叫,前面零輸出
  • 開啟 output_buffering = On(php.ini)或腳本開頭 ob_start()
  • 使用框架的 Response 物件統一管理標頭

安全強化清單

  1. 簽名/加密敏感 Cookie:使用 hash_hmac() 或 openssl_encrypt(),防範竄改
  2. Session ID 必須 HttpOnly + Secure + SameSite
  3. 前綴機制:__Host-(需 Secure、Path=/、無 Domain)、__Secure-(需 Secure)—— 瀏覽器強制驗證屬性
  4. 定期輪換:登入/權限變更時重新發放 Session ID
  5. 刪除 Cookie:setcookie('name', '', time() - 3600, '/');(同名、同路徑、同域名、過期時間為過去)

常見陷阱

  • 子域名共享:domain=.example.com 可讓 a.example.com 讀取 b.example.com 設定的 Cookie,但需注意安全邊界
  • 大小限制:單 Cookie ≤ 4KB,總數每域名約 50-180 個,超量會被瀏覽器忽略
  • 編碼問題:值含特殊字元需 urlencode() / urldecode()(PHP 自動處理 $_COOKIE)
  • P3P 政策:IE/舊版 Edge 第三方 Cookie 需 P3P 標頭,現代瀏覽器已棄用

現代替代方案

  • Session 儲存於伺服器端(Redis/Memcached/Database),Cookie 僅存 Session ID
  • JWT (JSON Web Token):無狀態認證,攜帶於 Authorization 標頭
  • LocalStorage / IndexedDB:純客戶端儲存,不隨請求自動發送,適合大量非敏感資料
copyright © 萬盛學電腦網 all rights reserved
參數說明安全建議
expiresUnix 時間戳;0 或省略 = 會話期 Cookie(關閉瀏覽器失效)敏感資料勿設長期效期
path生效路徑,預設為當前腳本目錄通常設 / 全站生效
domain生效域名,預設為當前主機;.example.com 含子域名最小權限原則,避免 domain=.com
secure僅 HTTPS 傳輸生產環境必須 true
httponly禁止 JavaScript 存取(document.cookie)防 XSS 必開 true
samesite跨站請求攜帶策略Lax 平衡體驗與安全;關鍵操作用 Strict;跨域需 None+Secure