PHPackages                             hehex/hehep-hpage - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. hehex/hehep-hpage

ActiveLibrary[Utility & Helpers](/categories/utility)

hehex/hehep-hpage
=================

hehep-hpage 是一个PHP分页组件,支持自定义分页器,支持自定义分页样式,支持lastId模式

v1.0.0(1y ago)07Apache-2.0PHPPHP >=7.1

Since Sep 13Pushed 10mo ago1 watchersCompare

[ Source](https://github.com/chinahehex/hehep-hpage)[ Packagist](https://packagist.org/packages/hehex/hehep-hpage)[ RSS](/packages/hehex-hehep-hpage/feed)WikiDiscussions master Synced 1mo ago

READMEChangelogDependenciesVersions (2)Used By (0)

hehep-hpage
===========

[](#hehep-hpage)

介绍
--

[](#介绍)

- hehep-hpage 是一个PHP分页组件、
- 支持自定义分页器
- 支持自定义分页样式

安装
--

[](#安装)

- **gitee下载**:

```
git clone git@gitee.com:chinahehex/hehep-hpage.git

```

- **github下载**:

```
git clone git@github.com:chinahehex/hehep-hpage.git

```

- 命令安装：

```
composer require hehex/hehep-hpage

```

组件配置
----

[](#组件配置)

```
$config = [
    // 分页管理器
    //'class'=>'hehe\core\hpage\Pagination',

    // 客户端页面参数名称
    'pageVar'=>'page',

    // 客户端每页条数参数名称
    'psizeVar'=>'psize',

    // 客户端lastId参数名称
    'lastIdVar'=>'lastId',

    // 预定义分页器
    'paginators' => [
        'query'=>['class'=>QueryPaginator::class,'styleClass'=>'样式类路径']
    ],

    // toArray 返回的变量别名,基本格式别名>
    'retAlias'=>[
        'total'=>'total',// 总条数
        'psize'=>'psize',// 每页条数
        'totalPage'=>'totalPage',// 总页数
        'currentPage'=>'currentPage',// 当前页码
        'data'=>'data',// 当前页数据
        'lastId'=>'lastId'// 当前页最后一条数据id
    ],

    // url地址生成器call_user_func 方法格式,Route::buildUrl,闭包
   'uriBuilder'=>[],
];
```

基本示例
----

[](#基本示例)

- 客户端分页

```
use hehe\core\hpage\Pagination;
use hehe\core\hroute\Route;
$hpage = new Pagination();
// 表单数据
$form = [
    'page'=>1,// 当前页码
    'psize'=>10,// 每页显示条数
];

// 设置全局url地址生成器
$hpage->setUriBuilder('hehe\core\hroute\Route::buildUrl');

// 创建一个客户端分页器
$paginator = $hpage->queryPaginator($form);

// 主动设置每页显示条数(不接受客户端每页条数参数)
$paginator->setPageSize(10);

// 主动设置当前页码(不接受客户端页码参数)
$paginator->setCurrentPage(2);

// 设置总条数
$paginator->setTotalCount(3000);

// 获取总页数
$paginator->getTotalPage();

// 获取分页起始位置(用于数据库查询)
$paginator->getOffset();

// 获取分页条数(用于数据库查询)
$paginator->getLimit();

// 设置当前分页数据
$paginator->setData([]);

// 获取分页相关参数
$paginator->toArray();

```

- 内部分页

```
use hehe\core\hpage\Pagination;
$hpage = new Pagination();
// 创建一个内部 分页器
$paginator = $hpage->paginator(1,10);

// 主动设置每页显示条数
$paginator->setPageSize(10);

// 主动设置当前页码
$paginator->setCurrentPage(2);

// 设置总条数
$paginator->setTotalCount(3000);

// 获取总页数
$paginator->getTotalPage();

// 获取分页起始位置(用于数据库查询)
$paginator->getOffset();

// 获取分页条数(用于数据库查询)
$paginator->getLimit();

// 设置当前分页数据
$paginator->setData([]);

// 获取分页相关参数
$paginator->toArray();

```

默认分页器
-----

[](#默认分页器)

- 说明

```
类路径：\hehe\core\hpage\Paginator
功能:提供分页基本功能，封装了分页相关参数，支持自定义分页样式。

```

- 创建默认分页器

```
use \hehe\core\hpage\Pagination;
use \hehe\core\hpage\paginators\Paginator;
use \hehe\core\hpage\paginators\QueryPaginator;
$hpage = new Pagination();

// 创建一个默认分页器,默认每页显示10条数据,当前页码为1
$paginator = $hpage->paginator(1,10);
$paginator = new Paginator(1,10);

// toArray 返回分页相关参数
$result = $paginator->toArray();

// 返回的结果为：
$result = [
    'total'=>10,// 总条数
    'psize'=>1,// 每页显示条数
    'totalPage'=>0,// 总页数
    'currentPage'=>0,// 当前页码
    'data'=>[],// 当前页数据
];

```

- 创建客户端分页器

```
use \hehe\core\hpage\Pagination;
use \hehe\core\hpage\paginators\QueryPaginator;
$hpage = new Pagination();
$formQuery = [
    'page'=>1,// 当前页码
    'psize'=>10,// 每页显示条数
    'lastId'=>''// 当前页最后一条数据id
];
$paginator = $hpage->queryPaginator($formQuery,10);
$paginator = new QueryPaginator($formQuery,10);

// toArray 返回分页相关参数
$result = $paginator->toArray();

// 返回的结果为：
$result = [
    'psize'=>10,// 每页显示条数
    'currentPage'=>1,// 当前页码
    'total'=>0,// 总条数
    'totalPage'=>0,// 总页数
    'data'=>[],// 当前页数据
    'pageVar'=>'',// 客户端页码参数名称
    'psizeVar'=>'',// 客户端每页条数
    'lastId'=>'',// 当前页最后一条数据id
];
```

- 设置/获取分页参数

```
use \hehe\core\hpage\Pagination;
$hpage = new Pagination();
$paginator = $hpage->paginator();

// 每页显示条数(10)
$paginator->setPageSize(10);
$paginator->getPageSize();

// 当前页码(1)
$paginator->setCurrentPage(1);
$paginator->getCurrentPage();

// 总条数(3000)
$paginator->setTotalCount(3000);
$paginator->getTotalCount();

// 总页数(300)
$paginator->getTotalPage();

// 分页数据库起始位置,读取条数
$paginator->getOffset();
$paginator->getLimit();

// 设置当前分页数据
$paginator->setData([]);

// 获取分页相关参数
$paginator->toArray();
```

- LastId模式

```
use \hehe\core\hpage\Pagination;
$hpage = new Pagination();
$formQuery = [
    'page'=>1,// 当前页码
    'psize'=>10,// 每页显示条数
    'lastId'=>2// 当前页最后一条数据id
];
$paginator = $hpage->queryPaginator($formQuery);

// 开启lastId模式，并设置数据端参数名称:"id",'desc' id 的排序规则,客户端参数名称:"lastId"
$paginator->asLastMode('id','desc','lastId');

// 获取客户端lastId参数:2
$paginator->getQueryLastId();

$paginator->setData([
    ['id'=>1, 'name'=>'test1','roleId'=>1],
    ['id'=>2, 'name'=>'test2','roleId'=>3],
    ['id'=>3, 'name'=>'test3','roleId'=>4],
    ['id'=>4, 'name'=>'test4','roleId'=>4],
]);

// 获取数据端最后一条数据id:4
$paginator->getDataLastId();

// 获取是否需要查询总条数状态,当客户端lastId参数为空时，返回true
$paginator->isQueryCount();
```

分页URL
-----

[](#分页url)

- 独立设置分页URL

```
use \hehe\core\hpage\Pagination;
$hpage = new Pagination();
$formQuery = [
    'page'=>1,// 当前页码
    'psize'=>10,// 每页显示条数
];
$paginator = $hpage->queryPaginator($formQuery);
$style = $paginator->newStyle();

// 设置分页URL
$style->setPath('api/test?id=1');

// 带[PAGE]占位符URL
$style->setPath('api/test/[PAGE]?id=1');

$currentPageUrl = $style->getCurrentPageUrl();
// $currentPageUrl: api/test?id=1&page=2
```

- 全局URL生成器

```
use \hehe\core\hpage\Pagination;
$hpage = new Pagination();
// 设置全局URL生成器
$hpage->setUriBuilder(function(string $uri,array $uriParams = []){
    // 自定义自己的URL生成规则
    // $uriParams 已经包含了分页参数
    // return Route::buildUrL($uri,$uriParams);
    return $uri . '?' . http_build_query($uriParams);
});
$hpage = new Pagination();
$formQuery = ['page'=>2,'psize'=>10];
$paginator = $hpage->queryPaginator($formQuery);
$style = $paginator->newStyle();

// 设置分页样式url生成器
$style->setUriBuilder();

$style->setUrl('user/logs',['userId'=>1]);

// 获取当前页URL
$currentPageUrl = $style->getCurrentPageUrl();
// $currentPageUrl : user/logs?userId=1&page=2
```

分页样式器
-----

[](#分页样式器)

- 说明

```
类路径：\hehe\core\hpage\styles\PaginatorStyle

```

- 默认分页样式器

```
use \hehe\core\hpage\Pagination;
use hehe\core\hpage\styles\PaginatorStyle;
$hpage = new Pagination();
$formQuery = [
    'page'=>1,// 当前页码
    'psize'=>10,// 每页显示条数
];
$paginator = $hpage->queryPaginator($formQuery);

// 分页器与样式绑定
$pstyle = $paginator->setStyleClass(PaginatorStyle::class);

// 创建分页器样式对象
$args = [];// 分页样式器构造参数
$style = $paginator->newStyle(...$args);

// 获取分页器样式参数
$style->toArray();
```

- 数字分页样式器

```
use \hehe\core\hpage\Pagination;
use hehe\core\hpage\styles\NumPaginatorStyle;
$hpage = new Pagination();
$formQuery = [
    'page'=>1,// 当前页码
    'psize'=>10,// 每页显示条数
];
$paginator = $hpage->queryPaginator($formQuery);

// 分页器与样式绑定
$pstyle = $paginator->setStyleClass(NumPaginatorStyle::class);

// 创建分页器样式对象
$args = [6];// 分页样式器构造参数
$style = $paginator->newStyle(...$args);

// 获取分页器样式参数
$style->toArray();
```

###  Health Score

24

—

LowBetter than 32% of packages

Maintenance48

Moderate activity, may be stable

Popularity4

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity34

Early-stage or recently created project

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Unknown

Total

1

Last Release

603d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/fef1cea3ff1614a44fc4060212c8e03e14511610ae5482351a80a3b9f6d28e97?d=identicon)[chinahehex](/maintainers/chinahehex)

---

Top Contributors

[![139hehe](https://avatars.githubusercontent.com/u/42648391?v=4)](https://github.com/139hehe "139hehe (7 commits)")

### Embed Badge

![Health badge](/badges/hehex-hehep-hpage/health.svg)

```
[![Health](https://phpackages.com/badges/hehex-hehep-hpage/health.svg)](https://phpackages.com/packages/hehex-hehep-hpage)
```

###  Alternatives

[symfony/polyfill-uuid

Symfony polyfill for uuid functions

688335.4M63](/packages/symfony-polyfill-uuid)[spatie/error-solutions

This is my package error-solutions

6853.2M11](/packages/spatie-error-solutions)[phpflo/phpflo

Flow-based programming for PHP

2173.3k4](/packages/phpflo-phpflo)[eftec/autoloadone

AutoloadOne is a program that generates an autoload class for PHP.

403.4k](/packages/eftec-autoloadone)[ys-tools/default-theme-configuration-bundle

OroCommerce Default Theme Configuration Bundle

124.2k](/packages/ys-tools-default-theme-configuration-bundle)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)