Doctrine：如何通过Criteria按关联实体属性排序

你遇到的这个问题核心是Doctrine原生Criteria的局限性，结合你使用的Kdyby/Doctrine扩展来解释：

• Kdyby/Doctrine对原生Doctrine的findBy方法做了定制扩展，能够解析user.active这种关联实体的属性路径，自动帮你完成联表和排序逻辑；
• 但repository->matching()方法沿用的是Doctrine ORM原生实现，它只支持对当前实体（这里是Employee）的直接属性进行排序/过滤，无法识别关联实体的嵌套属性路径，所以才会抛出Unrecognized field: user.active的错误。

下面给你几个可行的解决方案，按需选择：

方案一：封装可复用的QueryBuilder方法（推荐，数据库层面处理） #

如果你希望在数据库层面完成过滤和排序，同时保持代码复用性，可以自己封装一个类似findByCriteria的方法，用QueryBuilder处理关联属性：

/**
 * @param array $criteria
 * @param array|null $orderBy
 * @param int|null $limit
 * @param int|null $offset
 * @return \Doctrine\Common\Collections\Collection
 */
public function findByWithAssociationSupport(array $criteria, ?array $orderBy = null, ?int $limit = null, ?int $offset = null)
{
    $qb = $this->createQueryBuilder('e');

    // 处理过滤条件
    foreach ($criteria as $field => $value) {
        if (strpos($field, '.') !== false) {
            // 拆分关联属性，比如user.active拆分为关联名user和属性active
            [$assocAlias, $prop] = explode('.', $field, 2);
            // 联表并添加条件
            $qb->leftJoin("e.$assocAlias", $assocAlias)
               ->andWhere("$assocAlias.$prop = :$field")
               ->setParameter($field, $value);
        } else {
            // 普通实体属性直接添加条件
            $qb->andWhere("e.$field = :$field")
               ->setParameter($field, $value);
        }
    }

    // 处理排序规则
    if ($orderBy) {
        foreach ($orderBy as $field => $direction) {
            if (strpos($field, '.') !== false) {
                [$assocAlias, $prop] = explode('.', $field, 2);
                // 避免重复联表
                $existingJoins = array_column($qb->getDQLPart('join'), 'alias');
                if (!in_array($assocAlias, $existingJoins)) {
                    $qb->leftJoin("e.$assocAlias", $assocAlias);
                }
                $qb->addOrderBy("$assocAlias.$prop", $direction);
            } else {
                $qb->addOrderBy("e.$field", $direction);
            }
        }
    }

    // 设置分页参数
    if ($offset !== null) {
        $qb->setFirstResult($offset);
    }
    if ($limit !== null) {
        $qb->setMaxResults($limit);
    }

    return new \Doctrine\Common\Collections\ArrayCollection($qb->getQuery()->getResult());
}

这个方法可以像你原来的findByCriteria一样复用，同时支持关联属性的过滤和排序，所有逻辑都在数据库层面完成，性能更优。

方案二：内存中排序（小数据量可用） #

如果你的数据量不大，可以先用matching完成数据库层面的过滤，再在PHP内存中对结果集合进行排序：

// 先用Criteria过滤数据
$filteredEmployees = $this->repository->matching($criteria);

// 在内存中按user.active排序
uasort($filteredEmployees, function(Employee $a, Employee $b) {
    // <=> 是PHP7+的太空船运算符，用来比较两个值
    return $a->getUser()->getActive() <=> $b->getUser()->getActive();
});

⚠️ 注意：这种方式只适合小数据量，数据量大时会占用大量PHP内存，性能很差。

方案三：检查Kdyby/Doctrine的扩展支持 #

因为Kdyby/Doctrine已经实现了findBy的关联属性支持，你可以查看它的官方文档，看看是否提供了扩展版的Criteria或者自定义Repository类，能够让matching方法也支持关联属性的路径解析。如果有的话，替换原生相关类即可解决问题。

内容的提问来源于stack exchange，提问作者Martin Pohorský