應用場景
主域名 a1.main.com(應用 A)需與 b1.test.com(應用 B)共享 Cookie,實現單點登入或跨子域狀態同步。
核心設定:setcookie() 第 5 參數 domain
<?php
// 在 a1.main.com 的 main.php 中設定
setCookie(
'TestCookie', // Cookie 名稱
'okol', // Cookie 值
time() + 3600, // 過期時間(1小時後)
'/', // 路徑:整個域名下有效
'b1.test.com', // ★ 關鍵:指定目標域名,允許該域名讀取
true, // Secure:僅 HTTPS 傳輸(生產環境必開)
true // HttpOnly:防止 JS 存取,防 XSS
);
// 在 b1.test.com 的 test.php 中即可讀取
echo $_COOKIE['TestCookie']; // 輸出:okol
?>
關鍵參數詳細說明
| 參數 | 名稱 | 說明 | 跨域關鍵點 |
| 1 | name | Cookie 名稱 | 雙方一致 |
| 2 | value | Cookie 值 | 建議加密/簽名 |
| 3 | expire | 過期時間戳 | 同步時間 |
| 4 | path | 生效路徑 | 通常設 / |
| 5 | domain | 生效域名 | ★ 設為目標域名 b1.test.com 或父域 .test.com |
| 6 | secure | 僅 HTTPS | 生產環境必為 true |
| 7 | httponly | 禁止 JS 存取 | 安全性必開 |
Domain 參數設定策略
| 設定值 | 效果 | 適用場景 |
b1.test.com | 僅 b1.test.com 可讀取 | 指定單一子域共享 |
.test.com | test.com 及所有子域可讀取 | 全站單點登入(SSO) |
| 省略/空字串 | 僅設定 Cookie 的當前主機名 | 不跨域 |
重要限制與注意事項
- 同站限制:瀏覽器同源策略限制,只能設定當前域名或其父域名。
a1.main.com 無法直接設定 b1.test.com 的 Cookie,除非透過重導向至 b1.test.com 由其自行設定。
- 實際架構建議:
- 認證中心:
auth.example.com
- 應用 A:
app1.example.com
- 應用 B:
app2.example.com
- 設定
domain=.example.com,所有子域自動共享。
- SameSite 屬性(PHP 7.3+
setcookie() 第 8 參數或 options 陣列):
setcookie('name', 'value', [
'expires' => time() + 3600,
'path' => '/',
'domain' => '.example.com',
'secure' => true,
'httponly' => true,
'samesite' => 'None' // 跨站請求需攜帶 Cookie 必須設 None + Secure
]);
- 測試驗證:必須使用完整域名訪問(
https://b1.test.com/test.php),而非 localhost 或 IP,否則 Cookie 不會送出。
完整 SSO 實作流程圖
用戶訪問 app1.example.com
↓ (未登入)
重導向至 auth.example.com/login?redirect=app1.example.com/callback
↓ (登入成功)
auth 設定 Set-Cookie: session=xxx; Domain=.example.com; SameSite=None; Secure
↓
重導向回 app1.example.com/callback?token=xxx
↓
app1 驗證 token,建立本地會話
↓
用戶訪問 app2.example.com → 自動攜帶 .example.com Cookie → 已登入