萬盛學電腦網

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

PHP Cookie 完整操作指南:建立、讀取、刪除、跨域、安全屬性與最佳實踐

Cookie 與 Session 差異速覽

特性CookieSession
儲存端客戶端瀏覽器伺服器端
容量≤ 4KB / 條,~20-50/域名受限伺服器記憶體/儲存
傳輸每請求自動攜帶 (含靜態資源)僅 Session ID (Cookie/URL)
生命週期可設持久/會話伺服器 GC 控制
安全性可竄改/側錄/XSS 竊取資料不出伺服器,僅 ID 傳輸

核心 API:setcookie()

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,      // 僅 HTTPS 傳輸
    'httponly' => true,    // 阻擋 JS document.cookie 存取
    'samesite' => 'Lax'    // None/Strict/Lax,CSRF 防護
]);

實戰範例

建立 Cookie (1小時有效、全站可用、HTTPS+HttpOnly)

<?php
setcookie('username', 'nostop', [
    'expires' => time() + 3600,
    'path' => '/',
    'domain' => '.example.com', // 含子域名
    'secure' => true,
    'httponly' => true,
    'samesite' => 'Lax'
]);

讀取 Cookie

<?php
if (isset($_COOKIE['username'])) {
    echo "歡迎回來," . htmlspecialchars($_COOKIE['username']);
} else {
    echo "請登入";
}

刪除 Cookie (設定過去時間)

<?php
setcookie('username', '', [
    'expires' => time() - 3600,
    'path' => '/',
    'domain' => '.example.com',
    'secure' => true,
    'httponly' => true,
    'samesite' => 'Lax'
]);

關鍵屬性深度解析

屬性作用建議值
Secure僅 HTTPS 傳送生產環境 **必開**
HttpOnly禁止 JS 讀寫 (`document.cookie`)**必開**,防 XSS 竊取 Session ID
SameSite跨站請求是否攜帶 Cookie`Lax` (預設,平衡)、`Strict` (高安全)、`None` (跨域需配合 Secure)
DomainCookie 生效域名範圍`.example.com` 含子域;不設 = 當前主機
PathCookie 生效路徑前綴`/` 全站

常見坑點與解決

  • setcookie() 前有輸出:任何 `echo`、空白、BOM、HTML 皆會導致「Headers already sent」。解決:輸出緩衝 `ob_start()`、調整程式結構、確保 `setcookie` 在最頂端。
  • 當前頁無法讀取剛設定的 Cookie:`$_COOKIE` 反映**請求時**的 Cookie,**回應設定的 Cookie 需下一次請求才會出現**。
  • 子域名共享:主域 `.example.com` + `session.cookie_domain = ".example.com"` + 同一 `session.save_handler` (Redis)。
  • 中文值儲存:Cookie 標準僅支援 ASCII,中文請 `urlencode()` 寫入、`urldecode()` 讀取,或改用 Session/資料庫儲存結構化資料。

安全最佳實踐

  1. **敏感資料勿存 Cookie** (Token、權限、個資) → 存 Session/資料庫,Cookie 僅存加密 Session ID。
  2. **簽名/加密 Cookie 值** (如 Laravel `encrypt_cookie` 中介層) 防竄改。
  3. **定期輪換 Session ID** (`session_regenerate_id(true)` 登入/權限變更後)。
  4. **啟用 CSP** (`Content-Security-Policy`) 限制內聯腳本、外部資源,縮減 XSS 影響面。

總結

Cookie 是 HTTP 無狀態協定下的狀態載體。掌握 `setcookie()` 七參數/陣列寫法、屬性語意 (Secure/HttpOnly/SameSite)、讀寫時機差異,並嚴守「敏感資料不入 Cookie、輸出必編碼、HTTPS 全站」三原則,即能安全運用 Cookie 機制。

copyright © 萬盛學電腦網 all rights reserved