Symfony 6.3页面实现两个独立分页互不干扰的方法

问题说明 #

页面内的两个分页组件，切换第一个分页到第2页时，第二个分页会同步跳转至第2页，需要实现二者独立运作、互不干扰。

核心原因与解决思路 #

Symfony常用的分页组件（如KnpPaginatorBundle）默认使用相同的页码参数名（比如page），这是导致两个分页同步的直接原因。只需给每个分页配置不同的参数名，即可实现独立控制。

1. 控制器层指定参数名 #

以KnpPaginator为例，在控制器处理两组分页数据时，分别设置专属的参数名：

// 处理第一个分页数据
$firstPagination = $paginator->paginate(
    $firstDataQuery,
    $request->query->getInt('page_first', 1), // 用page_first作为第一个分页的页码参数
    10, // 每页显示条数
    [
        'pageParameterName' => 'page_first',
    ]
);

// 处理第二个分页数据
$secondPagination = $paginator->paginate(
    $secondDataQuery,
    $request->query->getInt('page_second', 1), // 用page_second作为第二个分页的页码参数
    10,
    [
        'pageParameterName' => 'page_second',
    ]
);

2. 模板层渲染对应分页 #

在Twig模板中渲染分页时，传递对应的参数名：

{# 渲染第一个分页 #}
{{ knp_pagination_render(firstPagination, 'pagination.html.twig', {'pageParameterName': 'page_first'}) }}

{# 渲染第二个分页 #}
{{ knp_pagination_render(secondPagination, 'pagination.html.twig', {'pageParameterName': 'page_second'}) }}

3. 自定义分页模板适配（可选） #

如果使用自定义分页模板，要确保模板中使用传入的参数名生成链接，而非硬写page：

{# 自定义pagination.html.twig内的页码链接示例 #}
<a href="{{ path(app.request.attributes.get('_route'), app.request.query.all|merge({ (pageParameterName): page })) }}">
    {{ page }}
</a>

完成以上配置后，两个分页会分别使用page_first和page_second作为页码参数，切换操作将互不影响。

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