在 Symfony 框架下，Doctrine 查询结果转成数组是一项常见需求，特别是在需要将数据以扁平结构传递给前端或进行自定义序列化时。本文围绕 如何在 Symfony 项目中把 Doctrine 查询结果转成数组？实战技巧全解，通过具体示例展示两大主路：直接使用数组化结果的 API 与通过 hydration 模式实现的方式，配合常见场景的代码片段，帮助你在实际项目中高效落地。
无论你是在构建 API 还是在处理报表导出，数组化查询结果都能避免实体对象带来的额外开销，提升序列化和前端渲染的速度。下面从基础方法到进阶场景，逐步讲解实战要点。
1. 关键方法概览：两条主路把查询结果变成数组
第一条路是直接以 数组化结果 的方式获取，第二条路则通过 hydration 设置将结果以数组结构返回。两种方式各有场景适用性，掌握后在 Symfony 项目中可以灵活切换。
直接获取数组的方式通常通过 Query 的 getArrayResult() 实现，结果是一个包含字段名为键的数组集合，适合扁平化数据传输；而通过 HYDRATE_ARRAY 的 hydration 模式也能达到同样的效果，且可结合自定义查询进行灵活控制。
1.1 使用 getArrayResult()
使用 getArrayResult() 可以把查询结果直接转为数组，字段名称以别名或查询中选择的字段名为键。这是最直观、最常用的数组化方法，尤其当只需要部分字段且不需要实体关联对象时。
下面的示例演示了如何通过 QueryBuilder 直接得到一个简单的字段数组：选择 id 与 name，返回的数组结构清晰易用。
// Symfony 控制器或服务中的用法
$qb = $this->getDoctrine()->getRepository(User::class)>createQueryBuilder('u')->select('u.id AS id, u.name AS name')->where('u.active = :active')->setParameter('active', true);$result = $qb->getQuery()->getArrayResult();
// 结果示例：
// [ {'id': 1, 'name': 'Alice'}, {'id': 2, 'name': 'Bob'}, ... ]
注意点：若未显式给字段设别名，返回的数组键可能是字段名或数字索引，建议统一使用别名以获得稳定的键名。
在生产环境中，要控制查询字段的粒度，避免把实体对象的大小字段或敏感信息一同拉取，确保返回的数据结构符合前端需求。
1.2 使用 HYDRATE_ARRAY 的方式
另一种常用方式是将查询的 hydration 模式设置为 HYDRATE_ARRAY，这会让 Doctrine 将结果以数组结构返回，常用于与原生查询或复杂联结场景结合。
示例中通过设置 hydration 模式来获取数组结果：
$qb = $this->getDoctrine()->getRepository(User::class)->createQueryBuilder('u')->select('u.id AS id, u.email AS email');
$query = $qb->getQuery();// 直接指定 hydration 模式为数组
$rows = $query->getResult(\Doctrine\\ORM\\Query::HYDRATE_ARRAY);
// 或等价写法：$rows = $query->getArrayResult();
优点：HYDRATE_ARRAY 对象映射的开销更低，适合大数据量的扁平化传输任务；缺点：如果需要对结果进行关联对象的深度遍历或复杂聚合，直接数组化后再处理会稍显不便。
2. 实战场景：在 Symfony 项目中应用数组化查询结果
在实际业务中，往往需要在保持高性能的同时兼顾数据结构的可用性。下面通过具体场景演示如何在 Symfony 项目中把 Doctrine 查询结果转成数组，以满足 API 返回、表格导出等需求。
场景一：仅需要单表字段的扁平数组，适合简单列表或下拉项等场景，减少序列化成本。
2.1 场景一的字段选择与数组化
通过明确的字段别名，可以获得稳定的数组结构，便于前端直接使用。
$qb = $em->createQueryBuilder()->select('u.id AS id', 'u.name AS name', 'u.email AS email')->from(User::class, 'u')->where('u.active = :active')->setParameter('active', true);$rows = $qb->getQuery()->getArrayResult();
// 结果示例：
// [ ['id' => 1, 'name' => 'Alice', 'email' => 'alice@example.com'], ... ]
场景二：如果需要 NATURAL 的键名，确保别名与字段同名，就能让前端直接按 key 取值，避免额外的映射步骤。
另外，在需要对字段进行分组或聚合时，建议在 SELECT 子句中明确别名，以确保最终的数组结构清晰易用。
2.2 关联查询返回嵌套数组的处理
当查询涉及关联对象时，简单的 getArrayResult() 会返回嵌套结构，或需要手动提取。此处给出一个常见做法：只选择需要的字段并为关联对象打上别名，获得可预期的嵌套数组结构。
$qb = $em->createQueryBuilder()->select('u.id AS id', 'u.name AS name', 'd.name AS dept')->from(User::class, 'u')->leftJoin('u.department', 'd')->where('u.active = :active')->setParameter('active', true);$rows = $qb->getQuery()->getArrayResult();
// 结果示例：
// [
// ['id' => 1, 'name' => 'Alice', 'dept' => 'Sales'],
// ['id' => 2, 'name' => 'Bob', 'dept' => 'Engineering'],
// ...
// ]
要点：尽量避免同时返回实体（整表对象）与关联对象的深度嵌套，以减少序列化成本；如需嵌套引用，使用 字段级别的别名和明确的 JOIN 条件。
3. 性能与内存控制：大数据量下的数组化策略
当处理海量数据时，单次把全部结果放在内存中容易触发内存抛错。此时应结合分批查询、迭代式消费和合适的 hydration 选项来实现高效的数据提取。
分批处理与迭代访问可以显著降低峰值内存使用，常见做法是使用 toIterable 或 iterate 结合 HYDRATE_ARRAY。
3.1 使用 toIterable() 实现分批处理
toIterable() 能把查询结果以迭代的方式返回，适合在处理导出或 API 分页时逐条消费。结合 HYDRATE_ARRAY，可以逐条输出或写入文件，而不将整批数据载入内存。
$qb = $em->createQueryBuilder()->select('u.id AS id', 'u.name AS name')->from(User::class, 'u')->where('u.active = :active')->setParameter('active', true);$query = $qb->getQuery();
$query->setHydrationMode(\Doctrine\\ORM\\Query::HYDRATE_ARRAY);foreach ($query->toIterable() as $row) {// $row 是一个数组，逐条消费// 例如写入 CSV 行、返回流式 APIprocessRow($row);
}
iterate() 与 toIterable() 的区别：iterate() 返回遍历器，ona 行数据为数组，适合兼容旧版本的逐步处理；toIterable() 提供了更直观的迭代体验，推荐新代码使用。
另外一个要点是，尽量避免在迭代过程中进行大量对象的懒加载或额外查询，保持查询的字段粒度和连接条件简洁。
3.2 避免全量 Hydration 的替代策略
当数据量巨大时，避免全量对象 hydration，改用 HYDRATE_ARRAY 或 CURSOR/SCALAR 模式，可以降低内存开销和序列化成本。
$qb = $em->createQueryBuilder()->select('u.id AS id', 'u.name AS name')->from(User::class, 'u');$query = $qb->getQuery();
// 使用 HYDRATE_ARRAY 可以避免实体对象的创建
$query->setHydrationMode(\Doctrine\\ORM\\Query::HYDRATE_ARRAY);
$rows = $query->getResult();
场景适配：导出任务、日志写入、外部系统对接等场景，尽量使用数组化结构并控制字段粒度，避免附带冗余数据。
4. 与 Symfony 的集成技巧：简化数据转换与序列化过程
在 Symfony 项目中，数组化的查询结果往往直接进入 API 层或序列化阶段。下面给出与 Symfony 生态紧密结合的几条实用技巧，帮助你更高效地把 Doctrine 查询结果转成数组，并用于 JSON/API 输出或导出。
统一数据结构：通过在 Repository 层返回数组，而非实体对象，减少控制器的转换工作量，并提升 API 的可预测性。
4.1 在 Repository 层统一返回数组
将查询逻辑聚合在 Repository 层，返回数组格式，前端或服务层直接使用；这也是微服务/接口化设计中常见的做法。
class UserRepository extends ServiceEntityRepository
{public function findActiveUsersArray(): array{$qb = $this->createQueryBuilder('u')->select('u.id AS id', 'u.name AS name', 'u.email AS email')->where('u.active = :active')->setParameter('active', true);return $qb->getQuery()->getArrayResult();}
}
序列化友好：返回数组后，直接用 Symfony Serializer、JsonResponse 或 CSV 写入器处理输出，避免实体对象的循环引用和递归序列化问题。
错误与边界处理：在数据字段可能为空或需要转换的场景，确保在查询阶段就完成必要的类型转换和默认值设定，以减少后续处理成本。
5. 进阶技巧：结合原生查询与自定义结果映射
在某些复杂场景下，可能需要更自由的字段控制或自定义映射。此时可以结合原生 SQL/DX 与 Doctrine 的结果映射能力，获得期望的数组结构。
自定义结果映射：通过 ResultSetMapping 配置，将原生查询结果映射成你自定义的数组结构，结合 HYDRATE_ARRAY 实现高效输出。
5.1 使用原生查询映射为数组
示例展示了如何用原生 SQL 与 ResultSetMapping 将结果映射为数组，以确保字段名称与前端要求完全一致。
$rsm = new \Doctrine\ORM\Query\ResultSetMapping();
$rsm->s("u.id", "id")->sField("u.name", "name")->sField("d.name", "department");$sql = 'SELECT u.id, u.name, d.name AS departmentFROM users uLEFT JOIN departments d ON u.dept_id = d.id';
$query = $em->createNativeQuery($sql, $rsm);$results = $query->getArrayResult();
原生查询的灵活性让你可以在保持高性能的同时，实现极其自定义的数组结构，适用于报表导出或跨服务的数据接口。
以上内容围绕 如何在 Symfony 项目中把 Doctrine 查询结果转成数组？实战技巧全解 展开，从基础的 getArrayResult 与 HYDRATE_ARRAY 到分批处理、迭代消费，再到与 Symfony 的集成和原生查询映射，提供了实战导向的代码示例与要点。通过掌握这些技巧，你将在实际项目中高效地把 Doctrine 查询结果转换为易于前端使用的数组结构，同时保持优秀的性能与内存控制。