Cookie 是 HTTP 協議實現有狀態會話的核心機制。PHP setcookie() 函數負責發送 Set-Cookie 響應頭,配合 $_COOKIE 超全局變量讀取。本文系統講解參數詳解、常見操作、跨域共享、安全屬性與 JavaScript 交互。
setcookie(
string $name,
string $value = "",
int $expires_or_options = 0,
string $path = "",
string $domain = "",
bool $secure = false,
bool $httponly = false
): bool
// PHP 7.3+ 支援選項陣列語法
setcookie($name, $value, [
'expires' => time() + 3600,
'path' => '/',
'domain' => '.example.com',
'secure' => true,
'httponly' => true,
'samesite' => 'Lax', // None|Lax|Strict
]);
| 參數 | 說明 | 建議值 |
|------|------|--------|
| name | Cookie 名稱 | 唯一標識 |
| value | 值(自動 urlencode) | 避免敏感數據 |
| expires | 過期時間戳 | time()+86400 (1天) |
| path | 生效路徑 | / (全站) |
| domain | 生效域名 | .example.com (含子域名) |
| secure | 僅 HTTPS 傳輸 | true (生產必開) |
| httponly | 禁止 JS 訪問 | true (防 XSS) |
| samesite | CSRF 保護 | Lax 或 Strict |
<?php
// 簡單會話級 Cookie(瀏覽器關閉失效)
setcookie('lang', 'zh-CN');
// 持久化 1 小時
setcookie('pref_theme', 'dark', time() + 3600, '/');
// 完整參數:跨子域名、僅 HTTPS、防 XSS
setcookie('user_token', $token, [
'expires' => time() + 86400 * 30,
'path' => '/',
'domain' => '.example.com', // 關鍵:前導點支援所有子域名
'secure' => true,
'httponly' => true,
'samesite' => 'Lax',
]);
?>
<?php
// 單個讀取
$lang = $_COOKIE['lang'] ?? 'en';
// 遍歷所有
foreach ($_COOKIE as $name => $value) {
echo htmlspecialchars("$name = $value") . "
";
}
// 調試輸出
print_r($_COOKIE);
?>
<?php
// 設置過期時間為過去
setcookie('user_token', '', time() - 3600, '/', '.example.com', true, true);
// 或 PHP 7.3+ 選項陣列
setcookie('user_token', '', [
'expires' => time() - 3600,
'path' => '/',
'domain' => '.example.com',
'secure' => true,
'httponly' => true,
]);
?>
關鍵:刪除時 path、domain、secure、httponly 必須與設置時**完全一致**,否則瀏覽器不會刪除。
<?php
setcookie('fruits[]', 'apple');
setcookie('fruits[]', 'banana');
setcookie('fruits[]', 'orange');
// 讀取時自動為陣列
print_r($_COOKIE['fruits']); // ['apple', 'banana', 'orange']
?>
<?php
// 主域名 example.com 設置
setcookie('ssid', $sessionId, [
'expires' => time() + 86400,
'path' => '/',
'domain' => '.example.com', // 關鍵:前導點
'secure' => true,
'httponly' => true,
'samesite' => 'None', // 跨站請求需攜帶,配合 Secure
]);
// 子域名 a.example.com、b.example.com 自動攜帶此 Cookie
?>
<script>
// 讀取
function getCookie(name) {
const match = document.cookie.match(new RegExp('(^| )' + name + '=([^;]+)'));
return match ? decodeURIComponent(match[2]) : null;
}
// 設置
function setCookie(name, value, days = 30) {
const exp = new Date(Date.now() + days * 864e5).toUTCString();
document.cookie = `${name}=${encodeURIComponent(value)};expires=${exp};path=/;SameSite=Lax`;
}
// 刪除
function deleteCookie(name) {
setCookie(name, '', -1);
}
// 使用
console.log(getCookie('lang'));
setCookie('theme', 'dark', 7);
</script>
.example.com 僅在需要跨子域時使用/api 僅在 API 路徑生效setcookie() 必須在**任何輸出前**調用(含 BOM、空白、echo)$_COOKIE 不會即時反映 setcookie() 設置,需下次請求生效example.com 但訪問 www.example.com)導致無效setcookie() 是 PHP 會話管理的基石。掌握 8 參數含義、跨域共享機制、安全屬性組合、JS 交互與避坑指南,能構建安全、可靠、符合現代瀏覽器策略的 Cookie 方案。現代項目推薦:HttpOnly+Secure+SameSite=Lax+最小權限域名路徑,敏感操作配合 CSRF Token 雙重防護。