如何用Doctrine Query Builder为关联表添加计数列

核心思路 #

用子查询替代JOIN，在SELECT子句中嵌入统计逻辑，直接关联街道与对应房屋的关系，既避免JOIN带来的性能损耗，又能同时获取街道数据和有效房屋计数。

Doctrine Query Builder 实现代码 #

假设Street实体主键为id，House实体中关联街道的字段为street，状态字段为status：

use Doctrine\ORM\EntityManagerInterface;
use App\Entity\Street;
use App\Entity\House;

// 初始化Query Builder
$qb = $entityManager->createQueryBuilder();

// 主查询：选择街道所有字段 + 有效房屋计数子查询
$qb->select(
        's',
        '(SELECT COUNT(h.id) FROM ' . House::class . ' h WHERE h.street = s AND h.status = 1) AS activeHouseCount'
    )
    ->from(Street::class, 's');

// 执行查询，结果中每条街道对象会附带activeHouseCount属性
$streetsWithCount = $qb->getQuery()->getResult();

代码说明 #

• 子查询通过h.street = s关联当前街道，仅统计状态为1的房屋数量，别名activeHouseCount会作为额外字段返回
• 无需JOIN操作，避免了大表JOIN的性能问题，尤其适合房屋数据量较大的场景
• 若实体字段映射不同（比如街道主键不是id、房屋关联字段是streetId），只需对应调整子查询中的关联条件即可

对应原生SQL参考 #

如果你的可用原生SQL类似以下写法，上述Query Builder代码就是其ORM等价实现：

SELECT s.*, (SELECT COUNT(h.id) FROM house h WHERE h.street_id = s.id AND h.status = 1) AS active_house_count FROM street s;

额外提示 #

• 可以在主查询后追加->where()、->orderBy()等条件，筛选或排序街道数据
• 确保House实体与Street的关联关系已正确配置Doctrine映射，否则无法识别h.street = s的关联逻辑

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