萬盛學電腦網

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

PHP Cookie 完整操作指南與實戰範例

Cookie 基本概念

Cookie 是儲存在瀏覽器端的小型文字檔,常用於記錄使用者偏好、登入狀態、購物車內容等。PHP 透過 setcookie() 寫入,$_COOKIE 超全域陣列讀取。

核心函式:setcookie()

setcookie(string $name, string $value, int $expire = 0, string $path = '', string $domain = '', bool $secure = false, bool $httponly = false);
  • expire:Unix 時間戳,0 表示瀏覽器關閉即失效
  • path:Cookie 生效路徑,通常設為 /
  • domain:跨子網域共享時設定
  • secure:僅 HTTPS 傳輸
  • httponly:防止 JavaScript 存取(防 XSS)

實用封裝函式

寫入 Cookie(含加密選項)

function writeCookie($name, $value, $expireDays = 30, $encrypt = true) {
    if ($encrypt) $value = encrypt($value, SECRET_KEY);
    $expire = $expireDays ? time() + 86400 * $expireDays : 0;
    setcookie($name, $value, $expire, '/', '', false, true);
}

讀取並解密

function readCookie($name, $decrypt = true) {
    if (!isset($_COOKIE[$name])) return null;
    $value = $_COOKIE[$name];
    return $decrypt ? decrypt($value, SECRET_KEY) : $value;
}

刪除 Cookie

function deleteCookie($name) {
    setcookie($name, '', time() - 3600, '/');
}

實戰範例

範例 1:記住使用者偏好主題

// 寫入
writeCookie('theme', 'dark', 90);

// 讀取套用
$theme = readCookie('theme') ?? 'light';
echo "<body class='theme-$theme'>";

範例 2:防止表單重複送出(CSRF 簡易版)

// 產生 Token
$token = bin2hex(random_bytes(16));
$_SESSION['csrf_token'] = $token;
writeCookie('csrf_token', $token, 0); // Session Cookie

// 驗證
if ($_SERVER['REQUEST_METHOD'] === 'POST') {
    if (!hash_equals($_SESSION['csrf_token'] ?? '', $_POST['csrf_token'] ?? '')) {
        die('無效的請求');
    }
    // 處理表單...
}

範例 3:多值 Cookie(陣列寫法)

// 寫入陣列
$prefs = ['lang' => 'zh-TW', 'currency' => 'TWD', 'timezone' => 'Asia/Taipei'];
foreach ($prefs as $k => $v) {
    writeCookie("pref[$k]", $v, 365);
}

// 讀取
$prefs = [];
foreach (['lang','currency','timezone'] as $k) {
    if (isset($_COOKIE["pref[$k]"])) $prefs[$k] = $_COOKIE["pref[$k]"];
}

安全性最佳實務

  1. 敏感資料務必加密儲存
  2. 啟用 httponly 與 secure 旗標
  3. 設定合理的 SameSite 屬性(PHP 7.3+ 支援)
  4. 定期清理過期 Cookie
  5. 避免在 Cookie 儲存大量資料(限制 4KB)

常見問題排查

  • Cookie 不生效?檢查 path、domain、輸出前是否已送出 Header
  • 跨子網域不共享?確認 domain=.example.com 格式
  • 中文亂碼?寫入前 urlencode(),讀取後 urldecode()
copyright © 萬盛學電腦網 all rights reserved