萬盛學電腦網

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

PHP Session 常用函數、配置與安全最佳實踐速查表

核心函數速查

函數用途範例備註
session_start()啟動/恢復會話session_start();必須在輸出前呼叫
session_destroy()銷毀伺服器端會話資料session_destroy();不刪除 $_SESSION 變數、不刪除 Cookie
session_unset()釋放所有 $_SESSION 變數session_unset();$_SESSION = [] 同效
session_regenerate_id()生成新 Session IDsession_regenerate_id(true);true=刪除舊檔案,登入後必呼叫
session_id()取得/設定當前 ID$id = session_id();啟動前呼叫可指定 ID
session_name()取得/設定 Cookie 名稱session_name('MYAPP');啟動前呼叫,預設 PHPSESSID
session_get_cookie_params()取得 Cookie 參數$p = session_get_cookie_params();陣列: lifetime, path, domain, secure, httponly, samesite
session_set_cookie_params()設定 Cookie 參數session_set_cookie_params(3600, '/', '.example.com', true, true);啟動前呼叫
session_save_path()取得/設定儲存路徑session_save_path('/var/lib/php/sessions');需目錄可寫、權限 1733
session_status()取得會話狀態session_status() === PHP_SESSION_ACTIVEPHP_SESSION_DISABLED/NONE/ACTIVE
session_write_close()寫入並關閉會話鎖session_write_close();長時間請求釋放鎖,允許並發
session_reset()重新載入會話資料 (捨棄未存變更)session_reset();PHP 5.6+
session_encode()序列化會話資料$data = session_encode();內部格式,非標準 serialize
session_decode()反序列化會話資料session_decode($data);填入 $_SESSION

php.ini 關鍵配置 (生產環境建議值)

; === 基礎 ===
session.save_handler = redis                 ; 檔案改用 Redis (生產必備)
session.save_path = "tcp://redis:6379?prefix=sess:"
session.name = MYAPPSESSID                   ; 自訂 Cookie 名稱,隱藏 PHP 特徵

; === 安全 (最高優先級) ===
session.cookie_httponly = 1                  ; 防 XSS 竊取 (JS 不可讀)
session.cookie_secure = 1                    ; 僅 HTTPS 傳輸 (需全站 HTTPS)
session.cookie_samesite = "Lax"              ; 防 CSRF (Strict 可能影響外部連結登入)
session.use_strict_mode = 1                  ; 拒絕未初始化 ID,防固定攻擊
session.sid_length = 48                      ; ID 長度 48 字元 (更難暴力)
session.sid_bits_per_character = 5           ; 每字元 5 bits,更緊湊

; === 生命週期 ===
session.gc_maxlifetime = 7200                ; 2 小時 (視業務調整)
session.gc_probability = 1
session.gc_divisor = 1000                    ; 0.1% 機率觸發 GC
session.cookie_lifetime = 0                  ; 0 = 瀏覽器關閉失效,或設定秒數

; === 進階 ===
session.serialize_handler = igbinary         ; 需安裝 igbinary,序列化更快更小
session.cache_limiter = nocache              ; 防止頁面被快取
session.use_cookies = 1
session.use_only_cookies = 1                 ; 僅用 Cookie 傳遞 ID,禁用 URL 傳遞 (防注入)
session.referer_check = ""                   ; 可限制來源域名 (嚴格場景)

安全最佳實踐清單

1. 防 Session Fixation (會話固定)

<?php
// 登入驗證成功後
if ($user = authenticate($username, $password)) {
    // 1. 重新生成 ID (刪除舊資料)
    session_regenerate_id(true);
    
    // 2. 寫入新會話資料
    $_SESSION['user_id'] = $user->id;
    $_SESSION['role'] = $user->role;
    $_SESSION['last_activity'] = time();
    
    // 3. (可選) 綁定用戶代理指紋
    $_SESSION['ua_hash'] = hash('sha256', $_SERVER['HTTP_USER_AGENT'] ?? '');
    
    // 4. 導向安全區域
    header('Location: /dashboard');
    exit;
}

2. 防 Session Hijacking (會話劫持)

<?php
// 每請求驗證 (中介軟體/基礎控制器)
function validateSession() {
    if (session_status() !== PHP_SESSION_ACTIVE) session_start();
    
    // 檢查 User-Agent 一致性 (可選,行動裝置可能變動)
    if (isset($_SESSION['ua_hash'])) {
        $current = hash('sha256', $_SERVER['HTTP_USER_AGENT'] ?? '');
        if (!hash_equals($_SESSION['ua_hash'], $current)) {
            destroySession();
            throw new SecurityException('Session UA mismatch');
        }
    }
    
    // 檢查 IP 前綱一致性 (可選,/24 網段)
    if (isset($_SESSION['ip_prefix'])) {
        $current = implode('.', array_slice(explode('.', $_SERVER['REMOTE_ADDR']), 0, 3));
        if ($_SESSION['ip_prefix'] !== $current) {
            // 僅記錄告警,不強制登出 (行動網路常換 IP)
            error_log("Session IP change: {$_SESSION['ip_prefix']} -> $current");
        }
    }
    
    // 更新最後活動時間
    $_SESSION['last_activity'] = time();
}

