萬盛學電腦網

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

Yii2 多域名跨域同步登入登出:Session 作用域設定指南

問題情境

專案分前台(www.xxx.com)與後台(yun.xxx.com)綁定不同子域名。預設 Session 作用域僅限各自域名,導致跨子域名無法同步登入狀態。

解決方案:統一 Session Domain 為頂級域名

1. 定義頂級域名常數(common/config/main.php)

<?php
$host_array = explode('.', $_SERVER['HTTP_HOST']);

// 針對 .com 域名
if (count($host_array) == 3) {
    define('DOMAIN', $host_array[1] . '.' . $host_array[2]);
}
// 針對 .com.cn 等雙層後綴
elseif (count($host_array) == 4) {
    define('DOMAIN', $host_array[1] . '.' . $host_array[2] . '.' . $host_array[3]);
} else {
    // 本地開發環境可自行處理
}

define('DOMAIN_HOME', 'www.' . DOMAIN);
define('DOMAIN_YUN', 'yun.' . DOMAIN);
// 其它子域名常數...
?>

2. 調整 components 設定

<?php
return [
    'components' => [
        'user' => [
            'identityClass' => 'common\models\User',
            'enableAutoLogin' => true,
            'identityCookie' => [
                'name' => '_identity',
                'httpOnly' => true,
                'domain' => '.' . DOMAIN, // 關鍵:前綴點號表示所有子域名共享
            ],
        ],
        'session' => [
            'cookieParams' => [
                'domain' => '.' . DOMAIN,
                'lifetime' => 0,
            ],
            'timeout' => 3600,
        ],
    ],
];
?>

原理說明

  • Cookie Domain 設為 .xxx.com(前綴點號),瀏覽器會在所有子域名下送出該 Cookie。
  • identityCookie 控制自動登入 Token,session.cookieParams 控制 Session ID 傳遞,兩者皆需設定相同 Domain。
  • 同一代碼庫下,前後台共用 common/config/main.php,一次設定雙邊生效。

驗證方式

  1. 前台登入後,瀏覽器開發者工具查看 Cookie Domain 是否為 .xxx.com。
  2. 直接開啟後台網址,應自動保持登入狀態。
  3. 任一邊登出,另一邊同步失效。

常見坑點

  • 本地測試需修改 hosts 檔案映射真實域名(如 local.xxx.com),否則 Cookie Domain 不匹配。
  • 若使用 CDN 或反向代理,確認 $_SERVER['HTTP_HOST'] 取得正確值。
copyright © 萬盛學電腦網 all rights reserved