silarhi / cursor-pagination

2.1.0 2026-01-29 11:43 UTC

Requires

• php: >=8.2
• doctrine/orm: ^3.0

Requires (Dev)

• doctrine/data-fixtures: ^2.0
• friendsofphp/php-cs-fixer: ^3.93
• phpstan/phpstan: ^2
• phpunit/phpunit: ^10.5.20|^11.1.3|^12
• rector/rector: ^2
• symfony/cache: ^7.0|^8.0
• vimeo/psalm: ^5.26|^6

MIT

• SILARHI

• orm
• pagination
• doctrine
• cursor
• cursor-pagination

Published on Packagist.org on 2026-01-29 11:43 UTC

README

Installation

composer require silarhi/cursor-pagination

Usage

use Silarhi\CursorPagination\Pagination\CursorPagination;

$queryBuilder = $entityManager
    ->createQueryBuilder('u')
    ->from(User::class, 'u')
    ->where('u.enabled = true');

$configurations = new OrderConfigurations(
    new OrderConfiguration('u.createdAt', static fn (User $user): string => $user->getCreatedAt()),
    new OrderConfiguration('u.id', static fn (User $user): int => $user->getId()),
);

/** @var CursorPagination<User> $pagination */
$pagination = new CursorPagination($queryBuilder, $configurations, 100);

// Method 1: get results as chunk (recommended)
foreach($pagination->getChunkResults() as $results) {
    foreach($results as $user) {
         $user->setEnabled(false);
    }

    $entityManager->flush();
    $entityManager->clear();
}

// Method 2: get single result as iterator
foreach($pagination->getResults() as $user) {
    // do something with user
}

``