萬盛學電腦網

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

PHP Cookie 完整操作指南:設定、讀取、刪除、路徑域名與安全屬性

Cookie 基本原理

Cookie 是伺服器透過 HTTP `Set-Cookie` 標頭送至瀏覽器,瀏覽器後續請求自動帶回 `Cookie` 標頭。屬於「狀態管理」機制,補足 HTTP 無狀態特性。

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,
    'httponly' => true,
    'samesite' => 'Lax'  // PHP 7.3+: None|Lax|Strict
]);

核心參數詳解

設定 Cookie 實戰範例

<?php
// 必須在任何輸出前呼叫!
// 1. 簡單 Session Cookie(瀏覽器關閉失效)
setcookie('lang', 'zh-TW');

// 2. 持久 Cookie(1 年)
setcookie('remember_token', $token, time() + 3600*24*365, '/', '', true, true);

// 3. 完整參數(子域名共用、僅 HTTPS、防 XSS)
setcookie('session_id', $sid, [
    'expires' => time() + 86400,
    'path' => '/',
    'domain' => '.example.com',  // 以 . 開頭包含所有子域名
    'secure' => true,
    'httponly' => true,
    'samesite' => 'Lax'
]);

// 4. 陣列式 Cookie(同名多值)
setcookie('fruits[]', 'apple');
setcookie('fruits[]', 'banana');
// $_COOKIE['fruits'] = ['apple', 'banana']

關鍵限制:輸出緩衝與時機

setcookie() 必須在任何 HTML/空白/echo 輸出之前呼叫,因為 Cookie 屬於 HTTP Header。
解決方案:
1. 程式碼最頂端設定 Cookie
2. 開啟 `output_buffering = On`(php.ini)
3. 使用 `ob_start()` 緩衝輸出

讀取 Cookie

<?php
// 自動解碼(urldecode)
echo $_COOKIE['lang'] ?? '未設定';           // 單值
echo $_COOKIE['fruits'][0] ?? '';            // 陣列值

// 也可用 $_REQUEST(不推薦,來源混雜)
// $lang = $_REQUEST['lang'];

刪除 Cookie

<?php
// 方法 1:設定過期時間為過去
setcookie('token', '', time() - 3600, '/');

// 方法 2:僅提供 name(舊語法)
setcookie('token');

// 注意:刪除後當前請求 $_COOKIE 仍有值,下一請求才消失

安全屬性最佳實踐

參數說明範例
nameCookie 名稱(必填)'user_id'
value儲存值(自動 urlencode)'john_doe'
expiresUnix 時間戳,0/省略=瀏覽器關閉失效(Session Cookie)time()+3600 (1小時)
path生效路徑,預設為設定腳本目錄'/' (全站)
domain生效域名,預設為當前主機(不含子域名)'.example.com' (含子域名)
secure僅 HTTPS 傳輸true
httponly禁止 JS 存取(防 XSS 竊取)true(強烈建議)
samesite跨站請求攜帶策略'Lax' (預設), 'Strict', 'None'
屬性建議值原因
HttpOnlytrue防止 XSS 竊取 Session ID
Securetrue (HTTPS 站點)防止中間人竊聽
SameSiteLax / Strict防禦 CSRF,Lax 允許導航連結攜帶
Domain最小必要範圍避免洩漏給無關子域名
Path最小必要路徑同理

SameSite 詳細說明

  • Strict:完全禁止跨站攜帶(連結點擊也不帶),安全性最高但可能影響體驗
  • Lax(預設):允許安全導航(GET 連結、表單 GET)攜帶,平衡安全與體驗
  • None:跨站攜帶,**必須搭配 Secure=true**,用於第三方嵌入場景

常見問題排查

  • Cookie 不生效 → 檢查 `headers_sent()`、輸出緩衝、路徑/域名設定、瀏覽器封鎖第三方 Cookie
  • 中文值亂碼 → PHP 自動 urlencode/urldecode,通常無問題;手動處理用 `rawurlencode`/`rawurldecode`
  • 子域名不共用 → 設定 `domain => '.example.com'`(前綴點號)
  • HTTPS 站點 Cookie 遺失 → 確認 `secure => true`
copyright © 萬盛學電腦網 all rights reserved