萬盛學電腦網

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

PHP 跨域 Cookie 共享設定指南:SameSite 與 Domain 參數詳解

應用場景

主域名 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
?>

關鍵參數詳細說明

參數名稱說明跨域關鍵點
1nameCookie 名稱雙方一致
2valueCookie 值建議加密/簽名
3expire過期時間戳同步時間
4path生效路徑通常設 /
5domain生效域名★ 設為目標域名 b1.test.com 或父域 .test.com
6secure僅 HTTPS生產環境必為 true
7httponly禁止 JS 存取安全性必開

Domain 參數設定策略

設定值效果適用場景
b1.test.com僅 b1.test.com 可讀取指定單一子域共享
.test.comtest.com 及所有子域可讀取全站單點登入(SSO)
省略/空字串僅設定 Cookie 的當前主機名不跨域

重要限制與注意事項

  1. 同站限制:瀏覽器同源策略限制,只能設定當前域名或其父域名。a1.main.com 無法直接設定 b1.test.com 的 Cookie,除非透過重導向至 b1.test.com 由其自行設定。
  2. 實際架構建議:
    • 認證中心:auth.example.com
    • 應用 A:app1.example.com
    • 應用 B:app2.example.com
    • 設定 domain=.example.com,所有子域自動共享。
  3. 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
    ]);
  4. 測試驗證:必須使用完整域名訪問(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 → 已登入
copyright © 萬盛學電腦網 all rights reserved