如何通過PDOStatement::fetchObject 避免對像數據的重複加載

gitbox 2025-05-12

在使用PDO 進行數據庫操作時， PDOStatement::fetchObject是一個非常方便的函數。它能夠直接將查詢結果封裝為對象返回，減少了手動賦值的麻煩。但如果使用不當，也可能帶來的問題，導致程序性能下降或者邏輯混亂。

本文將教你如何正確且高效地使用fetchObject ，避免加載重複的數據對象。

什麼是fetchObject ？

在PHP 中， PDOStatement::fetchObject方法可以把數據庫查詢結果的單行數據封裝成一個類的實例。示例代碼如下：

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

while ($user = $stmt->fetchObject()) {
    echo $user->id . ': ' . $user->name . '<br>';
}
?>

默認情況下， fetchObject會返回一個標準類（ stdClass ）對象，你也可以指定想要實例化的類名。

重複對象的問題來源

如果你的查詢結果裡存在重複的記錄，或者同一條數據在多次查詢中出現，而你每次都通過fetchObject直接實例化對象，那麼就會出現同一個數據，創建了多個不同的對象實例。

例如：

 $user1 = $stmt->fetchObject();
$user2 = $stmt->fetchObject();
// 即使 user1 和 user2 的 id 相同，它們也是不同的對象

這種重複實例化不僅浪費內存，還可能引發數據狀態不一致的問題，尤其是在大型項目或複雜數據關聯查詢中。

如何避免重複加載？

1. 使用對象緩存（對像池模式）

每次通過fetchObject生成一個對像後，先檢查是否已經存在相同ID 的對象。如果存在，就復用，不再重新創建。

示例：

 <?php
class User {
    public $id;
    public $name;
}

$pdo = new PDO('mysql:host=localhost;dbname=testdb', 'user', 'pass');
$stmt = $pdo->query('SELECT id, name FROM users');

$users = []; // 用來緩存已經加載的對象

while ($row = $stmt->fetch(PDO::FETCH_ASSOC)) {
    $id = $row['id'];
    if (!isset($users[$id])) {
        $user = new User();
        $user->id = $row['id'];
        $user->name = $row['name'];
        $users[$id] = $user;
    }
    // 如果已存在，則復用 $users[$id]
}

這種方式手動處理，可以保證同一條數據只實例化一次。

2. 自定義fetchObject行為

通過給fetchObject傳入自己的類，並在類的構造器裡實現ID 檢查，可以進一步自動化。

比如：

 <?php
class User {
    private static $instances = [];

    public $id;
    public $name;

    public function __construct() {
        // 禁止外部直接 new，使用 create 方法
    }

    public static function create($row) {
        if (isset(self::$instances[$row['id']])) {
            return self::$instances[$row['id']];
        }

        $obj = new self();
        $obj->id = $row['id'];
        $obj->name = $row['name'];
        self::$instances[$row['id']] = $obj;

        return $obj;
    }
}

$pdo = new PDO('mysql:host=localhost;dbname=testdb', 'user', 'pass');
$stmt = $pdo->query('SELECT id, name FROM users');

while ($row = $stmt->fetch(PDO::FETCH_ASSOC)) {
    $user = User::create($row);
}
?>

雖然fetchObject本身是為了懶人快速建對象而生，但在項目要求高性能、統一管理對像生命週期時，稍微控制一下是值得的。

3. 盡可能優化SQL 查詢，避免查詢到重複數據

有時候，重複數據的出現其實是因為SQL 查詢寫得不好。比如你在做JOIN 時沒有正確去重，就會導致同一條主記錄出現多次。

正確做法是在SQL 裡就用DISTINCT 、分組（ GROUP BY ）或者子查詢控制好返回的數據。

例如：

 SELECT DISTINCT users.id, users.name
FROM users
LEFT JOIN orders ON orders.user_id = users.id

這樣可以在數據源頭上就減少重複記錄的產生，根本性地解決問題。

小結

使用PDOStatement::fetchObject雖然方便，但要注意對象的唯一性問題。總結來說：

對於大型項目，建議配合對象緩存或者對像池模式。
對小項目，合理優化SQL 就能避免大部分重複加載問題。
如果需要更嚴格的對像管理，可以考慮手動封裝fetchObject過程。

如果你希望了解更多關於PDO 技巧，或者需要一套標準的PHP 數據訪問層封裝，推薦訪問https://gitbox.net/php-tutorials了解更詳細的案例與實踐。

PDOStatement::fetchObject