Doctrine Query Builder：通过关联字段数组值高效筛选实体

本教程旨在解决如何使用 doctrine query builder 高效地通过关联实体的某个字段（如 `slug`）的数组值来筛选主实体。我们将探讨传统的两步查询方法的不足，并详细介绍如何利用 `join` 和 `in` 子句在单次数据库查询中直接实现这一目标，从而优化性能并简化代码逻辑。

引言：基于关联实体属性的筛选挑战

在复杂的数据库应用中，我们经常需要根据关联实体的特定属性来筛选主实体。例如，假设我们有一个 Listing 实体代表各种场所列表，每个 Listing 都关联到一个 City 实体。现在，我们面临一个需求：给定一个城市 slug（如 new_york, rome）的数组，需要查询所有属于这些指定城市的 Listing。

一个直观但效率较低的解决方案是执行两步操作：

1. 首先，根据给定的 slug 数组查询 City 实体，获取它们的 ID。
2. 然后，使用这些 City ID 作为参数，查询所有关联的 Listing 实体。

这种方法需要两次数据库往返，并且在应用层进行数据处理（提取 ID），当城市列表较长时，可能会导致性能瓶颈和不必要的复杂性。

实体关系概览

为了更好地理解问题和解决方案，我们先来看一下 Listing 和 City 实体之间的关系：

Listing 实体包含一个 city 属性，它是一个 ManyToOne 关系，指向 City 实体。 City 实体包含 id 和 slug 等属性。

// Listing 实体简化
class Listing
{
    private int $id;
    private string $name;
    private City $city; // ManyToOne 关联到 City 实体
    // ...
}

// City 实体简化
class City
{
    private int $id;
    private string $name;
    private string $slug; // 城市唯一标识符
    // ...
}

登录后复制

我们的目标是，给定一个 $cities = ['new_york', 'rome', 'hong_kong']; 这样的 slug 数组，直接获取所有属于这些城市的 Listing。

低效方案及其局限性

正如前文所述，一种可能的实现方式是先查询城市 ID，再查询列表：

// 假设在 ListingRepository 中
public function findAllByCities(array $citySlugs): array
{
    // 步骤 1: 根据 slugs 查询 City 实体并获取 ID
    // 假设有一个 CityRepository 负责此操作
    $cityRepository = $this->_em->getRepository(City::class);
    $cities = $cityRepository->findBy(['slug' => $citySlugs]); // 获取 City 实体集合

    $citiesIds = array_map(static fn(City $city): int => $city->getId(), $cities);

    // 步骤 2: 使用获取到的城市 ID 查询 Listing
    $qb = $this->createQueryBuilder('l');
    return $qb
        ->select('l')
        ->where($qb->expr()->in('l.city', ':cities')) // 注意这里 l.city 是一个实体对象，Doctrine 会自动解析为 ID
        ->setParameter('cities', $citiesIds, \Doctrine\DBAL\Connection::PARAM_INT_ARRAY) // 使用 PARAM_INT_ARRAY
        ->getQuery()
        ->getResult();
}

登录后复制

这种方法虽然可行，但存在明显缺点：

标签： php app 性能瓶颈 字符串数组