Doctrine DQL：使用关联实体字段数组进行高效筛选

本教程旨在解决如何通过关联实体（如城市）的特定字段（如slug）数组来高效筛选主实体（如列表）的问题。传统上可能通过两次查询并手动处理ID数组，但更优的方法是利用Doctrine QueryBuilder的`JOIN`操作符，直接在单个DQL查询中关联实体并使用`IN`表达式进行条件筛选，从而实现更简洁、高效的数据检索。

场景描述与问题背景

在许多Web应用中，我们经常需要根据关联实体的一些属性来筛选主实体。例如，我们有一个Listing（列表）实体，它与City（城市）实体存在多对一（ManyToOne）关系。每个Listing都属于一个City。现在，我们有一个城市slug（如['new_york', 'rome', 'hong_kong']）的数组，目标是检索所有属于这些指定城市的Listing实体。

City实体包含id和slug字段：

# City
------------------
| ID | slug      |
|  1 | new_york  |
|  2 | rome      |
|  3 | hong_kong |
------------------

登录后复制

Listing实体包含id、name和city（关联City实体）字段：

// Listing.php
/**
 * @ORM\ManyToOne(targetEntity=City::class, inversedBy="listings")
 */
private City $city;

登录后复制

我们的核心需求是：给定一个城市slug数组，如何高效地获取所有匹配的Listing。

传统（但低效）的解决方案

一种常见的思路是分两步完成：

1. 首先，根据提供的城市slug数组查询City实体，获取它们的ID。
2. 然后，使用这些城市ID作为参数，通过IN表达式查询Listing实体。

其大致实现可能如下：

// ListingRepository.php (示例，非最佳实践)
use Doctrine\DBAL\Connection;

class ListingRepository extends ServiceEntityRepository
{
    // ...

    /**
     * @param City[] $citiesEntities
     * @return Listing[]
     */
    public function findAllByCitiesInefficient(array $citiesEntities): array
    {
        $qb = $this->createQueryBuilder('l');
        // 步骤1: 提取城市ID
        $citiesIds = $this->getCitiesIds($citiesEntities); // 假设此方法已获取City实体数组

        // 步骤2: 使用IN查询Listing
        return $qb
            ->select('l')
            ->where($qb->expr()->in('l.city', ':citiesIds'))
            ->setParameter('citiesIds', $citiesIds, Connection::PARAM_INT_ARRAY) // 使用PARAM_INT_ARRAY
            ->getQuery()
            ->getResult();
    }

    /**
     * @param City[] $cities
     * @return int[]
     */
    private function getCitiesIds(array $cities): array
    {
        return array_map(static fn(City $city): int => $city->getId(), $cities);
    }
}

登录后复制

这种方法的缺点在于：

标签： php sql注入 sql语句 防止sql注入 字符串数组