PDOStatement::fetchObject 中使用默認類與自定義類的差異

在使用PHP 進行數據庫操作時， PDOStatement類提供了多種提取查詢結果的方法，其中fetchObject()是一個非常方便的方式，可以直接將查詢結果映射成對象。本文將詳細探討在fetchObject()中使用與的區別、具體使用場景以及它們在性能上的差異。

什麼是fetchObject() ？

fetchObject()方法從結果集中獲取一行，並將其作為對象返回。默認情況下，它返回一個stdClass的實例，但也可以傳入自定義類名，使得查詢結果直接成為特定類型的對象。

基本使用方式如下：

 <?php
$pdo = new PDO('mysql:host=localhost;dbname=test', 'user', 'password');
$stmt = $pdo->query('SELECT id, name FROM users');

// 默認使用 stdClass
$user = $stmt->fetchObject();
echo $user->name;

// 使用自定義類
class User {
    public $id;
    public $name;

    public function greet() {
        return "Hello, " . $this->name;
    }
}

$stmt->execute(); // 重新執行查詢
$user = $stmt->fetchObject('User');
echo $user->greet();
?>

默認類（stdClass）vs 自定義類

1. 默認類（stdClass）

• 特點：PHP 內置的空對象。屬性動態添加，沒有任何方法。

• 優點：輕量、創建開銷極小、無需事先定義。

• 缺點：只能存儲數據，不能附加行為邏輯。

適合場景：

• 僅僅需要臨時讀取數據。

• 不需要對數據對象進行額外的業務操作。

• 簡單查詢結果的快速處理，比如展示列表或簡單API 返回。

示例：

 $user = $stmt->fetchObject();
echo $user->name; // 直接讀取屬性

如果要將這些數據快速打包成JSON：

 echo json_encode($user);

非常簡單直接，性能也最佳。

2. 自定義類

• 特點：可以定義自己的方法、魔術方法（如__construct 、 __get ）、屬性類型約束。

• 優點：對像不僅存儲數據，還能封裝邏輯，更符合OOP（面向對象編程）原則。

• 缺點：實例化時有一定開銷，尤其是複雜構造函數時。

適合場景：

• 需要將數據對象與業務邏輯綁定。

• 需要統一處理屬性（比如自動格式化日期、加密解密字段等）。

• 希望代碼更具可維護性、可測試性。

• 在大型項目中遵循MVC、DDD（領域驅動設計）模式。

示例：

 class Product {
    public $id;
    public $name;

    public function getDisplayName() {
        return strtoupper($this->name);
    }
}

$stmt = $pdo->query('SELECT id, name FROM products');
$product = $stmt->fetchObject('Product');
echo $product->getDisplayName();

這樣做不僅數據一目了然，還能增加後續擴展性。

性能差異分析

一般來說，當你需要處理幾千行以上的大數據集，而且對對象行為無特殊需求時，用stdClass 性能最佳。

而如果是一行一行處理業務邏輯，比如表單處理、領域對象建模、REST API 響應，自定義類更合適。

小提示：關於自定義類構造函數

如果你的自定義類有構造函數，並且構造函數有參數， fetchObject會遇到問題。因為fetchObject默認調用無參構造函數。如果需要傳參，可以使用第二個參數：

 $user = $stmt->fetchObject('User', ['param1', 'param2']);

不過需要注意：傳參時，PDO 會在屬性賦值前調用構造函數。

小結

• 默認類stdClass ：快速簡單，適合簡單數據讀取、性能優先的場景。

• 自定義類：擴展性強，適合結構化、行為豐富的場景，適用於中大型項目。

• 性能差異：stdClass 更快更省內存，但在小規模應用中，自定義類的性能差異通常可以忽略。

選擇哪種方式，取決於你的項目規模、業務複雜度、未來維護成本。
如果是輕量API，比如https://api.gitbox.net/user/list ，stdClass 可能已經足夠；
如果是大型業務系統，比如電商平台的訂單處理邏輯，使用自定義類更加合理！