[2.1.x] Added new feature for pagination and also optional sets the aliases

[KorsaR-ZN]

Maintain compatibility with version 2.0.x
see #10957

$repository = new \Phalcon\Paginator\Repository();
$repository->setAliases(array(
    'myFirstPage' => $repository::PROPERTY_FIRST_PAGE,
    'myLastPage' => $repository::PROPERTY_LAST_PAGE,
    'myCurrentPage' => $repository::PROPERTY_CURRENT_PAGE
));

$paginator = new \Phalcon\Paginator\Adapter\NativeArray(array(
    'data' => array_fill(0, 30, 'banana'),
    'limit'=> 25,
    'page' => 1,
    'repository' => $repository
));

$page = $paginator->getPaginate();

// First page
echo $page->first . PHP_EOL; // compatibility with version 2.0.x
echo $page->getFirstPage() . PHP_EOL; // Getter
echo $page->firstPage . PHP_EOL; // Magic getter
echo $page->myFirstPage . PHP_EOL; // Alias

// Current page
echo $page->current . PHP_EOL; // compatibility with version 2.0.x
echo $page->getCurrentPage() . PHP_EOL; // Getter
echo $page->currentPage . PHP_EOL; // Magic getter
echo $page->myCurrentPage . PHP_EOL; // Alias

// Last page
echo $page->last . PHP_EOL; // compatibility with version 2.0.x
echo $page->getLastPage() . PHP_EOL; // Getter
echo $page->lastPage . PHP_EOL; // Magic getter
echo $page->myLastPage . PHP_EOL; // Alias

[andresgutierrez]

Why introduce a new class?

[KorsaR-ZN]

@andresgutierrez This can be useful for the type-hinting:
In order not to transmit the paginator fully in function, but only a concrete state

function renderPage(\Phalcon\Paginator\RepositoryInterface $page) 
{
    //...expr...
}

//...expr...

$page = $paginator->getPaginate();
$pageRendred = renderPage($page);

//...expr...

or eg for serialization concrete page to transfer anywhere

[sergeyklay]

@KorsaR-ZN The 2.1.x branch is best place for this

[Green-Cat]

This is already targeting 2.1.x. It does need to be rebased though.

[sergeyklay]

Oh, yes. Could you please rebase?

[sergeyklay]

ping @KorsaR-ZN

[niden]

@KorsaR-ZN @CameronHall Thank you both. This has been addressed/cherry-picked in

#13653