两款万能的php分页类

为了实现网站瀑布流式的展示方式，我们往往需要利用分页技术。PHP分页类是一个非常常见的工具，大大简化了分页逻辑的实现。下面我将为大家介绍两款优秀的PHP分页类：Pagerfanta和Pagination。

Pagerfanta

Pagerfanta是一个功能强大的用于生成分页的PHP库。与一般的分页库不同，它支持分页器的定制，并允许自定义分页器的输出和设置，这使得许多网站可以利用这款库生成他们所需要的独特分页器。

安装

使用Composer进行安装：

composer require pagerfanta/pagerfanta

使用

在使用Pagerfanta库时，首先要实例化一个Pagerfanta对象，设置好页面上显示的条目数量、数据总条数以及与当前页码对应的数据集。代码示例如下：

use Pagerfanta\Pagerfanta;

$pager = new Pagerfanta();
$pager->setMaxPerPage(10);   // 每页显示10条数据
$pager->setTotalItems(200); // 总共有200条数据
$pager->setCurrentPage($currentPage);   // $currentPage表示当前页码号
$pager->setCurrentPageOffset(5);  // 显示5个页码号
$pager->setNormalizeOutOfRangePages(true);  // 把不在页码范围内的页码重定向到第一页或者最后一页

// 设置与当前页码所对应的数据集
$offset = ($pager->getCurrentPage() - 1) * $pager->getMaxPerPage();
$limit = $pager->getMaxPerPage();
$data = array_slice($allData, $offset, $limit);

这样就完成了Pagerfanta的初始化。接着我们可以在页面中输出分页控件：

<?php foreach ($pager->getLinks() as $link): ?>
    <?php if ($link['is_current']): ?>
        <span><?php echo $link['page'] ?></span>
    <?php else: ?>
        <a href="<?php echo $urlGenerator($link['page']) ?>"><?php echo $link['page'] ?></a>
    <?php endif ?>
<?php endforeach ?>

上面的代码会输出所有要显示的页面号码以及链接，其中当前页的页码号被包装在<span>标签中，并被禁止了链接。示例如下：

1 <a href="/page/2">2</a> <a href="/page/3">3</a> ... <a href="/page/20">20</a>

Pagination

Pagination是一个基于jQuery和PHP的分页组件，支持自定义样式和翻页效果。Pagination支持大量的选项，可以用于几乎所有分页需求。其美好的UI效果和灵活的配置有助于让分页成为您网站上展示数据的最佳选择。

安装

您可以从GitHub上下载Pagination的源码，或者使用Composer安装：

composer require skyzyx/pagination

使用

在使用Pagination时，首先要把数据进行分页，并设置好相关的参数。下面的示例将一个数组进行分页，并输出分页组件：

require_once('pagination.php');

$data = array(
    array('id' => 1, 'name' => 'banana'),
    array('id' => 2, 'name' => 'apple'),
    array('id' => 3, 'name' => 'pear'),
    array('id' => 4, 'name' => 'orange'),
    array('id' => 5, 'name' => 'peach'),
    array('id' => 6, 'name' => 'plum'),
    array('id' => 7, 'name' => 'grape'),
    array('id' => 8, 'name' => 'watermelon'),
    array('id' => 9, 'name' => 'lemon'),
    array('id' => 10, 'name' => 'strawberry')
);

$pagination = new Pagination(count($data), 3, 2);
$paginated_data = array_slice($data, $pagination->start, $pagination->quantity);

foreach ($paginated_data as $row) {
    echo sprintf("<p>%s</p>", $row['name']);
}

echo $pagination->links();

其效果如下：

< 1 2 3 4 5 > 

以上就是关于Paginator和Pagination的使用介绍。通过掌握这两款分页库的使用方法，相信您会更加方便地实现网页的分页功能。