萬盛學電腦網

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

PHP Session 完整教學:會話管理、儲存機制、安全配置與最佳實務

Session 是伺服器端維持用戶狀態的核心機制。PHP 內建 Session 處理器將資料序列化儲存(預設檔案系統),透過 Cookie 傳遞 Session ID。本文完整涵蓋啟動、讀寫、銷毀、安全配置、自定義儲存處理器與分散式擴展。

Session 基本運作流程

  1. session_start():啟動/恢復會話,發送 Set-Cookie: PHPSESSID=...
  2. 讀取/寫入 $_SESSION 超全域陣列
  3. 腳本結束時自動序列化儲存(或手動 session_write_close())
  4. 用戶瀏覽器攜帶 Session ID 進行後續請求

核心 API 操作

啟動會話(必須在輸出前)

<?php
// 建議在啟動前配置選項 (PHP 7.0+)
session_set_cookie_params([
    'lifetime' => 3600,      // 1 小時
    'path' => '/',
    'domain' => '.example.com',
    'secure' => true,        // 僅 HTTPS
    'httponly' => true,      // 防 XSS
    'samesite' => 'Lax',     // CSRF 保護
]);

session_start(); // 必須在任何輸出之前
?>

讀寫 Session 資料

<?php
session_start();

// 寫入
$_SESSION['user_id'] = 12345;
$_SESSION['username'] = 'john_doe';
$_SESSION['permissions'] = ['read', 'write'];
$_SESSION['cart'] = [
    ['product_id' => 1, 'qty' => 2],
    ['product_id' => 5, 'qty' => 1],
];

// 讀取
$userId = $_SESSION['user_id'] ?? null;
$cartCount = count($_SESSION['cart'] ?? []);

// 修改
$_SESSION['last_activity'] = time();

// 檢查是否登入
function isLoggedIn(): bool {
    return isset($_SESSION['user_id']);
}
?>

銷毀會話

<?php
session_start();

// 刪除特定變數
unset($_SESSION['cart']);

// 完全銷毀會話(登出流程)
$_SESSION = []; // 清空所有會話變數

// 刪除 Session Cookie
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 資料
session_destroy();

// 重新產生 Session ID (防 Session Fixation)
session_regenerate_id(true);
?>

Session 設定參數 (php.ini / ini_set)

參數預設值建議值說明
session.save_handlerfilesfiles/redis/memcached儲存處理器
session.save_path/tmp/var/lib/php/sessions儲存路徑(需寫入權限)
session.gc_maxlifetime1440 (24分)3600 (1小時) 或更長資料存活秒數,GC 機率清理
session.gc_probability11GC 機率分子
session.gc_divisor10001000GC 機率分母 (1/1000)
session.cookie_lifetime00 (瀏覽器關閉過期)Cookie 存活秒數,0=Session
session.cookie_httponlyOffOn防 JS 存取
session.cookie_secureOffOn (HTTPS 環境)僅 HTTPS 傳輸
session.cookie_samesite""LaxLax/Strict/None
session.use_strict_modeOffOn拒絕未初始化的 Session ID
session.sid_length3248+Session ID 長度
session.sid_bits_per_character45 或 6ID 字元編碼位數

安全強化配置

<?php
// bootstrap/app.php 或啟動檔案最頂端
ini_set('session.cookie_httponly', 1);
ini_set('session.cookie_secure', 1);       // 僅 HTTPS
ini_set('session.cookie_samesite', 'Lax');
ini_set('session.use_strict_mode', 1);
ini_set('session.sid_length', 48);
ini_set('session.sid_bits_per_character', 6);

// 自定義儲存路徑 (避免共享主機 /tmp 衝突)
ini_set('session.save_path', __DIR__ . '/../storage/sessions');

// 定期重新生成 ID (防 Session Hijacking)
if (!isset($_SESSION['last_regenerate']) || time() - $_SESSION['last_regenerate'] > 300) {
    session_regenerate_id(true);
    $_SESSION['last_regenerate'] = time();
}

