Add PagerRenderer::getPageCount()

[kenjis]

Description
To generate the same link as the pagination in CI3, #4188 is not enough.
I also need the $pageCount value.
I need $pager->getCurrentPageNumber() < $pager->getPageCount() - $surroundCount.

Example:

/**
 * @var \CodeIgniter\Pager\PagerRenderer $pager
 */

$surroundCount = 2;
$pager->setSurroundCount($surroundCount);
?>

<p class="pagination">
<?php if ($pager->hasPreviousPage()) : ?>
    <?php if ($pager->getPreviousPageNumber() > $surroundCount) : ?>
    <a href="<?= $pager->getFirst() ?>" data-ci-pagination-page="<?= $pager->getFirstPageNumber() ?> rel="start">
    &laquo;<?= lang('Pager.first') ?></a>
    <?php endif ?>

    <a href="<?= $pager->getPreviousPage() ?>" data-ci-pagination-page="<?= $pager->getPreviousPageNumber() ?>" rel="prev">&lt;</a>
<?php endif ?>

<?php foreach ($pager->links() as $link) : ?>
<?php if ($link['active']) : ?>
    <strong><?= $link['title'] ?></strong>
<?php else : ?>
    <a href="<?= $link['uri'] ?>" data-ci-pagination-page="<?= $link['title'] ?>">
        <?= $link['title'] ?>
    </a>
<?php endif ?>
<?php endforeach ?>

<?php if ($pager->hasNextPage()) : ?>
    <a href="<?= $pager->getNextPage() ?>" data-ci-pagination-page="<?= $pager->getNextPageNumber() ?>" rel="next">&gt;</a>

    <?php if ($pager->getCurrentPageNumber() < $pager->getPageCount() - $surroundCount) : ?>
    <a href="<?= $pager->getLast() ?>" data-ci-pagination-page="<?= $pager->getLastPageNumber() ?>">
    <?= lang('Pager.last') ?>&raquo;</a>
    <?php endif ?>
<?php endif ?>
</p>

Checklist:

• Securely signed commits
• Component(s) with PHPdocs
• Unit testing, with >80% coverage
• User guide updated
• Conforms to style guide

[michalsn]

I would rather stick to the Number suffix when we deal with methods that return numbers - simply for consistency.

Also, could we add a mention about all these new getters to the user guide (at the end of the page)? I don't want them to become a secret feature.

[kenjis]

getPageCount() vs getPageCountNumber(), which is better?

[paulbalandan]

getPageCount() vs getPageCountNumber(), which is better?

IMO getPageCount() is better as count already implies integer number.

[michalsn]

Fair enough.

[paulbalandan]

@kenjis I think it's settled. Thanks for this. While you're at it, can you send a separate doc PR for these new getters?

[kenjis]

@paulbalandan Okay, I will.