將任意 PHP 對象(包括嵌套對象、實現 Traversable 的集合、資源類型)深度轉換為純關聯數組,是 API 序列化、日誌記錄、調試輸出的基礎需求。本文提供一個生產級 object_to_array() 函數,處理遞歸、循環引用檢測、資源類型降級、__debugInfo 魔術方法支援。
function object_to_array(mixed $obj, array &$seen = []): array {
// 1. 基礎類型直接返回
if (!is_object($obj) && !is_array($obj)) return (array)$obj;
// 2. 循環引用檢測(使用 spl_object_id PHP 7.2+)
if (is_object($obj)) {
$id = spl_object_id($obj);
if (isset($seen[$id])) return ['*RECURSION*' => get_class($obj)];
$seen[$id] = true;
}
// 3. 獲取屬性:優先 __debugInfo,其次 get_object_vars(含 protected/private)
$props = method_exists($obj, '__debugInfo') ? $obj->__debugInfo() : get_object_vars($obj);
// 4. 遞歸轉換每個屬性值
$result = [];
foreach ($props as $key => $val) {
$result[$key] = object_to_array($val, $seen);
}
// 5. 資源類型特殊處理
if (is_resource($obj)) {
return ['*RESOURCE*' => get_resource_type($obj)];
}
return $result;
}
class User {
public string $name = '張三';
protected int $id = 1;
private string $secret = 'pwd123';
public Address $addr;
public function __construct() { $this->addr = new Address('北京', '朝陽區'); }
public function __debugInfo() { return ['name' => $this->name, 'id' => $this->id]; } // 隱藏 secret
}
class Address {
public string $city; public string $district;
public function __construct(string $city, string $district) { $this->city=$city; $this->district=$district; }
}
$user = new User();
$user->self = $user; // 循環引用
print_r(object_to_array($user));
/*
Array(
[name] => 張三
[id] => 1
[addr] => Array(
[city] => 北京
[district] => 朝陽區
)
[self] => Array(
[*RECURSION*] => User
)
)
*/
| 特性 | (array)$obj 強制轉換 | json_decode(json_encode($obj), true) | 本函數 object_to_array |
|---|---|---|---|
| 私有/受保護屬性 | ✓ 可見(鍵名含 \0*\0 前綴) | ✗ 不可見 | ✓ 可見(get_object_vars) |
| 循環引用 | 無限遞歸崩潰 | 拋出異常 | ✓ 檢測標記 *RECURSION* |
| 資源類型 | 整數 ID | null | ✓ 類型名 *RESOURCE* |
__debugInfo 支援 | ✗ | ✓ | ✓ 優先使用 |
| 性能 | 最快 | 慢(雙重序列化) | 中等(遞歸+哈希查找) |
| 數組輸入 | 不變 | 遞歸轉換 | ✓ 遞歸處理嵌套數組 |
symfony/serializer:NormalizerInterface + ObjectNormalizer 內建循環檢測、分組、上下文、類型轉換器,支援 XML/JSON/YAML 多格式輸出。#[SerializedName]、#[Groups] 屬性,精確控制輸出字段,避免洩露敏感屬性。JsonSerializable + 生成器逐塊輸出,避免記憶體峰值。mixed、array|object 聯合類型提升靜態分析覆蓋率。「對象轉數組」是序列化鏈路的第一步,選擇手寫遞歸還是成熟序列化器,取決於項目規模、性能要求與維護成本預算。