萬盛學電腦網

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

PHP Cookie 跨目錄/頁面無法傳遞?Path 屬性配置詳解

問題現象

設置 Cookie:setcookie("QQ_access_token", $token, time()+3600*24*90);
當前頁面可讀取 $_COOKIE['QQ_access_token'],但跳轉到其他目錄/頁面(如 /admin/、/api/)時 $_COOKIE 為空。瀏覽器開發者工具中看到 Cookie **Path** 顯示為當前目錄(如 /current/path/),而非全站根目錄 /。

根因:Path 屬性默認行為

setcookie() 第 4 參數 $path 默認為**當前腳本所在目錄**(不含文件名)。例如:

  • 在 https://example.com/app/login.php 設置 Cookie → Path = /app/
  • 訪問 https://example.com/admin/dashboard.php → 瀏覽器**不發送**該 Cookie(路徑不匹配)

解決方案:顯式設置 Path 為根目錄

<?php
// 正確:全站可用
setcookie("QQ_access_token", $token, time() + 3600*24*90, "/");

// 參數完整簽名
setcookie(
    string $name,
    string $value = "",
    int $expires_or_options = 0,
    string $path = "",
    string $domain = "",
    bool $secure = false,
    bool $httponly = false
);

// 現代寫法(PHP 7.3+):選項數組,更清晰
setcookie("QQ_access_token", $token, [
    'expires'  => time() + 3600*24*90,
    'path'     => '/',           // 關鍵:全站路徑
    'domain'   => '',            // 當前域名(含子域名需設置 '.example.com')
    'secure'   => true,          // 僅 HTTPS 傳輸(生產必開)
    'httponly' => true,          // 禁止 JS 訪問(防 XSS)
    'samesite' => 'Lax',         // CSRF 防護:Lax/Strict/None
]);
?>

Path 屬性匹配規則

  • /:匹配**所有路徑**(根路徑是所有路徑的前綴)。
  • /admin/:匹配 /admin/、/admin/user、/admin/user/list,**不匹配** /api/、/。
  • 路徑匹配為**前綴匹配**,且以 / 結尾視為目錄邊界。

Domain 屬性:跨子域名共享

<?php
// 主域名 example.com 下所有子域名共享
setcookie('token', $value, ['path' => '/', 'domain' => '.example.com', 'secure' => true, 'httponly' => true]);

// 僅當前精確域名(不含子域名)
setcookie('token', $value, ['path' => '/', 'domain' => 'api.example.com', ...]);

注意:domain 必須包含至少一個點(如 .example.com),不能設置為 TLD(如 .com、.cn)。

完整最佳實踐模板

<?php
function setAppCookie(string $name, string $value, int $days = 30, bool $secure = true): void {
    $options = [
        'expires'  => time() + 86400 * $days,
        'path'     => '/',
        'domain'   => '', // 或 '.yourdomain.com' 共享子域
        'secure'   => $secure,      // 生產環境強制 true
        'httponly' => true,         // 防 XSS
        'samesite' => 'Lax',        // 平衡安全與體驗
    ];
    setcookie($name, $value, $options);
}

function deleteAppCookie(string $name): void {
    setcookie($name, '', [
        'expires'  => time() - 3600,
        'path'     => '/',
        'domain'   => '',
        'secure'   => true,
        'httponly' => true,
        'samesite' => 'Lax',
    ]);
}

// 使用
setAppCookie('auth_token', $jwtToken, 30);
$token = $_COOKIE['auth_token'] ?? null;
?>

調試技巧

  1. 瀏覽器 DevTools → Application/Storage → Cookies:檢查 Path、Domain、Expires、Secure、HttpOnly、SameSite 欄位。
  2. PHP 端 var_dump($_COOKIE) 確認接收情況。
  3. 3. curl -v -b cookies.txt -c cookies.txt URL 命令行調試 Cookie 交互。

總結

Cookie 無法跨頁面傳遞,**99% 因 Path 設置為當前目錄而非根目錄 /**。永遠顯式設置 path => '/',並配合 secure、httponly、samesite 構建安全的 Cookie 策略。現代 PHP 7.3+ 推薦使用選項數組語法,可讀性與維護性更強。

copyright © 萬盛學電腦網 all rights reserved