萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

PHP Cookie 完整教學:建立、讀取、刪除、安全屬性與替代方案

Cookie 是 HTTP 協定維持狀態的機制,伺服器透過 Set-Cookie 標頭送至瀏覽器,瀏覽器後續請求自動攜帶。PHP 提供 setcookie() 設定、$_COOKIE 讀取。本文完整說明生命週期、安全屬性、常見陷阱與現代替代方案。

Cookie 基本運作流程

  1. 伺服器回應含 Set-Cookie: name=value; Expires=...; Path=/; Domain=...; Secure; HttpOnly; SameSite=Lax
  2. 瀏覽器儲存 Cookie(受同源策略、大小 4KB、數量限制)
  3. 後續同域請求自動附上 Cookie: name=value 標頭
  4. PHP 自動解析填入 $_COOKIE 超全域陣列

setcookie() 完整語法

<?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
]);
?>

建立 Cookie 範例

基本 Session Cookie(瀏覽器關閉失效)

<?php
// 必須在任何輸出之前呼叫!
setcookie('user', 'Alex Porter');
?>

持久 Cookie(指定過期時間)

<?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
?>

讀取 Cookie

<?php
// 讀取單一 Cookie
if (isset($_COOKIE['user'])) {
    echo "Welcome " . htmlspecialchars($_COOKIE['user']) . "!";
} else {
    echo "Welcome guest!";
}

// 除錯:檢視所有 Cookie
var_dump($_COOKIE);
?>

刪除 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 共享子域,謹慎設定

常見陷阱與解決方案

1. setcookie() 必須在輸出之前

<?php
// 錯誤:前面有空白/HTML 輸出
echo "Hello";
setcookie('test', 'value'); // Warning: Cannot modify header information

// 正確:輸出緩衝或調整順序
ob_start(); // 頁面最開頭
setcookie('test', 'value');
echo "Hello";
ob_end_flush();
?>

2. 同名 Cookie 覆蓋規則

  • 更精確的 Path 優先
  • 更精確的 Domain 優先
  • 同路徑/域名下,後設定者覆蓋

3. 陣列/物件儲存需序列化

<?php
$prefs = ['theme'=>'dark', 'lang'=>'zh-TW'];
setcookie('prefs', json_encode($prefs), time()+86400, '/', '', true, true);

// 讀取
$prefs = json_decode($_COOKIE['prefs'] ?? '{}', true);
?>

4. 子域共享 Cookie

<?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 vs Session vs LocalStorage

特性CookieSessionLocalStorage
儲存位置客戶端伺服器端(檔案/Redis/DB)客戶端
容量~4KB無實質限制~5-10MB
自動攜帶是(每請求)僅 Session ID否(需 JS 手動)
過期控制Expires/Max-Age伺服器控制 + gc_maxlifetime永久(手動清除)
JS 存取預設可(除 HttpOnly)不可可
主要用途追蹤、偏好、跨域認證用戶狀態、權限、購物車客戶端快取、離線資料

無 Cookie 環境替代方案

隱藏表單欄位傳遞狀態

<form action="welcome.php" method="post">
    <input type="hidden" name="user_id" value="<?= h($userId) ?>" />
    <input type="submit" value="繼續" />
</form>

URL 重寫(不推薦,SEO/安全差)

<a href="/profile/<?= $userId ?>?sid=<?= session_id() ?>">個人資料</a>
💡 現代建議: 敏感狀態(登入態、權限、購物車)使用 Session,Cookie 僅存放 session_id。非敏感偏好設定(主題、語言)可用 Cookie 或 LocalStorage。SameSite=Lax 是現代預設良好平衡。
copyright © 萬盛學電腦網 all rights reserved