Cookie 是伺服器透過 HTTP `Set-Cookie` 標頭送至瀏覽器,瀏覽器後續請求自動帶回 `Cookie` 標頭。屬於「狀態管理」機制,補足 HTTP 無狀態特性。
bool setcookie(
string $name,
string $value = "",
int $expires_or_options = 0,
string $path = "",
string $domain = "",
bool $secure = false,
bool $httponly = false
)
// PHP 7.3+ 陣列選項寫法(推薦)
setcookie('name', 'value', [
'expires' => time() + 3600,
'path' => '/',
'domain' => 'example.com',
'secure' => true,
'httponly' => true,
'samesite' => 'Lax' // PHP 7.3+: None|Lax|Strict
]);
| 參數 | 說明 | 範例 |
|---|---|---|
name | Cookie 名稱(必填) | 'user_id' |
value | 儲存值(自動 urlencode) | 'john_doe' |
expires | Unix 時間戳,0/省略=瀏覽器關閉失效(Session Cookie) | time()+3600 (1小時) |
path | 生效路徑,預設為設定腳本目錄 | '/' (全站) |
domain | 生效域名,預設為當前主機(不含子域名) | '.example.com' (含子域名) |
secure | 僅 HTTPS 傳輸 | true |
httponly | 禁止 JS 存取(防 XSS 竊取) | true(強烈建議) |
samesite | 跨站請求攜帶策略 | 'Lax' (預設), 'Strict', 'None' |
| 屬性 | 建議值 | 原因 |
|---|---|---|
| HttpOnly | true | 防止 XSS 竊取 Session ID |
| Secure | true (HTTPS 站點) | 防止中間人竊聽 |
| SameSite | Lax / Strict | 防禦 CSRF,Lax 允許導航連結攜帶 |
| Domain | 最小必要範圍 | 避免洩漏給無關子域名 |
| Path | 最小必要路徑 | 同理 |
Strict:完全禁止跨站攜帶(連結點擊也不帶),安全性最高但可能影響體驗Lax(預設):允許安全導航(GET 連結、表單 GET)攜帶,平衡安全與體驗None:跨站攜帶,**必須搭配 Secure=true**,用於第三方嵌入場景