Cookie 是 HTTP 協議的狀態管理機制,伺服器透過 Set-Cookie 標頭寫入瀏覽器,瀏覽器後續請求自動攜帶 Cookie 標頭回傳。本文系統講解 PHP Cookie 全生命周期操作與安全實踐。
setcookie(
string $name,
string $value = "",
int $expires_or_options = 0,
string $path = "",
string $domain = "",
bool $secure = false,
bool $httponly = false
): bool
| 參數 | 說明 | 最佳實踐 |
|---|---|---|
| name | Cookie 名稱(鍵名) | 使用前綴避免衝突,如 app_user_id |
| value | 儲存值(字串) | 敏感資料勿存,複雜結構用 JSON 序列化 |
| expires | 過期 Unix 時間戳 | time() + 3600 (1小時),0=會話結束 |
| path | 生效路徑 | / 全站有效,/admin 僅後台 |
| domain | 生效域名 | .example.com 含子域,留空=當前域 |
| secure | 僅 HTTPS 傳輸 | 生產環境必須 true |
| httponly | JS 無法讀取 | 防 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
);
?>
<?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 中(需下次請求)。
<?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 次訪問!";
?>
<?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);
}
?>
<?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 參數配置共享 |
setcookie(..., true, true)setcookie(..., ['samesite' => 'Lax']) 防 CSRFopenssl_encrypt)hash_hmac('sha256', $value, $secret)path/domain 盡可能限縮範圍<?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 架構。