| 函數 | 用途 | 備註 |
| session_start() | 初始化/恢復會話 | 每請求必須調用一次 |
| session_unset() | 釋放所有 $_SESSION 變量 | 不銷毀 Session ID |
| session_destroy() | 銷毀伺服器端會話數據 | 需配合 session_unset() 徹底清理 |
| session_write_close() | 寫入數據並結束會話鎖 | 長時間腳本建議提前調用釋放鎖 |
| session_commit() | session_write_close 別名 | 同上 |
| session_decode() | 解碼會話數據字串 | 調試/遷移用 |
| session_encode() | 編碼當前會話為字串 | 調試/備份用 |
| session_id() | 獲取/設定 Session ID | 跨域共享 Session 時用 |
| session_regenerate_id() | 生成新 Session ID (防固定攻擊) | 登入後必須調用 |
| session_name() | 獲取/設定 Session 名稱 (Cookie 名) | 預設 PHPSESSID |
❌ 禁用函數 (平台統一管理,用戶不可調用)
| 分類 | 函數 | 禁用原因 |
| 緩存限制器 | session_cache_expire | 平台統一配置緩存策略 |
| session_cache_limiter |
| session_get_cookie_params |
| session_set_cookie_params |
| 存儲路徑/處理器 | session_save_path | 平台統一管理 Memcache 連接 |
| session_set_save_handler |
| session_module_name |
| PHP 5.3+ 棄用 | session_is_registered | 語言層面已棄用/移除 |
| session_register |
| session_unregister |
使用指南與代碼範例
基本會話流程
<?php
// 1. 啟動會話 (每個請求最開頭)
session_start();
// 2. 讀寫數據
$_SESSION['user_id'] = 12345;
$_SESSION['username'] = 'alice';
$uid = $_SESSION['user_id'];
// 3. 關鍵操作後重新生成 ID (防 Session Fixation)
if (login_success) {
session_regenerate_id(true); // true = 刪除舊會話文件
}
// 4. 長時間運行腳本中釋放鎖
session_write_close();
// 繼續耗時操作...
// 如需繼續寫入 Session 需再次 session_start()
// 5. 登出銷毀
session_unset();
session_destroy();
// 可選:刪除客戶端 Cookie
setcookie(session_name(), '', time()-3600, '/');
?>
跨域/多子域共享 Session
<?php
// 所有子域共享:.example.com
session_set_cookie_params(0, '/', '.example.com', true, true); // 此函數被禁用!
// ACE 正確做法:平台層已配置 cookie_domain
// 僅需確保所有子域應用部署在同一 ACE 應用下,或共用同一 Memcache 叢集
// 若跨應用,需自行實現 SSO (單點登入) 或共享 Session ID 並手動同步數據
?>
遷移注意事項 (從本地/自建環境遷移至 ACE)
| 本地常用做法 | ACE 環境限制 | 遷移方案 |
| ini_set('session.save_path', ...) | session_save_path 禁用 | 移除相關代碼,平台自動配置 |
| session_set_save_handler($redis) | session_set_save_handler 禁用 | 改用平台 Memcache Session,或應用層手動讀寫 Redis |
| 自定 session.gc_maxlifetime | 平台統一配置 | 如需特殊 TTL,應用層自行管理「最後活動時間」字段 |
| 依賴 $_COOKIE['PHPSESSID'] 手動傳遞 | Cookie 參數平台統一 | 使用 session_id() 獲取/設定 ID,配合 Header 傳遞 |
性能與調優建議
- 減少 Session 體積:僅存儲必要標識 (user_id、權限位圖),大對象存資料庫/緩存,Session 存 Key
- 及時釋放鎖:異步任務、長輪詢、流式輸出場景務必
session_write_close()
- 監控命中率:通過雲監控觀察 Memcache Session 相關指標
- 安全加固:
session.cookie_httponly=1、session.cookie_secure=1 (HTTPS)、session.use_strict_mode=1 (平台預設開啟)
常見問題
- Session 丟失/不穩定:檢查是否多次
session_start()、是否過早輸出導致 Header 發送失敗、Memcache 節點是否抖動
- 並發請求阻塞:同一 Session 並發請求會串行 (鎖機制),使用
session_write_close() 釋放
| 跨應用 Session 不共享 | 不同 ACE 應用隔離 Memcache 命名空間,需自建 SSO 或共享資料庫 Token 方案 |
ACE Session 服務將會話狀態管理從「開發者負擔」轉為「平台能力」,開發者專注業務邏輯,平台保障高可用、共享一致、安全合規。
copyright ©
萬盛學電腦網 all rights reserved