如何使用session_get_cookie_params 獲取PHP 會話的cookie 配置

gitbox 2025-06-07

什麼是session_get_cookie_params() ？

session_get_cookie_params()是PHP 內置的Session 處理函數之一，它返回當前會話cookie 的所有參數，以數組的形式呈現。返回值包含以下鍵值對：

lifetime : cookie 的生命週期（以秒為單位）
path : cookie 有效的路徑
domain : cookie 所在的域名
secure : 是否只通過HTTPS 傳輸
httponly : 是否只能通過HTTP 協議訪問

這個函數通常與session_set_cookie_params()配合使用，在需要設置或獲取會話cookie 參數時非常方便。

示例代碼

以下是一個基本的使用示例：

<code> <?php // 啟動會話前獲取默認的cookie 設置$params = session_get_cookie_params();

echo "Lifetime: " . $params["lifetime"] . " ";
echo "Path: " . $params["path"] . " ";
echo "Domain: " . $params["domain"] . " ";
echo "Secure: " . ($params["secure"] ? "true" : "false") . " ";
echo "HttpOnly: " . ($params["httponly"] ? "true" : "false") . " ";
?>
</code>

執行結果將會顯示出當前PHP 會話cookie 的全部參數。

與session_set_cookie_params()配合使用

你可以先通過session_set_cookie_params()自定義設置參數，然後再通過session_get_cookie_params()來驗證是否設置成功：

<code> <?php // 自定義cookie 參數session_set_cookie_params([ 'lifetime' => 3600, 'path' => '/', 'domain' => 'gitbox.net', 'secure' => true, 'httponly' => true ]);

// 啟動會話
session_start();

// 獲取並顯示參數
$params = session_get_cookie_params();
print_r($params);
?>
</code>

在以上代碼中，我們自定義了一個會話cookie 設置，確保該cookie 只能通過HTTPS 傳輸、不能被JavaScript 訪問，並且限定在gitbox.net域名下生效。隨後我們通過session_get_cookie_params()輸出驗證配置是否正確。

使用場景

調試配置問題 開發過程中，你可能需要確認服務器的session 設置是否正確，例如在不同環境（開發、測試、生產）下進行排查
安全性審核 確保會話cookie 被標記為secure 和HttpOnly，是防止中間人攻擊和XSS 攻擊的基本要求
跨域應用優化 當你的網站使用多個子域時（如app.gitbox.net和api.gitbox.ne t ），你可以通過設置cookie的domain值來實現子域間共享session

注意事項

session_get_cookie_params()必須在調用session_start()之前或之後都可以使用，但其返回的是“設置”值，而非某個特定客戶端當前cookie 的狀態。
若需要兼容老版本PHP，建議在設置參數時避免使用數組形式，使用舊式參數傳遞方式。

session_get_cookie_params