Smarty分页需在PHP控制器中计算并传入$page、$limit、$total等必要参数，模板中通过预生成的$pager数组渲染页码，URL参数须完整继承以防丢失搜索条件。
Smarty 中怎么传入分页数据
Smarty 本身不处理分页逻辑，只负责渲染。你需要在 PHP 控制器里算好当前页、总条数、每页数量、总页数、起始偏移量这些值，再 assign() 给模板。
常见错误是只传了 $page 和 $limit，漏掉 $total —— 没有总记录数，模板里就无法算出总页数，也就没法生成页码链接。
- 必须传的变量：
$page（当前页，建议从 1 开始）、$limit（每页几条）、$total（总记录数） - 推荐一并传入：
$offset（用于 SQL 的OFFSET）、$pages（总页数，ceil($total / $limit)） - URL 参数要保留：比如搜索关键词
$keyword或分类 ID$cid，否则翻页后条件丢失
Smarty 模板里怎么生成分页 HTML
别在模板里写循环计算页码逻辑——Smarty 的数学函数太弱，容易出错。推荐把页码数组（如 [1,2,3,...] 或带省略号的结构）提前在 PHP 层组装好，直接 assign('pager', $pager) 进去。
例如 PHP 端生成一个含 url、num、is_current 的数组：
立即学习“PHP免费学习笔记（深入）”；
$pager = [];
for ($i = max(1, $page - 2); $i <= min($pages, $page + 2); $i++) {
$pager[] = [
'num' => $i,
'url' => "?page={$i}&keyword={$keyword}",
'is_current' => ($i == $page)
];
}模板中用 {foreach $pager as $p} 渲染即可，干净又可控。
- 避免用
{math}在模板里算页码：兼容性差，可读性低，调试困难 - 上一页/下一页链接需手动判断边界：
{if $page > 1}...{/if}，不能依赖自动截断 - 注意 URL 中的
&要转义，否则 HTML 解析出错
SQL 查询怎么配合分页参数
PHP 控制器里拼 SQL 时，$offset 必须基于 $page 和 $limit 严格计算：$offset = ($page - 1) * $limit。错写成 $page * $limit 会导致跳过第一页数据。
另外，COUNT(*) 查询不能省——即使用了缓存，首次加载也得查真实总数，否则分页栏显示异常（比如显示“共 0 页”或无限翻页）。
- 务必对
$page做强校验：$page = max(1, (int)$_GET['page']);，防止负数或非数字导致 SQL 报错 -
$limit也要过滤，比如限定在 10–100 之间，防恶意传大数值拖垮数据库 - MySQL 8.0+ 可用
OFFSET ... LIMIT，但注意OFFSET值很大时性能陡降，真要撑百万级数据得换游标分页
为什么分页链接点开会丢失 GET 参数
因为很多人写分页链接时硬编码 URL，比如 ?page=2，没把原始请求里的其他参数（如 keyword、sort、cid）带上。结果一翻页，搜索条件全没了。
解决方法不是拼字符串，而是用 PHP 构造干净的参数数组：
$params = $_GET; $params['page'] = $i; // 覆盖 page unset($params['PHPSESSID']); // 可选：去掉 session id $url = '?' . http_build_query($params);
这样无论原 URL 是 ?keyword=php&sort=time 还是 ?cid=5&page=1，都能正确继承。
- 别用
$_SERVER['QUERY_STRING']替换 page —— 它可能含非法字符或重复参数 - 如果用了伪静态（如
/list/2），那路由层必须把参数透传进控制器，否则模板拿不到上下文 - 前端 JS 翻页时也要同步携带全部参数，否则和后端状态不一致
分页看着简单，但跨模板、跨请求、跨数据库的参数一致性最容易被忽略。尤其是 $page 校验、$total 获取、URL 参数继承这三点，线上出问题基本都栽在这儿。
