PHPackages                             ecommit/paginator - 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. ecommit/paginator

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

ecommit/paginator
=================

Create a paginator.

v1.4.1(1mo ago)019.9k↓13.3%11MITPHPPHP ^8.1CI passing

Since May 27Pushed 4w ago1 watchersCompare

[ Source](https://github.com/e-commit/paginator)[ Packagist](https://packagist.org/packages/ecommit/paginator)[ RSS](/packages/ecommit-paginator/feed)WikiDiscussions master Synced yesterday

READMEChangelogDependencies (10)Versions (8)Used By (1)

Paginator
=========

[](#paginator)

Create a paginator.

[![Tests](https://github.com/e-commit/paginator/workflows/Tests/badge.svg)](https://github.com/e-commit/paginator/workflows/Tests/badge.svg)

Installation
------------

[](#installation)

To install paginator with Composer just run :

```
$ composer require ecommit/paginator
```

Usage
-----

[](#usage)

```
use Ecommit\Paginator\ArrayPaginator;

//Create a paginator
$paginator = new ArrayPaginator([
    //Options
    'page' => 1,
    'max_per_page' => 100,
    'data' => ['val1', 'val2', 'val3'],
    //Or with an ArrayIterator
    //'data' => new \ArrayIterator(['val1', 'val2', 'val3']),
]);

$totalPages = $paginator->getLastPage();
$countRows = \count($paginator);
foreach ($paginator as $result) {
    //...
}
```

### Available options

[](#available-options)

OptionTypeRequiredDefault valueDescription**page**IntegerNo1Current page**max\_per\_page**IntegerNo100Max elements per page**data**Array or ArrayIteratorYes- If `count` option is null : All data (of all pages)
- If `count` option is not null : Only the data to display on the current page

**count**Integer or nullNoNull*You can use this option when the data volume is too large.* If the value is not null :- It must equal the total number of results
- The `data` option must contain only the data to display on the current page

### Available methods

[](#available-methods)

See [API documentation](src/PaginatorInterface.php)

License
-------

[](#license)

This librairy is under the MIT license. See the complete license in *LICENSE* file.

###  Health Score

52

—

FairBetter than 96% of packages

Maintenance94

Actively maintained with recent releases

Popularity27

Limited adoption so far

Community10

Small or concentrated contributor base

Maturity62

Established project with proven stability

 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

Every ~244 days

Recently: every ~223 days

Total

7

Last Release

30d ago

PHP version history (2 changes)v1.0.0PHP ^8.0

v1.2.0PHP ^8.1

### Community

Maintainers

![](https://www.gravatar.com/avatar/73191162d97fffaa1a23d23326a7a77fbaa94ce41e49cf4ee6cbf0b9c9800c80?d=identicon)[e-commit](/maintainers/e-commit)

---

Top Contributors

[![hlecorche](https://avatars.githubusercontent.com/u/188749?v=4)](https://github.com/hlecorche "hlecorche (67 commits)")

---

Tags

arraypaginator

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan

Code StylePHP CS Fixer

Type Coverage Yes

### Embed Badge

![Health badge](/badges/ecommit-paginator/health.svg)

```
[![Health](https://phpackages.com/badges/ecommit-paginator/health.svg)](https://phpackages.com/packages/ecommit-paginator)
```

###  Alternatives

[friendsofphp/php-cs-fixer

A tool to automatically fix PHP code style

13.5k251.2M25.2k](/packages/friendsofphp-php-cs-fixer)[nette/utils

🛠 Nette Utils: lightweight utilities for string & array manipulation, image handling, safe JSON encoding/decoding, validation, slug or strong password generating etc.

2.1k430.4M1.7k](/packages/nette-utils)[symfony/rate-limiter

Provides a Token Bucket implementation to rate limit input and output in your application

27054.3M290](/packages/symfony-rate-limiter)[symfony/ldap

Provides a LDAP client for PHP on top of PHP's ldap extension

1408.1M59](/packages/symfony-ldap)[symfony/ux-cropperjs

Cropper.js integration for Symfony

19346.6k3](/packages/symfony-ux-cropperjs)[symfony/ux-toggle-password

Toggle visibility of password inputs for Symfony Forms

27600.4k5](/packages/symfony-ux-toggle-password)

PHPackages © 2026

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