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