設置 Cookie:setcookie("QQ_access_token", $token, time()+3600*24*90);
當前頁面可讀取 $_COOKIE['QQ_access_token'],但跳轉到其他目錄/頁面(如 /admin/、/api/)時 $_COOKIE 為空。瀏覽器開發者工具中看到 Cookie **Path** 顯示為當前目錄(如 /current/path/),而非全站根目錄 /。
setcookie() 第 4 參數 $path 默認為**當前腳本所在目錄**(不含文件名)。例如:
https://example.com/app/login.php 設置 Cookie → Path = /app/https://example.com/admin/dashboard.php → 瀏覽器**不發送**該 Cookie(路徑不匹配)<?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
]);
?>
/:匹配**所有路徑**(根路徑是所有路徑的前綴)。/admin/:匹配 /admin/、/admin/user、/admin/user/list,**不匹配** /api/、/。/ 結尾視為目錄邊界。<?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;
?>
var_dump($_COOKIE) 確認接收情況。curl -v -b cookies.txt -c cookies.txt URL 命令行調試 Cookie 交互。
Cookie 無法跨頁面傳遞,**99% 因 Path 設置為當前目錄而非根目錄 /**。永遠顯式設置 path => '/',並配合 secure、httponly、samesite 構建安全的 Cookie 策略。現代 PHP 7.3+ 推薦使用選項數組語法,可讀性與維護性更強。