萬盛學電腦網

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

PHP Cookie 完整操作指南:建立、讀取、刪除、安全設定與最佳實務

Cookie 是 HTTP 協定中維持客戶端狀態的關鍵機制。PHP 透過 setcookie() 發送 Set-Cookie 標頭,透過 $_COOKIE 超全域陣列讀取。本文完整涵蓋 Cookie 全生命週期操作、屬性設定、安全屬性與常見坑點。

核心操作

1. 建立/更新 Cookie

<?php
// 基本語法:setcookie(name, value, expire, path, domain, secure, httponly)
// expire: Unix 時間戳,0 或省略 = 瀏覽器關閉即失效 (Session Cookie)

// 例:建立 2 週有效期的 Cookie
setcookie('UserName', 'zs', [
    'expires'  => time() + 14 * 24 * 3600,
    'path'     => '/',
    'domain'   => '',           // 當前域名,含子域名可設 '.example.com'
    'secure'   => true,         // 僅 HTTPS 傳輸 (生產環境必開)
    'httponly' => true,         // 禁止 JS 存取 (防 XSS)
    'samesite' => 'Lax',        // CSRF 保護: Lax/Strict/None
]);

// 簡寫 (PHP 7.3+ 支援陣列選項)
setcookie('Theme', 'dark', time() + 86400 * 30, '/', '', true, true);
?>

2. 讀取 Cookie

<?php
// 直接存取超全域陣列
$username = $_COOKIE['UserName'] ?? 'Guest';

// 安全讀取模式:檢查存在性
if (!empty($_COOKIE['UserName'])) {
    $username = htmlspecialchars($_COOKIE['UserName'], ENT_QUOTES, 'UTF-8');
}
?>

3. 刪除 Cookie

<?php
// 方法 1:設定過期時間為過去
setcookie('UserName', '', time() - 3600, '/');

// 方法 2:值設為空字串 + 過期時間
setcookie('UserName', '', ['expires' => time() - 3600, 'path' => '/']);

// 方法 3:PHP 7.3+ 選項陣列
setcookie('UserName', '', ['expires' => -1, 'path' => '/']);

// 批次刪除當前域名下所有 Cookie
foreach ($_COOKIE as $key => $val) {
    setcookie($key, '', ['expires' => -1, 'path' => '/']);
}
?>

Cookie 屬性詳細說明

屬性用途建議設定
Expires/Max-Age有效期限Max-Age 以秒為單位較直觀 (PHP 7.3+ 支援)
Path生效路徑通常設 / 全站可用
Domain生效域名省略=當前域名;.example.com 含所有子域名
Secure僅 HTTPS 傳送生產環境 必須 true
HttpOnly禁止 JS 存取必須 true 防 XSS 竊取
SameSite跨站請求攜帶策略Lax (預設) 平衡體驗與安全;關鍵操作用 Strict;跨域需 None+Secure

進階應用場景

記住登入 (Remember Me)

<?php
// 登入成功後
$selector = bin2hex(random_bytes(16));
$validator = bin2hex(random_bytes(32));
$hash = hash('sha256', $validator);

// 儲存至資料庫:selector, hash, user_id, expires
// 發送 Cookie (有效期 30 天)
setcookie('remember_me', $selector . ':' . $validator, [
    'expires'  => time() + 30 * 86400,
    'path'     => '/',
    'secure'   => true,
    'httponly' => true,
    'samesite' => 'Lax',
]);
?>

購物車 / 偏好設定 (客戶端儲存)

<?php
// 將購物車資料 JSON 編碼存入 Cookie (注意 4KB 大小限制)
$cart = ['items' => [...], 'updated' => time()];
setcookie('cart', json_encode($cart), [
    'expires' => time() + 30 * 86400,
    'path'    => '/',
    'httponly' => true, // 不需 JS 讀取
]);
?>

安全性檢查清單

  • ✅ 敏感資料勿存 Cookie:密碼、Token、個資應存 Server-side Session/DB,Cookie 僅存識別 ID
  • ✅ 簽名驗證:重要 Cookie 值加上 HMAC 簽名,防篡改 hash_hmac('sha256', $value, $secret)
  • ✅ 加密儲存:若必須在 Cookie 存敏感資訊,使用 openssl_encrypt AES-256-GCM 加密
  • ✅ 定期輪換:重要 Cookie 設定較短有效期,配合伺服端驗證自動續期
  • ✅ GDPR 合規:提供 Cookie 同意横幅、分類說明、拒絕/撤回機制

常見問題排查

copyright © 萬盛學電腦網 all rights reserved
問題原因解決
setcookie 無效在輸出內容後呼叫 (含空白、BOM)確保在任何 HTML/echo 之前呼叫;開啟 output_buffering
子域名無法共享Domain 設定錯誤設定 .example.com (前綴點號)
HTTPS 站點 Cookie 不送出Secure 屬性未設、或 SameSite=None 缺 Secure同時設定 Secure=true, SameSite=None
Cookie 超過 4KB 被截斷瀏覽器單一 Cookie 大小限制改用 Session/資料庫/IndexedDB 儲存大量資料