function destroySession() {
    $_SESSION = [];
    if (ini_get('session.use_cookies')) {
        $params = session_get_cookie_params();
        setcookie(session_name(), '', time() - 42000, $params['path'], $params['domain'], $params['secure'], $params['httponly']);
    }
    session_destroy();
}

3. 閒置超時自動登出

<?php
// 配合 gc_maxlifetime,但伺服器 GC 不精確,需應用層控制
$idle_timeout = 1800; // 30 分鐘無操作登出

if (isset($_SESSION['last_activity'])) {
    $idle = time() - $_SESSION['last_activity'];
    if ($idle > $idle_timeout) {
        destroySession();
        header('Location: /login?timeout=1');
        exit;
    }
}
$_SESSION['last_activity'] = time();

4. 並發請求阻塞問題 (Session Lock)

<?php
// 問題:同一 Session 並發請求會串列執行 (檔案鎖/Redis 鎖)
// 解決:提前釋放鎖

session_start();
// 讀取必要資料
$userId = $_SESSION['user_id'];
$perms = $_SESSION['permissions'];

// 釋放鎖,允許其他請求並行
session_write_close();

// 耗時操作:API 呼叫、大量查詢、檔案處理...
$report = generateHeavyReport($userId);

// 如需再寫入 Session,需重新啟動
session_start();
$_SESSION['last_report'] = $report['id'];
// 請求結束自動寫入

儲存驅動選擇指南

驅動適用場景優點缺點配置複雜度
files (預設)單機、低流量、開發環境零配置多機不共享、鎖爭用、inode 耗盡低
redis生產環境、叢集、高併發高效能、共享、支援 TTL 原生過期、無鎖/樂觀鎖需 Redis 服務、網路延遲中
memcached簡單快取、不需持久化極快、簡單資料可能被驅逐、無備份、無原生掃描中
database (PDO)需持久化、審計、無 RedisACID、可查詢、備份容易較慢、需手動 GC、連線池壓力高
custom (Swoole/Table)Swoole 協程環境記憶體級速度、無鎖進程重啟丟失、需持久化備份高

常見問題快速排查

session_start() 警告 "headers already sent"
檢查:1) 檔案開頭無 BOM 2) 無 `echo`/`print`/HTML/空白在 `session_start()` 前 3) `ob_start()` 開啟輸出緩衝
Session 變數跨頁面消失
1) 確認每頁都 `session_start()` 2) `session.cookie_domain` 設定正確 (跨子域) 3) `session.save_path` 目錄權限 4) GC 過於激進 5) 多伺服器未共享儲存
無法登入 / 登入後立即登出
1) Cookie 被瀏覽器封鎖 (第三方 Cookie、Secure/Httponly 設定錯誤) 2) 時區差異導致過期判斷錯誤 3) `session_regenerate_id` 未傳 `true` 導致舊檔案殘留
雙系統整合共享 Session
同一儲存後端 (Redis) + 相同 `session.name` + 相同 `session.save_path` prefix + 同步 `session.serialize_handler`

現代框架封裝參考 (Laravel / Symfony / Yii)

<?php
// Laravel: config/session.php 驅動設定,自動處理加密、閃存、CSRF
// 使用:session('key'), session(['key' => 'val']), $request->session()->put()
// 閃存:session()->flash('status', '已儲存!')

// Symfony: session service, framework.yaml 設定 handler
// 使用:$request->getSession()->set('key', 'val')

// 原生 PHP 簡易封裝類
class Session {
    public static function start(array $options = []) {
        foreach ($options as $k => $v) ini_set("session.$k", $v);
        if (session_status() === PHP_SESSION_NONE) session_start();
    }
    public static function get($key, $default = null) { return $_SESSION[$key] ?? $default; }
    public static function put($key, $value) { $_SESSION[$key] = $value; }
    public static function forget($key) { unset($_SESSION[$key]); }
    public static function flush() { $_SESSION = []; }
    public static function regenerate($deleteOld = true) { session_regenerate_id($deleteOld); }
    public static function destroy() { self::flush(); session_destroy(); }
}

總結

Session 是 PHP 有狀態應用的基石。關鍵原則:

  1. 安全第一:HTTPS + HttpOnly + SameSite + Strict Mode + 登入後 Regenerate ID
  2. 生產上 Redis:解決共享、鎖、效能、GC 三大痛點
  3. 資料極小化:只存身分證明,業務資料走快取/資料庫
  4. 應用層控制閒置:不依賴不可預測的 GC
  5. 並發釋放鎖:長請求 `session_write_close()`
copyright © 萬盛學電腦網 all rights reserved