萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

PHP 對象轉關聯數組:遞歸處理嵌套對象、資源類型、循環引用的完整實現

將任意 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*
資源類型整數 IDnull✓ 類型名 *RESOURCE*
__debugInfo 支援✗✓✓ 優先使用
性能最快慢(雙重序列化)中等(遞歸+哈希查找)
數組輸入不變遞歸轉換✓ 遞歸處理嵌套數組

生產級增強建議

  1. 引入 symfony/serializer:NormalizerInterface + ObjectNormalizer 內建循環檢測、分組、上下文、類型轉換器,支援 XML/JSON/YAML 多格式輸出。
  2. 數據傳輸對象 (DTO):定義專用 DTO 類,配合 #[SerializedName]、#[Groups] 屬性,精確控制輸出字段,避免洩露敏感屬性。
  3. 大對象流式序列化:超大對象圖使用 JsonSerializable + 生成器逐塊輸出,避免記憶體峰值。
  4. 類型提示:PHP 8.1+ 使用 mixed、array|object 聯合類型提升靜態分析覆蓋率。

「對象轉數組」是序列化鏈路的第一步,選擇手寫遞歸還是成熟序列化器,取決於項目規模、性能要求與維護成本預算。

copyright © 萬盛學電腦網 all rights reserved