knppaginatorbundle是symfony事实标准分页方案，三步安装后需严格按$query、$page、$limit顺序调用paginate()，模板中变量名须为pagination或显式传参，大数据量时应手动设总数或改用游标分页。
用 KnpPaginatorBundle 做分页最省事
Symfony 官方不自带分页组件，直接手写 offset/limit 容易漏掉排序一致性、总条数统计、URL 参数继承这些细节。推荐用社区维护最久、兼容性最好的 KnpPaginatorBundle —— 它不是“可选”，而是事实标准。
安装后注册服务、加路由别名，三步就能跑起来：
- 运行
composer require knplabs/knp-paginator-bundle - 在
config/bundles.php里加Knp\Bundle\PaginatorBundle\KnpPaginatorBundle::class => ['all' => true] - 执行
php bin/console knp_paginator:install --assets（仅需一次，生成前端 CSS/JS）
$paginator->paginate() 的三个参数不能乱序
核心是控制器里调用 $paginator->paginate()，它接收三个必填参数：查询对象（Query 或 array）、当前页码（$page）、每页条数（$limit）。顺序错一个，结果就全偏。
常见错误是把 $limit 当成第二个参数传进去，导致分页器误把页码当条数，首页显示 1 条、第二页显示 2 条……
立即学习“PHP免费学习笔记（深入）”；
装修公司源码，采用DIV+CSS布局，首页顶部采用了超大宽屏banner焦点图切换，带伸缩功能的导航条。首页信息展示量大，有利于SEO优化，首页版块包括，导航，焦点图切换，案例，行业动态，装修经验，装修知识。源码支持伪静态，后台开启即可，服务器必须支持rewrite功能，否则无法实现伪静态功能。信息支持二级分类。后台支持信息批量修改，删除，可以支持，视频，图片，附件上传。
public function listAction(Request $request)
{
$query = $em->createQuery('SELECT u FROM App\Entity\User u ORDER BY u.id DESC');
// ✅ 正确：$query, $page, $limit
$pagination = $paginator->paginate($query, $request->query->getInt('page', 1), 10);
// ❌ 错误示例（不要这么写）：
// $paginator->paginate($query, 10, $request->query->getInt('page', 1));
}
模板里用 {{ knp_pagination_render() }} 渲染导航时注意上下文
模板中调用 {{ knp_pagination_render() }} 会自动读取当前请求的 query 参数（比如 ?page=3&sort=name），但前提是你的分页变量名必须叫 pagination —— 名字不对，链接里的 page 参数就始终是 1。
另一个坑是：如果控制器返回了多个分页对象（比如用户列表 + 订单列表），必须分别命名并单独渲染，否则后一个会覆盖前一个的 URL 参数。
- 模板变量名必须是
pagination（或显式传参：{{ knp_pagination_render(pagination) }}） - 多分页场景下，改用不同变量名 + 显式传参：
{{ knp_pagination_render(users) }}、{{ knp_pagination_render(orders) }} - 默认渲染的链接不含
_format=json这类非分页参数，如需保留，得在控制器里手动 merge 到分页器选项中
性能敏感场景下慎用 Query 直接分页
当数据量上百万、count(*) 变慢时，KnpPaginatorBundle 默认会执行两次查询（一次 count，一次 limit+offset），容易拖垮接口。这不是 bug，是设计使然。
解决办法不是换组件，而是绕过 count：
- 用
setTotalItemCount()手动设总数（比如从缓存读、或用估算值） - 改用游标分页（cursor-based pagination）：用
WHERE id ，彻底避开 count - 对超大表，
Query分页不如先查 ID 列表再 JOIN，尤其带复杂关联时
游标分页没法跳转到任意页，但对“加载更多”这类场景更稳；而 KnpPaginatorBundle 本身不支持游标，得自己写逻辑。
