如何按指定数组顺序对Doctrine集合按control字段排序？

数据库层面排序（推荐） #

直接在查询阶段通过DQL的CASE WHEN语法实现自定义排序，这是效率最高的方式——数据库原生排序比内存处理更高效，且返回的集合直接符合需求，无需后续处理。

示例代码（QueryBuilder实现） #

$priorityControls = [1616, 1617, 518];
$qb = $entityManager->createQueryBuilder();

$sortedCollection = $qb->select('e')
    ->from(YourEntity::class, 'e')
    // 第一步：指定control值的实体排在最前面
    ->addOrderBy(
        $qb->expr()->case()
            ->when($qb->expr()->in('e.control', ':priorityControls'), 0)
            ->otherwise(1),
        'ASC'
    )
    // 第二步：按给定数组的顺序排列指定control的实体
    ->addOrderBy(
        $qb->expr()->case()
            ->when($qb->expr()->eq('e.control', 1616), 1)
            ->when($qb->expr()->eq('e.control', 1617), 2)
            ->when($qb->expr()->eq('e.control', 518), 3)
            ->otherwise(4),
        'ASC'
    )
    // 第三步：非指定control的实体优先展示fact非空的
    ->addOrderBy(
        $qb->expr()->case()
            ->when($qb->expr()->isNotNull('e.fact'), 0)
            ->otherwise(1),
        'ASC'
    )
    ->setParameter('priorityControls', $priorityControls)
    ->getQuery()
    ->getResult();

内存中高效处理（适用于无法修改原查询的场景） #

如果无法调整数据库查询，可在内存中处理集合。由于仅20+条数据，只要实现方式得当，效率完全达标——核心是通过关联数组快速定位指定control的实体，避免低效遍历查找。

示例代码 #

$priorityControls = [1616, 1617, 518];
$yourCollection = // 你的Doctrine集合对象

// 将集合转为以control为键的关联数组，O(n)时间复杂度
$entityMap = [];
foreach ($yourCollection as $entity) {
    $entityMap[$entity->getControl()] = $entity;
}

$sortedEntities = [];

// 按指定顺序取出优先级实体，并从映射中移除（避免重复）
foreach ($priorityControls as $control) {
    if (isset($entityMap[$control])) {
        $sortedEntities[] = $entityMap[$control];
        unset($entityMap[$control]);
    }
}

// 处理剩余实体：优先排序fact非空的
$remainingEntities = array_values($entityMap);
usort($remainingEntities, function($a, $b) {
    $aHasFact = $a->getFact() !== null;
    $bHasFact = $b->getFact() !== null;
    
    // fact非空的排前面
    if ($aHasFact !== $bHasFact) {
        return $aHasFact ? -1 : 1;
    }
    // 其他情况可按任意逻辑排序，这里以control升序为例
    return $a->getControl() - $b->getControl();
});

// 合并结果并转回Doctrine集合（可选）
$sortedEntities = array_merge($sortedEntities, $remainingEntities);
$resultCollection = new \Doctrine\Common\Collections\ArrayCollection($sortedEntities);

关于Doctrine功能需求的说明 #

无需向Doctrine提交功能需求。这种排序属于业务场景特定的自定义逻辑，Doctrine作为通用ORM，不可能内置所有场景的排序规则；且现有机制（DQL的CASE WHEN、内存高效处理）已经能完美满足需求。

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