Symfony 6中如何按关联实体属性对Shop实体排序？

步骤1：确保查询关联Country实体 #

在ShopRepository中编写包含关联查询的方法，让KnpPaginator能访问到Country的属性：

public function findAllWithCountry()
{
    return $this->createQueryBuilder('s')
        ->leftJoin('s.country', 'c')
        ->addSelect('c') // 可选，提前加载关联避免N+1查询
        ->getQuery();
}

步骤2：控制器中配置排序映射 #

调用KnpPaginator的paginate方法时，指定排序字段的映射规则，将国家排序指向Country的name属性：

$paginator = $this->get('knp_paginator');
$query = $this->getDoctrine()->getRepository(Shop::class)->findAllWithCountry();

$pagination = $paginator->paginate(
    $query,
    $request->query->getInt('page', 1),
    10, // 每页显示条数
    [
        'defaultSortFieldName' => 'c.name', // 默认按国家名称排序
        'defaultSortDirection' => 'asc',
        'sortFieldWhitelist' => [
            's.id',
            's.name',
            'c.name' // 允许按国家名称排序
        ]
    ]
);

步骤3：前端模板指定排序字段 #

在Twig模板的表格表头中，把国家列的排序链接指向c.name：

<th>{{ knp_pagination_sortable(pagination, '国家名称', 'c.name') }}</th>

关键注意点 #

• 必须在QueryBuilder中显式join关联实体，否则KnpPaginator无法解析关联字段的排序逻辑
• sortFieldWhitelist用于限制可排序的字段，防范SQL注入风险
• 前端排序链接的字段名要和配置中的c.name完全匹配

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