session_start();
?>

自定義 Session 儲存處理器

資料庫儲存 (PDO 範例)

<?php
class PdoSessionHandler implements SessionHandlerInterface {
    private PDO $pdo;
    
    public function __construct(PDO $pdo) {
        $this->pdo = $pdo;
        // 建立資料表
        $this->pdo->exec("CREATE TABLE IF NOT EXISTS sessions (
            id VARCHAR(128) PRIMARY KEY,
            data TEXT NOT NULL,
            expiry INT UNSIGNED NOT NULL
        )");
    }
    
    public function open($path, $name): bool { return true; }
    public function close(): bool { return true; }
    
    public function read($id): string|false {
        $stmt = $this->pdo->prepare("SELECT data FROM sessions WHERE id = ? AND expiry > ?");
        $stmt->execute([$id, time()]);
        return $stmt->fetchColumn() ?: '';
    }
    
    public function write($id, $data): bool {
        $expiry = time() + ini_get('session.gc_maxlifetime');
        $stmt = $this->pdo->prepare("
            INSERT INTO sessions (id, data, expiry) VALUES (?, ?, ?)
            ON DUPLICATE KEY UPDATE data = VALUES(data), expiry = VALUES(expiry)
        ");
        return $stmt->execute([$id, $data, $expiry]);
    }
    
    public function destroy($id): bool {
        $stmt = $this->pdo->prepare("DELETE FROM sessions WHERE id = ?");
        return $stmt->execute([$id]);
    }
    
    public function gc($maxLifetime): int|false {
        $stmt = $this->pdo->prepare("DELETE FROM sessions WHERE expiry < ?");
        $stmt->execute([time()]);
        return $stmt->rowCount();
    }
}

// 註冊
$handler = new PdoSessionHandler($pdo);
session_set_save_handler($handler, true);
session_start();
?>

Redis 儲存 (高效能、分散式)

<?php
// php.ini 或 ini_set
ini_set('session.save_handler', 'redis');
ini_set('session.save_path', 'tcp://127.0.0.1:6379?auth=password&database=0&prefix=session:');

// 或程式碼註冊
$redis = new Redis();
$redis->connect('127.0.0.1', 6379);
$handler = new RedisSessionHandler($redis);
session_set_save_handler($handler, true);
session_start();
?>

閃存訊息模式

<?php
// 設定閃存 (僅下一次請求可見)
function flash(string $key, string $message): void {
    $_SESSION['_flash'][$key] = $message;
}

// 取得並清除閃存
function getFlash(string $key): ?string {
    $msg = $_SESSION['_flash'][$key] ?? null;
    unset($_SESSION['_flash'][$key]);
    return $msg;
}

// 使用範例
// process.php
flash('success', '資料已儲存');
header('Location: list.php');

// list.php
if ($msg = getFlash('success')) {
    echo '<div class="alert-success">' . h($msg) . '</div>';
}
?>

分散式系統 Session 共享策略

策略原理優點缺點
Sticky Session負載均衡器綁定 Session 到特定後端簡單、無程式碼變更單點故障、擴展受限
共享儲存 (Redis/DB)所有節點讀寫同一儲存高可用、水平擴展網路延遲、單點儲存風險
JWT Stateless狀態編碼在 Token,無伺服器儲存完全無狀態、極易擴展Token 體積大、撤銷困難、無法存大量資料
Session 複寫節點間同步 Session 資料本地讀取快複雜、一致性難保證
✅ 生產環境清單:
  • ✅ HTTPS + Secure + HttpOnly + SameSite=Lax
  • ✅ use_strict_mode=1 防 Session Fixation
  • ✅ 定期 session_regenerate_id(true)
  • ✅ 共享儲存 (Redis Cluster) 支援水平擴展
  • ✅ 監控 Session 數量、GC 效能
  • ✅ 敏感操作重新驗證 (Re-authentication)
copyright © 萬盛學電腦網 all rights reserved