如何在DQL中实现仅按年份字段分组的统计查询？

你需要先明确DQL的查询逻辑是基于Doctrine映射的实体类，而非直接操作数据库表。假设你的用户实体类路径为App\Entity\User，实体中创建时间属性为created（和你给出的SQL里的表字段对应），直接使用Doctrine内置的YEAR()日期函数即可实现和原生SQL完全一致的统计效果。

纯DQL写法 #

和你提供的原生SQL逻辑等价的DQL语句如下：

SELECT YEAR(u.created) AS year, COUNT(u.id) AS newusers
FROM App\Entity\User u
GROUP BY YEAR(u.created)

这里用COUNT(u.id)统计用户数比原SQL的COUNT(*)更严谨，会自动过滤主键为空的异常数据，最终统计结果和原SQL完全一致。

QueryBuilder写法 #

如果你在项目中用Doctrine查询构造器实现，对应代码如下：

// $em 是你从服务容器获取到的Doctrine实体管理器实例
$qb = $em->createQueryBuilder();
$qb->select('YEAR(u.created) as year, COUNT(u.id) as newusers')
   ->from('App\Entity\User', 'u')
   ->groupBy('YEAR(u.created)');

$result = $qb->getQuery()->getResult();

执行返回的结果集每一项包含year（年度值）、newusers（对应年度新增用户总数）两个字段，和原SQL的返回结构完全匹配。

常见问题说明 #

• 新版本Doctrine ORM默认已经注册了YEAR()、MONTH()这类常用日期DQL函数，不需要额外配置就能直接使用
• 如果运行时抛出YEAR函数不存在的错误，只需要在项目的Doctrine配置中，把内置的YEAR日期函数注册到DQL函数列表即可正常运行

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