Cookie 是 HTTP 協定維持狀態的機制,伺服器透過 Set-Cookie 標頭送至瀏覽器,瀏覽器後續請求自動攜帶。PHP 提供 setcookie() 設定、$_COOKIE 讀取。本文完整說明生命週期、安全屬性、常見陷阱與現代替代方案。
Set-Cookie: name=value; Expires=...; Path=/; Domain=...; Secure; HttpOnly; SameSite=LaxCookie: name=value 標頭$_COOKIE 超全域陣列<?php
setcookie(
string $name, // Cookie 名稱(必填)
string $value = "", // 值(自動 URL 編碼)
int $expires = 0, // 到期 Unix 時間戳,0=Session 結束
string $path = "", // 生效路徑,/ 為全站
string $domain = "", // 生效域名,.example.com 含子域
bool $secure = false, // 僅 HTTPS 傳送
bool $httponly = false // 僅 HTTP 傳送,JS 無法存取 (防 XSS)
): bool;
// PHP 7.3+ 替代語法:選項陣列
setcookie('name', 'value', [
'expires' => time() + 3600,
'path' => '/',
'domain' => '.example.com',
'secure' => true,
'httponly' => true,
'samesite' => 'Lax', // None, Lax, Strict
]);
?>
<?php
// 必須在任何輸出之前呼叫!
setcookie('user', 'Alex Porter');
?>
<?php
// 1 小時後過期
setcookie('user', 'Alex Porter', time() + 3600);
// 30 天過期(推薦寫法)
$expire = time() + 60 * 60 * 24 * 30;
setcookie('user', 'Alex Porter', $expire, '/', '', true, true);
// 參數順序:name, value, expire, path, domain, secure, httponly
?>
<?php
// 讀取單一 Cookie
if (isset($_COOKIE['user'])) {
echo "Welcome " . htmlspecialchars($_COOKIE['user']) . "!";
} else {
echo "Welcome guest!";
}
// 除錯:檢視所有 Cookie
var_dump($_COOKIE);
?>
設定過去時間即可:
<?php
// 1 小時前過期
setcookie('user', '', time() - 3600);
// PHP 7.3+ 選項寫法
setcookie('user', '', [
'expires' => time() - 3600,
'path' => '/',
]);
?>
| 屬性 | 用途 | 建議值 | 說明 |
|---|---|---|---|
HttpOnly | 防止 JavaScript 存取 | true | 緩解 XSS 竊取 Session ID |
Secure | 僅 HTTPS 傳輸 | true (生產環境) | 防止中間人攻擊竊取 |
SameSite | 跨站請求攜帶控制 | Lax 或 Strict | 防禦 CSRF,Lax 允許導航連結攜帶 |
Path | 限制生效路徑 | / |
避免洩漏給不需存取的路徑 |
Domain | 限制生效域名 | .example.com |
共享子域,謹慎設定 |
<?php
// 錯誤:前面有空白/HTML 輸出
echo "Hello";
setcookie('test', 'value'); // Warning: Cannot modify header information
// 正確:輸出緩衝或調整順序
ob_start(); // 頁面最開頭
setcookie('test', 'value');
echo "Hello";
ob_end_flush();
?>
Path 優先Domain 優先<?php
$prefs = ['theme'=>'dark', 'lang'=>'zh-TW'];
setcookie('prefs', json_encode($prefs), time()+86400, '/', '', true, true);
// 讀取
$prefs = json_decode($_COOKIE['prefs'] ?? '{}', true);
?>
<?php
// 主域 example.com 設定
setcookie('session_id', 'abc123', [
'expires' => time() + 3600,
'path' => '/',
'domain' => '.example.com', // 開頭點號包含所有子域
'secure' => true,
'httponly' => true,
'samesite' => 'Lax',
]);
// api.example.com、shop.example.com 皆可讀取
?>
| 特性 | Cookie | Session | LocalStorage |
|---|---|---|---|
| 儲存位置 | 客戶端 | 伺服器端(檔案/Redis/DB) | 客戶端 |
| 容量 | ~4KB | 無實質限制 | ~5-10MB |
| 自動攜帶 | 是(每請求) | 僅 Session ID | 否(需 JS 手動) |
| 過期控制 | Expires/Max-Age | 伺服器控制 + gc_maxlifetime | 永久(手動清除) |
| JS 存取 | 預設可(除 HttpOnly) | 不可 | 可 |
| 主要用途 | 追蹤、偏好、跨域認證 | 用戶狀態、權限、購物車 | 客戶端快取、離線資料 |
<form action="welcome.php" method="post">
<input type="hidden" name="user_id" value="<?= h($userId) ?>" />
<input type="submit" value="繼續" />
</form>
<a href="/profile/<?= $userId ?>?sid=<?= session_id() ?>">個人資料</a>
session_id。非敏感偏好設定(主題、語言)可用 Cookie 或 LocalStorage。SameSite=Lax 是現代預設良好平衡。