中文(繁體)
中文(繁體)
在使用PHP 進行數據庫開發時， PDOStatement::fetchObject是一個非常實用的方法，可以將查詢結果直接映射為一個對象。不過在PHP 5 和PHP 7 中， fetchObject的行為有一些細微但重要的差異。如果不了解這些兼容性問題，可能會導致代碼在不同版本上出現不可預期的錯誤。
本文將深入講解這些差異，並給出實際代碼示例幫助理解。
PDOStatement::fetchObject的基本用法是從結果集中抓取一行作為一個對象：
<?php
$pdo = new PDO('mysql:host=localhost;dbname=test', 'root', '');
$stmt = $pdo->query('SELECT id, name FROM users');
$user = $stmt->fetchObject();
echo $user->id;
echo $user->name;
?>
默認返回的是一個stdClass對象。當然，你也可以指定一個自定義類名來接收數據。
PHP 5 ：在對象實例化後，屬性賦值之後調用構造函數（__construct）。
PHP 7 ：在對象實例化時，構造函數先被調用，然後才賦值屬性。
這導致了一個重要的問題：如果你的構造函數依賴某些字段初始化，它在PHP 5 和PHP 7 的行為可能完全不同。
假設有一個簡單的類：
<?php
class User {
public $id;
public $name;
public function __construct() {
echo "構造函數被調用：id = {$this->id}, name = {$this->name}\n";
}
}
$pdo = new PDO('mysql:host=localhost;dbname=test', 'root', '');
$stmt = $pdo->query('SELECT id, name FROM users LIMIT 1');
$user = $stmt->fetchObject('User');
?>
在PHP 5中，輸出可能是：
構造函數被調用：id = 1, name = John
在PHP 7中，輸出則可能是：
構造函數被調用：id = , name =
因為PHP 7 是在屬性賦值之前調用構造函數！
在PHP 5 和7 中， fetchObject方法的簽名略有不同：
fetchObject ([ string $class_name = "stdClass" [, array $ctor_args = array() ]] ) : object
PHP 5 ：支持$class_name和$ctor_args
PHP 7 ：也是支持$class_name和$ctor_args ，但是在PHP 7.2 以後，參數類型校驗更加嚴格，例如$ctor_args必須是數組。
如果你在PHP 7 中傳入非數組作為第二個參數，將直接觸發TypeError錯誤。
<?php
// 錯誤示範（PHP 7.2+ 會報錯）
$user = $stmt->fetchObject('User', '錯誤的ctor_args');
?>
正確的寫法應該是：
<?php
$user = $stmt->fetchObject('User', ['參數1', '參數2']);
?>
PHP 5 ：如果指定的$class_name不存在， fetchObject只是返回false 。
PHP 7 ：如果指定的$class_name不存在，直接拋出一個Error異常！
所以在PHP 7 中你必須確保$class_name已經正確加載，否則代碼會中斷。
安全的做法是：
<?php
$className = 'User';
if (class_exists($className)) {
$user = $stmt->fetchObject($className);
} else {
throw new Exception("類 {$className} 不存在");
}
?>
如果你在類構造函數里依賴數據庫字段，務必在PHP 7 中重新審視初始化邏輯，避免在構造函數中直接使用尚未賦值的屬性。
保證傳遞給$ctor_args的始終是數組，防止PHP 7.2 以後的類型錯誤。
在調用fetchObject前用class_exists檢查類是否存在，提高健壯性。
如果需要兼容PHP 5 和PHP 7，建議統一使用簡單的stdClass ，並手動賦值給需要的對象。
