PHP 將物件儲存至 Session：序列化機制與最佳實務

PHP Session 原生支援儲存物件，引擎會自動在請求結束時 序列化 物件，下一請求 反序列化 還原。關鍵在於：類別定義必須在 session_start() 之前載入，否則會變成 __PHP_Incomplete_Class 無法存取屬性方法。

核心規則

1. 類別檔案需在 session_start() 前 require_once。
2. 物件屬性應為 public 或實作 __sleep/__wakeup 控制序列化行為。
3. 避免儲存資源型屬性（資料庫連線、檔案控制代碼、cURL handle），序列化會失敗。

完整範例

Person.php（類別定義）

<?php
// Person.php
class Person {
    public string $name;
    public string $email;

    public function __construct(string $name, string $email) {
        $this->name = $name;
        $this->email = $email;
    }

    public function cleanName(): string {
        return preg_replace('/\s+/', ' ', trim($this->name));
    }

    // 選擇性：控制序列化內容
    public function __sleep(): array {
        return ['name', 'email']; // 僅儲存這兩個屬性
    }
    public function __wakeup(): void {
        // 反序列化後初始化（如重新建立資料庫連線）
    }
}
?>

login.php（儲存物件）

<?php
require_once 'Person.php';
session_start();

if (!isset($_SESSION['user'])) {
    $_SESSION['user'] = new Person('Item Raja', 'itemraja@php.net');
}
header('Location: dashboard.php');

dashboard.php（讀取物件）

<?php
require_once 'Person.php'; // 必須在 session_start 前載入！
session_start();

$user = $_SESSION['user'] ?? null;
if ($user instanceof Person) {
    echo "歡迎, {$user->cleanName()} ({$user->email})";
} else {
    header('Location: login.php');
}
?>

進階：實作 Serializable 介面（PHP 5.1+）

class Person implements Serializable {
    // ...
    public function serialize(): string {
        return json_encode(['name' => $this->name, 'email' => $this->email]);
    }
    public function unserialize(string $data): void {
        $arr = json_decode($data, true);
        $this->name = $arr['name'];
        $this->email = $arr['email'];
    }
}

常見錯誤與解決

最佳實務建議

• 儲存 DTO/VO 物件：純資料物件，無業務邏輯、無資源依賴。
• 大型狀態改用 Redis/資料庫：Session 僅存識別碼。
• 版本演進：新增屬性預設值、實作 __wakeup 相容舊資料。

正確運用物件序列化，能讓 Session 攜帶豐富領域模型，簡化控制器邏輯。

1. 上一篇文章： PHP 純 Socket 實作 HTTP 請求（不依賴 cURL/擴展）
2. 下一篇文章： PHP 遞迴計算目錄總大小：RecursiveDirectoryIterator 實作

PHP 相關知識

PHP 遞歸實戰（一）：目錄遞歸遍歷與樹狀輸出

遞歸核心概念、兩要素（出口/遞歸點）與 scandir 實戰

PHP 循環結構深度解析：for/while/do-while/foreach 機制、性能對比與實戰模式

循環是程序控制流的核心。PHP 提供 for、while、d

PHP 命令行顏色輸出庫：跨平台 ANSI 色彩解決方案

前言 CLI 腳本若能輸出彩色日誌、錯誤高亮、進度條，可讀性

PHP GD 批量下載網頁所有圖片：正則提取、相對路徑解析、去重與異常處理

批量下載網頁圖片涉及HTML 解析、URL 規範化、去重、併