萬盛學電腦網

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

PHP Cookie 完整指南:設定、讀取、跨頁傳值、安全屬性與常見坑點

Cookie 基本運作

Cookie 是伺服器透過 HTTP Response Header Set-Cookie 寫入瀏覽器的小型文字資料,瀏覽器後續請求同域名下自動攜帶 Cookie Header 送回伺服器。PHP 透過 setcookie() 寫入、$_COOKIE 陣列讀取。

setcookie() 完整簽名與參數

setcookie(
    string $name,
    string $value = "",
    int $expires_or_options = 0,
    string $path = "",
    string $domain = "",
    bool $secure = false,
    bool $httponly = true
): bool

PHP 7.3+ 支援選項陣列寫法 (推薦):

setcookie('auth_token', $token, [
    'expires'  => time() + 86400 * 30,  // 30 天
    'path'     => '/',
    'domain'   => '.example.com',       // 子域名共享
    'secure'   => true,                 // 僅 HTTPS 傳輸
    'httponly' => true,                 // JS 無法讀取 (防 XSS)
    'samesite' => 'Lax',                // CSRF 防護 (None/Lax/Strict)
]);

讀取 Cookie

<?php
// 直接存取超全域陣列 (已自動 URL 解碼)
$visitCount = $_COOKIE['visit_count'] ?? 0;
$authToken  = $_COOKIE['auth_token'] ?? null;

// 注意:$_COOKIE 只包含當前請求攜帶的 Cookie,剛 setcookie() 設定的**當下請求不會出現**,需下次請求才可讀取。

經典應用:記錄瀏覽次數

<?php
$count = isset($_COOKIE['visit_count']) ? (int)$_COOKIE['visit_count'] + 1 : 1;
setcookie('visit_count', $count, [
    'expires' => time() + 365 * 86400,
    'path'    => '/',
    'httponly' => true,
]);
echo "<b>歡迎第 {$count} 次造訪</b>";

跨頁傳值:Cookie vs Session vs Query String

必知的五大坑點

  1. Header 已送出無法設定 Cookie:setcookie() 必須在**任何輸出 (echo、空白行、HTML)** 之前呼叫。解決:輸出緩衝 ob_start() 或調整程式結構。
  2. 域名/路徑不匹配導致無法讀取:設定 domain=.example.com 共享子域名;path=/ 全站可用。
  3. 中文值儲存亂碼:Cookie 值需 urlencode() 儲存,讀取時 urldecode() (PHP 自動處理,但跨語言互通需注意)。
  4. 安全屬性缺失:生產環境**必須**設定 Secure (HTTPS)、HttpOnly (防 XSS)、SameSite=Lax/Strict (防 CSRF)。
  5. 用戶可竄改/刪除:Cookie 完全由客戶端控制,**絕不信任 Cookie 內容做授權決策**,需配合伺服器端 Session 驗證。

結語

Cookie 是 HTTP 無狀態協定下維持狀態的基石。掌握 setcookie() 完整參數、安全屬性配置、與 Session/Query String 的分工協作,能建立安全、易用的狀態管理機制。現代框架 (Laravel/Symfony) 皆封裝為 Cookie::queue()、$request->cookie(),建議直接使用框架封裝層。

copyright © 萬盛學電腦網 all rights reserved
方式儲存位置容量生命週期適用場景
Cookie客戶端4KB/域名可設定過期記住登入、偏好設定、追蹤識別
Session伺服器 (檔案/Redis/DB)無上限瀏覽器關閉/逾期銷毀購物車、權限驗證、敏感狀態
Query StringURL~2KB (URL 長度限制)單次請求分頁、搜尋條件、分享連結
Hidden Form Field表單 DOM無上限單次提交多步驟精靈表單