Symfony+Doctrine如何将实体查询结果转为对象或JSON？

你的场景回顾 #

你已经通过以下Doctrine查询获取了当前用户的Contact实体集合：

$contacts = $this->getDoctrine()->getManager()
    ->getRepository(Contact::class)
    ->createQueryBuilder('c')
    ->select('c')
    ->where('c.author = :id')
    ->setParameter('id',$this->getUser()->getId())
    ->getQuery()->getResult();

你的Contact实体包含id、Name、mobile等属性，希望将结果转换成类似以下的数组或JSON格式：

[ 
    ['51','dfgds','sfg','gfsgfs','s','fg','fgs','1'], 
    ['54','dfg','gdf','gd','fgdf','dfgdg','fgdg','1'], 
    ['55','wer','','ewe','','','erwrewwer','1'], 
]

解决方案 #

方法1：直接使用Doctrine的getArrayResult()

这是最简便的方式，Doctrine可以直接返回数组格式的查询结果，不需要手动遍历实体：

$contactsArray = $this->getDoctrine()->getManager()
    ->getRepository(Contact::class)
    ->createQueryBuilder('c')
    ->select('c.id', 'c.Name', 'c.mobile', 'c.email', 'c.mobilesecond', 'c.work', 'c.position', 'c.author')
    ->where('c.author = :id')
    ->setParameter('id',$this->getUser()->getId())
    ->getQuery()->getArrayResult();

注意：如果只写select('c')，返回的数组会包含嵌套结构（每个元素是['c' => [...]]），所以建议明确指定需要的字段，这样返回的就是你想要的扁平数组结构。

方法2：手动遍历实体构建自定义数组

如果你需要更灵活地控制返回的字段或格式，可以手动遍历每个Contact实体，提取需要的属性：

$contactsArray = [];
foreach ($contacts as $contact) {
    $contactsArray[] = [
        $contact->getId(),
        $contact->getName(),
        $contact->getMobile(),
        $contact->getEmail(),
        $contact->getMobilesecond(),
        $contact->getWork(),
        $contact->getPosition(),
        $contact->getAuthor() ? $contact->getAuthor()->getId() : '', // 处理author可能为null的情况
    ];
}

这种方式的好处是你可以完全自定义每个元素的内容和顺序，比如忽略某些字段，或者对字段值做额外处理。

方法3：转换为JSON格式

如果最终需要JSON输出，有两种方式：

方式A：简单使用json_encode()

基于上面的数组结果，直接用json_encode()转换：

$contactsJson = json_encode($contactsArray);

如果你直接对getResult()返回的实体集合用json_encode()，会因为实体是对象而得到空JSON或报错，所以必须先转成数组。

方式B：使用Symfony Serializer组件（更专业）

如果你需要处理复杂的实体关系（比如包含关联对象），Symfony的Serializer组件是更好的选择：

1. 首先确保Serializer组件已安装（Symfony 4+默认已包含）
2. 在控制器中注入Serializer服务：

use Symfony\Component\Serializer\SerializerInterface;

// 控制器方法中
public function yourAction(SerializerInterface $serializer)
{
    $contacts = $this->getDoctrine()->getManager()
        ->getRepository(Contact::class)
        ->createQueryBuilder('c')
        ->where('c.author = :id')
        ->setParameter('id',$this->getUser()->getId())
        ->getQuery()->getResult();

    // 序列化实体为JSON，指定需要的字段
    $contactsJson = $serializer->serialize($contacts, 'json', [
        'attributes' => [
            'id',
            'Name',
            'mobile',
            'email',
            'mobilesecond',
            'work',
            'position',
            'author' => ['id'], // 只序列化author的id字段
        ],
    ]);
}

这种方式适合处理更复杂的实体结构，还能处理循环引用、日期格式化等问题。

内容的提问来源于stack exchange，提问作者Munkhdelger Tumenbayar