PHP翻页函数如何与Smarty模板引擎结合渲染分页-php教程-PHP中文网

php分页逻辑必须在控制器中完整计算并传入smarty，严禁模板处理；需传$page、$limit、$total、$offset等关键参数，url翻页链接须继承所有业务查询参数，sql的where和limit/offset必须严格一致。

php翻页函数如何与smarty模板引擎结合渲染分页

PHP分页逻辑必须在控制器里算清，不能甩给Smarty

Smarty不处理分页计算，只负责渲染。你传什么，它就输出什么；漏传关键参数，页码就直接崩掉。最常见错误是只传 $page 和 $limit，却忘了 $total——没有总记录数，模板根本没法算出总页数，$pages = ceil($total / $limit) 就会失效。

必须明确传入的变量：

$page：当前页码，建议从 1 开始（别用 0 起始，否则 URL 和逻辑易混乱）
$limit：每页几条，要和 SQL 的 LIMIT 严格一致
$total：数据库查出的真实总条数（不是 count(*) 估算值，而是带 where 条件后的准确值）
$offset：直接用于 SQL 的偏移量，$offset = ($page - 1) * $limit，避免模板里重复计算

额外推荐传入：$pages（总页数）、$pager（预组装好的页码数组），能大幅降低模板复杂度。

URL参数必须手动继承，否则翻页就丢搜索条件

翻页链接不是简单写 page=2，而是要把当前所有有效查询参数（比如 keyword=php、cid=5、sort=name）都带上。否则点“下一页”，关键词没了，分类没了，结果全错。

PHP 端生成分页链接时，建议用 http_build_query() 拼接：

$params = $_GET;
$params['page'] = $i; // 替换 page 值
$url = '?' . http_build_query($params);

注意过滤掉可能干扰的键（如 PHPSESSID 或调试参数），但业务参数一个都不能少。

PHP

编写健壮的PHP代码，规避类型转换陷阱、数组怪癖及常见安全漏洞。

下载

别在Smarty模板里写页码循环逻辑

Smarty 的数学函数（$smarty.section.xxx.index、math 插件）又慢又难 debug，还容易因数据结构变化崩掉。更稳妥的做法是：PHP 层直接生成好 $pager 数组，再 assign('pager', $pager) 进去。

例如 PHP 端构造一个带结构的页码数组：

$pager = [];
for ($i = 1; $i  $base_url . '&page=' . $i,
        'num' => $i,
        'is_current' => ($i == $page),
        'is_ellipsis' => false
    ];
}
// 再加前后省略逻辑（如 1, 2, ..., 8, 9, 10）
$smarty->assign('pager', $pager);

模板里就干净了：

{foreach $pager as $p}
  {if $p.is_ellipsis}
    <span class="dots">…</span>
  {else}
    <a href="https://www.php.cn/link/b7af411bc561c0025f74b5e2c6e233bc" class="{if $p.is_current}active{/if}">{$p.num}</a>
  {/if}
{/foreach}