PHP Session 跨域問題終極解決方案及實用開源工具介紹

M66 2025-07-09

引言

在網站和應用開發中，跨域請求是常見的場景，但瀏覽器的同源策略導致PHP Session 在跨域時無法正常共享，進而引發登錄狀態失效等問題。本文將介紹一種基於開源工具easySession 的解決方案，通過結合JSON Web Token (JWT) 技術，實現跨域環境下的會話管理。

跨域與PHP Session 的挑戰

跨域指的是在一個域名下的網頁訪問另一個域名的資源。由於瀏覽器限制，Cookie 和Session 信息不能跨域傳遞，導致PHP 的Session 無法在不同域名間共享，從而影響用戶體驗和應用的正常運行。

解決方案介紹：easySession 與JWT

easySession 是一款專為PHP 會話管理設計的開源庫，利用JWT 技術實現跨域會話管理。 JWT 作為一種輕量級、無狀態的認證方案，能在跨域環境下安全地傳遞用戶會話信息。

安裝easySession

 composer require zaherg/easy-session

配置easySession

 use Zaherg\EasySession\SessionHandler;

$sessionHandler = new SessionHandler();
$sessionHandler->startSession();

設置跨域請求頭

header("Access-Control-Allow-Origin: http://example.com");
header("Access-Control-Allow-Credentials: true");
header("Access-Control-Allow-Headers: Content-Type");

基於JWT 的會話管理

服務端在用戶登錄驗證成功後生成JWT 並返回給前端，前端每次請求時在請求頭添加Authorization 字段，服務端通過解析JWT 獲取對應會話信息。

 // 服務端生成 JWT
use Firebase\JWT\JWT;

$key = "your_secret_key";
$payload = array(
    "user_id" => $user_id,
    // 可添加更多自定義數據
);

$jwt = JWT::encode($payload, $key);

// 前端請求時添加請求頭：Authorization: Bearer {JWT}

// 服務端解析 JWT
$jwt = $_SERVER['HTTP_AUTHORIZATION'];
$decoded = JWT::decode($jwt, $key, array('HS256'));
$user_id = $decoded->user_id;

安全性建議

為保證會話安全，建議在生成JWT 時設置有效期並使用安全的密鑰和簽名算法，例如HS256。這樣能有效防止JWT 被篡改和濫用。

總結

通過結合easySession 和JWT 技術，PHP 開發者可以有效解決Session 跨域問題，提升跨域應用的用戶體驗和安全性。本文提供的代碼示例和步驟，可幫助快速實現跨域會話管理，適用於多種PHP 跨域場景。