Session 是 PHP 開發中維持用戶狀態的核心機制,但初學者常因「headers already sent」、「存儲路徑錯誤」、「銷毀未初始化」等問題踩坑。本文彙總 10 大高頻 Session 問題,提供原因分析與最佳實踐解決方案。
Warning: Cannot send session cookie - headers already sent
Warning: Cannot send session cache limiter - headers already sent
session_start() 必須在任何實際輸出(包括 HTML、空白字符、echo/print)之前調用。哪怕是一個不經意的換行或空格,也會觸發此錯誤。
session_start() 放在腳本**第一行**,在任何輸出之前include/require 的文件,確保無 BOM 頭、無尾部空白行output_buffering(php.ini 設為 On)作為緩衝兜底Warning: open(F:/689phpsessiondatasess_xxx, O_RDWR) failed
在 php.ini 中正確設置保存路徑,並確保目錄存在且可寫:
session.save_path = "C:/tmp"
session.cookie_path = "C:/tmp"
然後手動建立 C:/tmp 目錄,賦予 PHP 進程讀寫權限。
Warning: Trying to destroy uninitialized session in
直接調用 session_destroy() 前必須先 session_start() 啟動會話。正確順序:
session_start();
// 清空 $_SESSION
$_SESSION = array();
// 刪除會話 Cookie
if (ini_get("session.use_cookies")) {
$params = session_get_cookie_params();
setcookie(session_name(), '', time() - 42000,
$params["path"], $params["domain"],
$params["secure"], $params["httponly"]
);
}
session_destroy();
最簡單方式:echo session_id(); 或常量 SID(僅在未發送 Cookie 時可用)。
即使代碼看似無輸出,檢查 ?> 閉合標籤後是否有空行/空格。**建議純 PHP 文件省略閉合標籤**,從根源杜絕此類問題。
session_start();
if (!isset($_SESSION['login']) || $_SESSION['login'] !== true) {
exit('您未登錄,請先登錄');
}
推薦封裝為 check_login() 函數,在需保護的頁面頂部引入。
header('Location: next.php') 或 JS 跳轉後,上一頁註冊的 Session 變量讀不到。
將 Session ID 通過 URL 參數傳遞:
header('Location: next.php?' . SID);
或確保 session.use_trans_sid = 1(需 PHP 編譯時啟用 --enable-trans-sid)。根因通常是 Cookie 域/路徑不匹配,檢查 session.cookie_domain、session.cookie_path 配置。
**先註冊後賦值**是舊版 session_register() 時代的做法。現代 PHP(≥ 4.1)直接操作 $_SESSION 超全局陣列:
$_SESSION['data'] = [1, 2, 3, 4];
推薦使用 $_SESSION,兼容性最好。$HTTP_SESSION_VARS 已棄用(PHP 5.4+ 移除)。
session_start();
$_SESSION['username'] = 'stangly';
echo $_SESSION['username']; // 推薦
// echo $HTTP_SESSION_VARS['username']; // 不推薦
| 函數 | 作用 | 注意事項 |
|---|---|---|
session_unregister('var') |
註銷單個 Session 變量 | 配合 unset($_SESSION['var']) 使用 |
session_destroy() |
銷毀整個會話環境 | 不清除 $_SESSION 陣列,需先 $_SESSION = [];不刪除客戶端 Cookie,需手動 setcookie(session_name(), '', time()-3600) |
完整登出範例:
if (isset($_COOKIE[session_name()])) {
session_start();
$_SESSION = array();
session_destroy();
setcookie(session_name(), '', time() - 3600, '/');
}
session_start()session.save_path 並確保目錄權限?> 閉合標籤$_SESSION 陣列操作session.save_handler = redis)