萬盛學電腦網

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

PHP Cookie 操作基礎實例:登入狀態管理

PHP Cookie 操作基礎實例:登入狀態管理

Cookie 是 HTTP 協議中客戶端儲存少量資料 (≤4KB) 的機制,常用於記住登入狀態、偏好設定、追蹤 ID。本文示範基本的設定、讀取、刪除流程,並強調安全屬性 (HttpOnly、Secure、SameSite) 的重要性。

基本流程三檔案

1. 登入表單 (login_form.php)

<!DOCTYPE html>
<html><head><meta charset="utf-8"><title>登入</title></head><body>
<h2>登入</h2>
<form method="post" action="login.php">
  <label>帳號: <input name="username" required></label><br><br>
  <button type="submit">送出</button>
</form>
</body></html>

2. 處理登入、設定 Cookie (login.php)

<?php
// 僅示範流程,實務必驗證密碼、防暴力破解、CSRF Token
$username = trim($_POST['username'] ?? '');

if ($username !== '') {
    // 設定 Cookie:名稱=user、值=帳號、過期 1 小時、全站路徑、僅 HTTPS、HttpOnly、SameSite=Lax
    setcookie('user', $username, [
        'expires' => time() + 3600,
        'path' => '/',
        'domain' => '', // 當前域名
        'secure' => true,      // 僅 HTTPS 傳送 (本地測試需改 false)
        'httponly' => true,    // JavaScript 無法讀取 document.cookie
        'samesite' => 'Lax',   // 防 CSRF
    ]);

    // 重導向到首頁
    header('Location: index.php');
    exit;
}

echo '請輸入帳號';
?>

3. 驗證 Cookie、顯示狀態 (index.php)

<?php
// 讀取 Cookie (自動填入 $_COOKIE 超全域陣列)
$user = $_COOKIE['user'] ?? null;

if ($user) {
    echo "

歡迎回來," . htmlspecialchars($user) . "!

"; echo '

登出

'; } else { echo '

您尚未登入

'; echo '

去登入

'; } ?>

4. 登出 (刪除 Cookie) - logout.php

<?php
// 刪除 Cookie:設定過期時間為過去
setcookie('user', '', [
    'expires' => time() - 3600,
    'path' => '/',
    'domain' => '',
    'secure' => true,
    'httponly' => true,
    'samesite' => 'Lax',
]);
header('Location: index.php');
exit;
?>

Cookie 關鍵屬性詳細說明

屬性說明安全建議
expires / max-age過期時間 (Unix 時間戳 / 秒數)。省略 = Session Cookie (關閉瀏覽器失效)敏感資料設短效期 (15-60 分鐘),配合伺服端 Session
pathCookie 生效路徑前綴通常設 `/` 全站共享
domainCookie 生效域名。省略 = 當前主機 (不含子域名)。設 `.example.com` 共享所有子域謹慎設定,避免洩露給無關子域
secure僅 HTTPS 連線傳送生產環境必須 true (需 HTTPS)
httponly禁止 JavaScript 存取 (`document.cookie`)必須 true 防 XSS 竊取 Session ID
samesite跨站請求攜帶策略:Strict / Lax / NoneLax 平衡安全與體驗;跨站 POST 需 None; Secure

常見坑點

  1. setcookie() 必須在任何輸出前呼叫 (含空白、BOM、HTML),否則 "Headers already sent" 警告且 Cookie 不生效。
  2. 域名匹配規則:`domain=.example.com` 允許 `a.example.com`、`b.example.com` 讀取;`domain=example.com` 僅限 `example.com` (不含子域)。
  3. 大小限制:單 Cookie ≤ 4KB,總數每域約 20-50 個。大量資料請用 Session (伺服端) + Cookie 只存 Session ID。
  4. 編碼:Cookie 值自動 URL 編碼/解碼,儲存中文無需手動 `urlencode`,但建議自行 `base64_encode` 或 `json_encode` 確保可攜性。
  5. 同站請求偽造 (CSRF):重要操作 (轉帳、刪除) 必須驗證 CSRF Token,不能只靠 Cookie。

現代最佳實踐:Session + Cookie 分工

  • Session (伺服端):儲存用戶 ID、權限、購物車、敏感狀態。PHP 原生 `$_SESSION` 預設檔案儲存,生產環境改用 Redis。
  • Cookie (客戶端):只儲存 Session ID (PHPSESSID) 與非敏感偏好 (語言、主題)。
  • JWT (無狀態):將用戶資訊簽名編碼在 Token 中,客戶端完整保存,伺服端無需儲存。適用微服務、跨域、行動 App。需注意撤銷機制 (黑名單/短效期+刷新令牌)。

完整登入流程圖 (Session 版)


[用戶提交帳密] → [PHP 驗證密碼] → [password_verify 通過]
    ↓
[session_regenerate_id(true)]  ← 防 Session Fixation
    ↓
[$_SESSION['user_id'] = $id; $_SESSION['roles'] = [...]]
    ↓
[setcookie('PHPSESSID', session_id(), [secure, httponly, samesite])]
    ↓
[重導向到會員中心]
copyright © 萬盛學電腦網 all rights reserved