Doctrine SQL Query Builder使用映射名称还是数据库原始名称？

下面分几个关键点确认：

• QueryBuilder生成的是DQL而非SQL：Doctrine的QueryBuilder本质是面向实体的DQL构建工具，最终由ORM层负责将DQL转换为适配数据库的SQL语句，这是ORM封装数据库细节的核心设计，和它的名称确实存在一定误导性，但功能定位就是围绕实体模型而非原生SQL。

• 基于实体类与属性名构建查询：QueryBuilder的所有操作都是针对实体类及其属性的，比如使用$qb->select('u.username')时，u是实体的别名，username是实体类定义的属性名，而非数据库表的列名。

• 属性名变更需修改QueryBuilder代码：如果实体的属性名发生变更（比如把username改为userAccount），那么所有在QueryBuilder中引用该属性的代码都需要同步修改，因为QueryBuilder直接依赖属性名来构建DQL。

• 数据库列名变更仅需修改映射注解：如果只是数据库中的列名修改，只需要更新实体类上的映射注解（比如@Column(name="new_user_account")），QueryBuilder的代码无需任何改动——ORM会自动处理属性到新列名的映射转换，不会影响上层的查询构建逻辑。

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