PHPackages                             dotzero/ypaginator - 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. dotzero/ypaginator

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

dotzero/ypaginator
==================

A lightweight PHP paginator without a database dependency, for generating pagination controls in the style of Yandex

0.7(10y ago)4892MITPHPPHP >=5.3.0

Since Apr 13Pushed 8y ago1 watchersCompare

[ Source](https://github.com/zero-archive/ypaginator-php)[ Packagist](https://packagist.org/packages/dotzero/ypaginator)[ RSS](/packages/dotzero-ypaginator/feed)WikiDiscussions master Synced 2mo ago

READMEChangelogDependencies (1)Versions (2)Used By (0)

PHP YPaginator
==============

[](#php-ypaginator)

[![Build Status](https://camo.githubusercontent.com/413ce6dbc0ceb6f991e217b035ecfc0418f7043ff8dfade03c7bb422f4ce1e4f/68747470733a2f2f7472617669732d63692e6f72672f646f747a65726f2f79706167696e61746f722d7068702e7376673f6272616e63683d6d6173746572)](https://travis-ci.org/dotzero/ypaginator-php)[![Latest Stable Version](https://camo.githubusercontent.com/d499d8830bb36cb03d885bae651fd00722e63901fa6a13460ca1fb94850feac3/68747470733a2f2f706f7365722e707567782e6f72672f646f747a65726f2f79706167696e61746f722f76657273696f6e)](https://packagist.org/packages/dotzero/ypaginator)[![License](https://camo.githubusercontent.com/ba3106e807e293124df48ed6136f8aef27631c3762d88158ae2e1e2439f8e148/68747470733a2f2f706f7365722e707567782e6f72672f646f747a65726f2f79706167696e61746f722f6c6963656e7365)](https://packagist.org/packages/dotzero/ypaginator)

A lightweight PHP paginator without a database dependency, for generating pagination controls in the style of Yandex.

Features
--------

[](#features)

- The `first` and `last` page links are shown
- The `current` and `neighbours` page links are shown
- Rest of links are replaced by ellipses

How it looks like:
------------------

[](#how-it-looks-like)

```
>
|1| ... |5||6||7| ... |100|

```

Usage
-----

[](#usage)

```
$total = 100; // Total items
$perpage = 10; // Items per page
$current = 5; // Current page
$neighbours = 2; // Neighbours links beside current page

$y = new \dotzero\YPaginator($total, $perpage, $current);

$paginator = $y
    ->setNeighbours($neighbours)
    ->setUrlMask('#num#')
    ->setUrlTemplate('/foo/page/#num#')
    ->getPaginator();

print_r($paginator);
```

Output looks like:

```
[
    "prev" => ["name" => 4,"url" => "/foo/page/4","current" => false], // Previous
    "pages" => [
        ["name" => 1,"url" => "/foo/page/1","current" => false], // First
        ["name" => "...","url" => "/foo/page/2","current" => false],
        ["name" => 3,"url" => "/foo/page/3","current" => false], // Neighbour
        ["name" => 4,"url" => "/foo/page/4","current" => false], // Neighbour
        ["name" => 5,"url" => "/foo/page/5","current" => true],  // Current
        ["name" => 6,"url" => "/foo/page/6","current" => false], // Neighbour
        ["name" => 7,"url" => "/foo/page/7","current" => false], // Neighbour
        ["name" => "...","url" => "/foo/page/8","current" => false],
        ["name" => 10,"url" => "/foo/page/10","current" => false] // Last
    ],
    "next" => ["name" => 6,"url" => "/foo/page/6","current" => false] // Next
];
```

Install
-------

[](#install)

### Via composer:

[](#via-composer)

```
$ composer require dotzero/ypaginator
```

### Without composer

[](#without-composer)

Clone the project using:

```
$ git clone https://github.com/dotzero/ypaginator-php
```

and include the source files with:

```
require_once("ypaginator-php/src/YPaginator.php");
```

Test
----

[](#test)

First install the dependencies, and after you can run:

```
$ vendor/bin/phpunit
```

License
-------

[](#license)

Licensed under the MIT license:

###  Health Score

26

—

LowBetter than 43% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity15

Limited adoption so far

Community11

Small or concentrated contributor base

Maturity48

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 93.3% 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

3683d ago

### Community

Maintainers

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

---

Top Contributors

[![dotzero](https://avatars.githubusercontent.com/u/265633?v=4)](https://github.com/dotzero "dotzero (14 commits)")[![Rpsl](https://avatars.githubusercontent.com/u/265634?v=4)](https://github.com/Rpsl "Rpsl (1 commits)")

---

Tags

pagerpaginationpaginatorphppagerpaginatorpagination

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/dotzero-ypaginator/health.svg)

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

###  Alternatives

[knplabs/knp-components

Knplabs component library

77343.6M46](/packages/knplabs-knp-components)[aplus/pagination

Aplus Framework Pagination Library

2091.6M3](/packages/aplus-pagination)[kop/yii2-scroll-pager

Infinite AJAX scrolling for Yii2 ListView widget

180706.5k10](/packages/kop-yii2-scroll-pager)[coffeecode/paginator

Paginator is simple and is ready to generate results navigation in your application

59658.1k1](/packages/coffeecode-paginator)[beberlei/porpaginas

Library that generically solves several pagination issues with DAO/repository abstractions.

163612.6k11](/packages/beberlei-porpaginas)[ashleydawson/simple-pagination

Simple, lightweight and universal service that implements pagination on collections of things

18161.2k2](/packages/ashleydawson-simple-pagination)

PHPackages © 2026

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