Cookie 基本機制
Cookie 是伺服器透過 HTTP 回應標頭 Set-Cookie 送至瀏覽器的小型資料片段,瀏覽器後續請求會自動攜帶在 Cookie 請求標頭中。PHP 將接收到的 Cookie 自動解析為超全域陣列 $_COOKIE。
核心函數:setcookie() / setrawcookie()
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
]);
關鍵參數詳解
| 參數 | 說明 | 安全建議 |
expires | Unix 時間戳;0 或省略 = 會話期 Cookie(關閉瀏覽器失效) | 敏感資料勿設長期效期 |
path | 生效路徑,預設為當前腳本目錄 | 通常設 / 全站生效 |
domain | 生效域名,預設為當前主機;.example.com 含子域名 | 最小權限原則,避免 domain=.com |
secure | 僅 HTTPS 傳輸 | 生產環境必須 true |
httponly | 禁止 JavaScript 存取(document.cookie) | 防 XSS 必開 true |
samesite | 跨站請求攜帶策略 | Lax 平衡體驗與安全;關鍵操作用 Strict;跨域需 None+Secure |
讀取與多值 Cookie
// 讀取單值
$value = $_COOKIE['user_pref'] ?? 'default';
// 多值:名稱加 []
setcookie('fruits[]', 'apple');
setcookie('fruits[]', 'banana');
// $_COOKIE['fruits'] => ['apple', 'banana']
關鍵限制:輸出緩衝與標頭順序
setcookie() 必須在**任何輸出之前**呼叫(含空白字元、BOM、echo、HTML、var_dump)。否則觸發 Warning: Cannot modify header information - headers already sent。
解決方案:
- 腳本最頂端呼叫,前面零輸出
- 開啟
output_buffering = On(php.ini)或腳本開頭 ob_start()
- 使用框架的 Response 物件統一管理標頭
安全強化清單
- 簽名/加密敏感 Cookie:使用
hash_hmac() 或 openssl_encrypt(),防範竄改
- Session ID 必須 HttpOnly + Secure + SameSite
- 前綴機制:
__Host-(需 Secure、Path=/、無 Domain)、__Secure-(需 Secure)—— 瀏覽器強制驗證屬性
- 定期輪換:登入/權限變更時重新發放 Session ID
- 刪除 Cookie:
setcookie('name', '', time() - 3600, '/');(同名、同路徑、同域名、過期時間為過去)
常見陷阱
- 子域名共享:
domain=.example.com 可讓 a.example.com 讀取 b.example.com 設定的 Cookie,但需注意安全邊界
- 大小限制:單 Cookie ≤ 4KB,總數每域名約 50-180 個,超量會被瀏覽器忽略
- 編碼問題:值含特殊字元需
urlencode() / urldecode()(PHP 自動處理 $_COOKIE)
- P3P 政策:IE/舊版 Edge 第三方 Cookie 需 P3P 標頭,現代瀏覽器已棄用
現代替代方案
- Session 儲存於伺服器端(Redis/Memcached/Database),Cookie 僅存 Session ID
- JWT (JSON Web Token):無狀態認證,攜帶於 Authorization 標頭
- LocalStorage / IndexedDB:純客戶端儲存,不隨請求自動發送,適合大量非敏感資料
copyright ©
萬盛學電腦網 all rights reserved