当前位置：首页 > 文章列表 > 文章 > php教程 > Doctrine排除重叠时间查询方法

Doctrine排除重叠时间查询方法

2025-08-28 08:03:31 0浏览收藏

在 Doctrine 中，查询某个时间段内可用的产品，并排除已被预订的时间段，是一个常见的需求。本文深入探讨了如何利用 Doctrine QueryBuilder 有效地检测时间段的重叠，并构建相应的 SQL 查询以实现这一目标。文章详细解释了时间段重叠的三种情况：预订开始时间在给定时间段内、预订结束时间在给定时间段内，以及给定时间段包含在预订时间段内。通过提供的 `ProductRepository` 示例代码，展示了如何使用 `NOT EXISTS` 子查询和 `OR` 表达式来排除重叠时间段，并返回在指定时间段内可用的产品。本文旨在帮助开发者掌握在 Doctrine 中处理时间段查询和排除的技巧，提升数据查询的效率和准确性。

排除Doctrine QueryBuilder中重叠的时间段

在Doctrine中，当需要查询某个时间段内可用的产品，并且这些产品可能存在预订记录时，排除已被预订的时间段变得至关重要。核心问题在于如何有效地检测时间段的重叠，并利用QueryBuilder构建相应的SQL查询。

要检测时间段的重叠，需要考虑以下三种情况：

预订的开始时间在给定的时间段内。
预订的结束时间在给定的时间段内。
给定的时间段的开始时间在预订的开始时间和结束时间之间。

满足以上任何一个条件，都意味着预订与给定的时间段存在重叠。

以下是一个使用Doctrine QueryBuilder实现此逻辑的示例：

<?php

namespace App\Repository;

use Doctrine\Bundle\DoctrineBundle\Repository\ServiceEntityRepository;
use Doctrine\Persistence\ManagerRegistry;
use App\Entity\Product;
use DateTimeInterface;

/**
 * @extends ServiceEntityRepository<Product>
 *
 * @method Product|null find($id, $lockMode = null, $lockVersion = null)
 * @method Product|null findOneBy(array $criteria, array $orderBy = null)
 * @method Product[]    findAll()
 * @method Product[]    findBy(array $criteria, array $orderBy = null, $limit = null, $offset = null)
 */
class ProductRepository extends ServiceEntityRepository
{
    public function __construct(ManagerRegistry $registry)
    {
        parent::__construct($registry, Product::class);
    }

    /**
     * @return Product[] Returns an array of Product objects
     */
    public function getAvailableProducts(\DateTimeInterface $startAt, \DateTimeInterface $endAt): array
    {
        $qb = $this->createQueryBuilder('p');
        $qb->select('p')
           ->leftJoin('p.bookings', 'b')
           ->where(
               $qb->expr()->not(
                   $qb->expr()->exists(
                       $this->createQueryBuilder('sub_p')
                           ->select('1')
                           ->from('App\Entity\Booking', 'sub_b')
                           ->where('sub_b.product = p.id')
                           ->andWhere(
                               $qb->expr()->orX(
                                   $qb->expr()->between('sub_b.startAt', ':startAt', ':endAt'),
                                   $qb->expr()->between('sub_b.endAt', ':startAt', ':endAt'),
                                   $qb->expr()->andX(
                                       $qb->expr()->lte('sub_b.startAt', ':startAt'),
                                       $qb->expr()->gte('sub_b.endAt', ':endAt')
                                   )
                               )
                           )
                   )
               )
           )
           ->setParameter('startAt', $startAt)
           ->setParameter('endAt', $endAt);

        return $qb->getQuery()->getResult();
    }
}

代码解释：

createQueryBuilder('p'): 创建一个查询构建器，别名为 'p'，代表 Product 实体。
leftJoin('p.bookings', 'b'): 使用左连接将 Product 实体与 Booking 实体关联起来，别名为 'b'。
where(...): 添加 WHERE 子句来过滤结果。
$qb->expr()->not($qb->expr()->exists(...)): 使用 NOT EXISTS 子查询来查找没有在指定时间段内被预订的产品。
$this->createQueryBuilder('sub_p')->select('1')->from('App\Entity\Booking', 'sub_b'): 创建一个子查询构建器，用于检查产品是否在指定时间段内被预订。
->where('sub_b.product = p.id'): 子查询的 WHERE 子句，确保子查询只查找与当前产品相关的预订。
->andWhere($qb->expr()->orX(...)): 子查询的 AND WHERE 子句，使用 OR 表达式来检查预订是否与指定时间段重叠。
$qb->expr()->between('sub_b.startAt', ':startAt', ':endAt'): 检查预订的开始时间是否在指定时间段内。
$qb->expr()->between('sub_b.endAt', ':startAt', ':endAt'): 检查预订的结束时间是否在指定时间段内。
$qb->expr()->andX($qb->expr()->lte('sub_b.startAt', ':startAt'), $qb->expr()->gte('sub_b.endAt', ':endAt')): 检查预订的开始时间是否早于或等于指定时间段的开始时间，并且预订的结束时间是否晚于或等于指定时间段的结束时间。
setParameter('startAt', $startAt): 设置参数 startAt 的值。
setParameter('endAt', $endAt): 设置参数 endAt 的值。
getQuery()->getResult(): 执行查询并返回结果。