如何在 Symfony 中正确使用 Doctrine DQL 查询实体数据

在 Symfony 中使用 Doctrine DQL 时，必须引用实体类名（如 AppBundle:ParkingTicketSettings），而非数据库表名（如 parking_ticket_settings），否则会触发“Class is not defined”语义错误。

在 Symfony 里使用 Doctrine DQL 时，引用的必须是实体类名，比如 `AppBundle:ParkingTicketSettings`，而不是数据库表名，例如 `parking_ticket_settings`。一旦把表名直接写进 DQL，通常就会触发“Class is not defined”这类语义错误。

Doctrine 的 DQL（Doctrine Query Language）本质上是一套面向对象的查询语言，它直接处理的是实体类及其属性，并不是底层数据库里的表和字段。也正因为如此，DQL 里的 FROM 子句必须写成已经注册过的实体类的完整类名（包含命名空间或简写别名），不能把数据库表名直接填进去。

你原始代码中的问题在于：

$query = $em->createQuery("SELECT parking_ticket_settings.id FROM parking_ticket_settings JOIN zone z ON(z.id = parking_ticket_settings.zone_id) WHERE z.zone_identifier = '" . $AxfonePushPayment->getZone() . "'");

这里：

• parking_ticket_settings 是数据库表名，不是 Doctrine 实体类；
• zone 同样是表名，未映射为实体类；
• 手动拼接 $AxfonePushPayment->getZone() 构成 SQL 注入风险；
• 缺少参数化绑定，违反安全最佳实践。

✅ 正确做法是：

1. 确认实体类已正确定义并映射（例如 src/AppBundle/Entity/ParkingTicketSettings.php），且包含正确的 Doctrine 注解（如 @ORMTable(name="parking_ticket_settings")）；
2. 使用实体类全名或配置的别名（如 AppBundle:ParkingTicketSettings）；
3. 通过关联关系或显式 JOIN 实体（而非表），并利用 Doctrine 的对象关系映射能力；
4. 始终使用参数化查询防止注入。

? 示例修正代码（推荐写法）：

$em = $this->getDoctrine()->getManager();

// 假设 ParkingTicketSettings 和 Zone 实体已建立双向关联（如 parking_ticket_settings.zone → Zone）
$query = $em->createQuery(
'SELECT pts.id FROM AppBundle:ParkingTicketSettings pts ' .
'JOIN AppBundle:Zone z WITH z.id = pts.zone ' .
'WHERE z.zoneIdentifier = :zoneIdentifier'
)->setParameter('zoneIdentifier', $AxfonePushPayment->getZone());

$ptsID = $query->getResult(); // 返回 [['id' => 123], ...]
// 或获取纯 ID 数组：$query->getScalarResult();

? 注意事项：

• 若 ParkingTicketSettings 实体中 zone 属性是 ManyToOne 关联到 Zone 类，则可简化为 JOIN pts.zone z（无需 WITH）；
• 确保实体类属性名（如 zoneIdentifier）与实际定义的 getter/setter 或字段名一致（DQL 区分大小写）；
• 避免在 DQL 中使用反引号、单引号包裹字段名——DQL 不支持原生 SQL 语法；
• 如需调试，可通过 $query->getSQL() 查看 Doctrine 生成的真实 SQL（但仅限开发环境）。

? 总结：DQL ≠ SQL。牢记「DQL 操作实体，SQL 操作表」——这是解决 Class is not defined 错误的核心原则。迁移原生 SQL 到 DQL 时，第一步永远是校验实体类是否存在、是否可被自动加载，并用类名替代表名。