萬盛學電腦網

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

PHP Session 完整入門教學:啟動、讀寫、銷毀、安全設定

什麼是 Session

Session(會話)是在伺服器端儲存使用者狀態資料的機制。瀏覽器端僅保存一個 session_id(通常透過 Cookie 傳遞),伺服器以此 ID 關聯儲存的資料。適用於登入狀態、購物車、權限控制等跨頁面資料共享。

核心函數速查表

函數用途備註
session_start()啟動/恢復會話必須在任何輸出前呼叫
$_SESSION超全域陣列,讀寫會話資料PHP 4.1+ 推薦寫法
session_destroy()銷毀伺服器端會話資料不會刪除瀏覽器 Cookie
session_unset()釋放所有 $_SESSION 變數配合 destroy 使用
session_regenerate_id()產生新 session_id(防 fixation)登入成功後必呼叫
session_id()取得/設定目前 session_id跨子域共享時用到
session_set_cookie_params()設定 Cookie 參數(有效期、路徑、域名、Secure、HttpOnly、SameSite)需在 session_start() 前呼叫

基本操作範例

<?php
// 1. 啟動會話(放在腳本最頂端,任何輸出之前)
session_start();

// 2. 寫入會話資料
$_SESSION['user_id'] = 123;
$_SESSION['username'] = 'john_doe';
$_SESSION['permissions'] = ['read', 'write'];

// 3. 讀取會話資料
echo "歡迎,{$_SESSION['username']} (ID: {$_SESSION['user_id']})";

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

// 5. 修改會話資料
$_SESSION['last_activity'] = time();

// 6. 刪除特定會話變數
unset($_SESSION['temp_data']);

// 7. 登出:清空並銷毀
function logout(): void {
    $_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_destroy();
}
?>

安全設定最佳實務(php.ini 或執行期設定)

<?php
// 必須在 session_start() 之前設定
ini_set('session.cookie_httponly', '1');     // 防止 JS 存取 Cookie (XSS 防護)
ini_set('session.cookie_secure', '1');       // 僅 HTTPS 傳送 (正式環境必開)
ini_set('session.cookie_samesite', 'Strict'); // CSRF 防護 (Lax/Strict)
ini_set('session.use_strict_mode', '1');     // 拒絕未初始化的 session_id
ini_set('session.gc_maxlifetime', '1800');   // 伺服器端資料保留 30 分鐘
ini_set('session.gc_probability', '1');
ini_set('session.gc_divisor', '100');        // 1% 機率觸發 GC

// 設定 Cookie 參數(路徑、域名、Secure、HttpOnly、SameSite)
session_set_cookie_params([
    'lifetime' => 1800,        // 30 分鐘無操作過期
    'path' => '/',
    'domain' => '.example.com', // 共享給子域 (可選)
    'secure' => true,          // 僅 HTTPS
    'httponly' => true,        // 防 XSS
    'samesite' => 'Strict',    // CSRF 防護
]);

session_start();
?>

Session 儲存處理器

  • files (預設):儲存為檔案,簡單但不適合多伺服器負載平衡
  • redis / memcached:分散式 Session,支援叢集
    ini_set('session.save_handler', 'redis');
    ini_set('session.save_path', 'tcp://127.0.0.1:6379');
  • database:實作 SessionHandlerInterface 自訂儲存到 MySQL/PostgreSQL

常見問題與解決

問題原因解決
Warning: session_start(): Cannot send session cookie - headers already sentsession_start() 前有輸出(空白、BOM、echo)確保 session_start() 在檔案最開頭,無任何輸出
Session 資料不見/隨機登出GC 過度清理、多伺服器未共享儲存、Cookie 參數錯誤調整 gc_maxlifetime、改用 Redis、檢查 cookie_domain/path
子域無法共享 SessionCookie domain 未設為 .example.comsession_set_cookie_params(['domain' => '.example.com'])
Session Fixation 攻擊攻擊者固定 session_id 誘導受害者使用登入後呼叫 session_regenerate_id(true)

進階:自訂 Session Handler (資料庫儲存)

<?php
class PdoSessionHandler implements SessionHandlerInterface
{
    private PDO $pdo;
    public function __construct(PDO $pdo) { $this->pdo = $pdo; }

    public function open($savePath, $sessionName): 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() + (int)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();
    }
}

// 註冊
$pdo = new PDO('mysql:host=localhost;dbname=test;charset=utf8mb4', 'user', 'pass');
$handler = new PdoSessionHandler($pdo);
session_set_save_handler($handler, true);
session_start();
?>

總結

Session 是 PHP 維持狀態的核心機制。掌握 session_start()、$_SESSION、session_destroy() 基本操作,並落實 HttpOnly、Secure、SameSite、Regenerate ID、分散式儲存 等安全設定,即可建立健全的會話管理系統。

copyright © 萬盛學電腦網 all rights reserved