PHP调试时如何仅打印Doctrine实体的一级属性？

1. 用Doctrine官方Debug工具（最省心） #

Doctrine自带专门的调试类，完全不会触发懒加载，还能指定打印层级：

use Doctrine\Common\Util\Debug;

// 第二个参数1表示仅打印一级属性，不会加载关联数据
Debug::dump($file, 1);

这个类会自动识别Doctrine的代理对象和关联属性，只输出实体本身的基础属性，彻底避免因懒加载导致的内存问题。

2. 自定义函数提取一级属性 #

如果不想依赖Doctrine工具，可自行编写简单函数，过滤掉关联代理对象：

function dumpEntityFirstLevel($entity) {
    $reflection = new ReflectionClass($entity);
    $properties = $reflection->getProperties();
    $data = [];
    
    foreach ($properties as $prop) {
        $prop->setAccessible(true);
        $value = $prop->getValue($entity);
        
        // 跳过Doctrine代理对象和持久化集合，不触发懒加载
        if (is_object($value) && (str_contains(get_class($value), 'Proxy') || str_contains(get_class($value), 'PersistentCollection'))) {
            $data[$prop->getName()] = '[Doctrine Proxy/Collection]';
        } else {
            $data[$prop->getName()] = $value;
        }
    }
    
    print_r($data);
}

// 调用示例
dumpEntityFirstLevel($file);

通过反射获取实体属性，过滤掉Doctrine生成的关联代理，只输出基础属性值，不会触发数据库查询。

3. Symfony环境下用VarDumper组件 #

若基于Symfony开发，自带的VarDumper组件已做优化，默认不会触发Doctrine懒加载，还能指定打印深度：

// 指定深度为1，仅打印一级属性
dump($file, 1);

VarDumper会自动识别Doctrine实体的关联关系，不会加载未初始化的关联数据，且输出格式比print_r更清晰友好。

为什么print_r/var_dump会出问题？ #

这两个函数会递归遍历对象的所有属性，包括Doctrine为关联关系生成的代理对象。当访问这些代理对象的属性时，Doctrine会自动执行数据库查询加载关联数据，层级较深时会瞬间加载大量数据，直接导致内存溢出。

内容的提问来源于stack exchange，提问作者Mathias Bader