Symfony/Component/VarDumper

HtmlDumper

CliDumper

cut

Stub

<?php

namespace App/Utility; // 放在你项目里合适的命名空间下

use Symfony/Component/VarDumper/Cloner/VarCloner;
use Symfony/Component/VarDumper/Cloner/Stub;
use Symfony/Component/VarDumper/Cloner/Data;
use Symfony/Component/VarDumper/Dumper/AbstractDumper;

/**
 * 将Symfony VarDumper的内部调试信息（Data对象）转换为PHP数组的自定义Dumper。
 * 这将把dump()所表示的变量结构，以程序可处理的数组形式呈现。
 */
class ArrayDumper extends AbstractDumper
{
    private array $dumpedArray = [];

    /**
     * @param Data $data VarDumper组件克隆后的数据对象
     */
    public function dump(Data $data): void
    {
        // AbstractDumper::dump() 内部会调用 doDump()，并传入一个内部的 stub 数组
        // Data 对象是这些内部 stub 的封装，所以我们直接处理 Data 对象
        $this->dumpedArray = $this->convertDataToArray($data);
    }

    /**
     * 核心转换逻辑：递归地将Data对象或Stub对象转换为数组。
     */
    private function convertDataToArray($value)
    {
        if ($value instanceof Data) {
            // Data对象实际上是其根Stub的包装
            return $this->convertDataToArray($value->getRawData()[0]);
        }

        if ($value instanceof Stub) {
            $stub = $value;
            $result = [
                '_type' => $stub->type, // 变量类型，如 string, array, object
            ];

            if (null !== $stub->class) {
                $result['_class'] = $stub->class; // 如果是对象，其类名
            }
            if ($stub->ref !== 0) {
                $result['_ref'] = $stub->ref; // 引用ID，用于处理循环引用
            }
            if ($stub->cut > 0) {
                $result['_cut'] = $stub->cut; // 如果数据被截断，显示截断数量
            }

            // 处理Stub的实际值
            if (is_scalar($stub->value) || null === $stub->value) {
                $result['value'] = $stub->value;
            } elseif (is_array($stub->value)) {
                // 内部数组（如对象属性的键值对）
                $convertedValue = [];
                foreach ($stub->value as $k => $v) {
                    $convertedValue[$k] = $this->convertDataToArray($v);
                }
                $result['value'] = $convertedValue;
            } else {
                // 其他情况，如资源类型，通常会转为字符串
                $result['value'] = (string) $stub->value;
            }

            // 处理子元素（如数组的元素，对象的属性）
            if ($stub->children) {
                $convertedChildren = [];
                foreach ($stub->children as $k => $v) {
                    $convertedChildren[$k] = $this->convertDataToArray($v);
                }
                $result['children'] = $convertedChildren;
            }

            return $result;
        } elseif (is_array($value)) {
            // 正常PHP数组，递归处理
            $convertedArray = [];
            foreach ($value as $k => $v) {
                $convertedArray[$k] = $this->convertDataToArray($v);
            }
            return $convertedArray;
        } else {
            // 标量类型或null，直接返回
            return $value;
        }
    }

    /**
     * 获取转换后的PHP数组。
     */
    public function getDumpedArray(): array
    {
        return $this->dumpedArray;
    }

    // AbstractDumper要求实现doDump，但我们的dump方法直接处理Data对象，
    // 所以这个方法在这里可以保持空，或者抛出异常，因为我们不通过其内部机制。
    protected function doDump(array $data)
    {
        // do nothing, we handle the Data object directly in dump()
        // Or, if you want to strictly follow AbstractDumper's flow:
        // $this->dumpedArray = $this->convertDataToArray(new Data($data));
        // This is a bit redundant if dump() already received a Data object.
    }
}

// 如何使用：
// $myVariable = [
//     'name' => 'Alice',
//     'age' => 30,
//     'details' => (object)['city' => 'New York', 'occupation' => 'Engineer'],
//     'friends' => [
//         ['name' => 'Bob'],
//         ['name' => 'Charlie']
//     ],
//     'null_value' => null,
//     'resource_example' => fopen('php://memory', 'r'), // 资源类型
// ];
//
// $cloner = new VarCloner();
// $clonedData = $cloner->cloneVar($myVariable);
//
// $arrayDumper = new ArrayDumper();
// $arrayDumper->dump($clonedData);
// $debugArray = $arrayDumper->getDumpedArray();
//
// // 现在 $debugArray 就是一个包含调试信息的PHP数组了
// // dump($debugArray); // 你可以用dump()来查看这个数组的结构
// // print_r($debugArray); // 或者直接print_r
// // var_export($debugArray, true); // 导出为可执行的PHP代码

_type

_class

value

children

json_encode()