PaginatorTrait::links() - Code Metrics - softberg/quantum-php-core - Measure and Improve Code Quality continuously with Scrutinizer

PaginatorTrait::links() A
last analyzed 2025-10-31 10:07 UTC

↳ Parent: PaginatorTrait

Complexity

Conditions	2
Paths	2

Size

Total Lines	9
Code Lines	4

Duplication

Lines	0
Ratio	0 %

Importance

Changes	1
Bugs	0	Features	0

Metric	Value
cc	2
eloc	4
c	1
b	0
f	0
nc	2
nop	1
dl	0
loc	9
rs	10

<?php

/**
 * Quantum PHP Framework
 *
 * An open source software development framework for PHP
 *
 * @package Quantum
 * @author Arman Ag. <[email protected]>
 * @copyright Copyright (c) 2018 Softberg LLC (https://softberg.org)
 * @link http://quantum.softberg.org/
 * @since 2.9.7
 */

namespace Quantum\Paginator\Traits;

use Quantum\Paginator\Constants\Pagination;

/**
 * Trait PaginatorTrait
 * @package Quantum\Paginator
 */
trait PaginatorTrait
{

    /**
     * @var string
     */
    protected $baseUrl;

    /**
     * @var int
     */
    protected $total;

    /**
     * @var int
     */
    protected $perPage;

    /**
     * @var int
     */
    protected $page;

    /**
     * @param int $perPage
     * @param int $page
     */
    protected function initialize(int $perPage, int $page = 1): void
    {
        $this->baseUrl = base_url();
        $this->perPage = $perPage;
        $this->page = $page;
    }

    /**
     * Get total number of items
     * @return int
     */
    public function total(): int
    {
        return $this->total;
    }

    /**
     * Get current page number
     * @return int
     */
    public function currentPageNumber(): int
    {
        return $this->page;
    }

    /**
     * Get previous page number
     * @return int|null
     */
    public function previousPageNumber(): ?int
    {
        if ($this->page > 1) {
            return $this->page - 1;
        }

        if ($this->page == 1) {
            return $this->page;
        }

        return null;
    }

    /**
     * Get next page number
     * @return int|null
     */
    public function nextPageNumber(): ?int
    {
        if ($this->page < $this->lastPageNumber()) {
            return $this->page + 1;
        }

        if ($this->page == $this->lastPageNumber()) {
            return $this->page;
        }

        return null;
    }

    /**
     * Get last page number
     * @return int
     */
    public function lastPageNumber(): int
    {
        return (int)ceil($this->total() / $this->perPage);
    }

    /**
     * Get current page link
     * @param bool $withBaseUrl
     * @return string|null
     */
    public function currentPageLink(bool $withBaseUrl = false): ?string
    {
        return $this->getPageLink($this->page, $withBaseUrl);
    }

    /**
     * Get first page link
     * @param bool $withBaseUrl
     * @return string|null
     */
    public function firstPageLink(bool $withBaseUrl = false): ?string
    {
        return $this->getPageLink(Pagination::FIRST_PAGE_NUMBER, $withBaseUrl);
    }

    /**
     * Get previous page link
     * @param bool $withBaseUrl
     * @return string|null
     */
    public function previousPageLink(bool $withBaseUrl = false): ?string
    {
        return $this->getPageLink($this->previousPageNumber(), $withBaseUrl);
    }

    /**
     * Get next page link
     * @param bool $withBaseUrl
     * @return string|null
     */
    public function nextPageLink(bool $withBaseUrl = false): ?string
    {
        return $this->getPageLink($this->nextPageNumber(), $withBaseUrl);
    }

    /**
     * Get last page link
     * @param bool $withBaseUrl
     * @return string|null
     */
    public function lastPageLink(bool $withBaseUrl = false): ?string
    {
        return $this->getPageLink($this->lastPageNumber(), $withBaseUrl);
    }

    /**
     * Get items per page
     * @return int
     */
    public function perPage(): int
    {
        return $this->perPage;
    }

    /**
     * Get all page links
     * @param bool $withBaseUrl
     * @return array
     */
    public function links(bool $withBaseUrl = false): array
    {
        $links = [];

        for ($i = 1; $i <= $this->lastPageNumber(); $i++) {
            $links[] = $this->getPageLink($i, $withBaseUrl);
        }

        return $links;
    }

    /**
     * Get pagination HTML
     * @param bool $withBaseUrl
     * @param int|null $pageItemsCount
     * @return string|null
     */
    public function getPagination(bool $withBaseUrl = false, ?int $pageItemsCount = null): ?string
    {
        $totalPages = $this->lastPageNumber();
        $currentPage = $this->currentPageNumber();

        if ($totalPages <= 1) {
            return null;
        }

        $pageItemsCount = max(Pagination::MINIMUM_PAGE_ITEMS_COUNT, $pageItemsCount ?? Pagination::MINIMUM_PAGE_ITEMS_COUNT);

        $pagination = ['<ul class="' . Pagination::PAGINATION_CLASS . '">'];

        if ($currentPage > 1) {
            $pagination[] = $this->getPreviousPageItem($this->previousPageLink());
        }

        if ($pageItemsCount) {
            $links = $this->links($withBaseUrl);

            list($startPage, $endPage) = $this->calculateStartEndPages($currentPage, $totalPages, $pageItemsCount);

            $pagination[] = $this->addFirstPageLink($startPage);
            $pagination[] = $this->getItemsLinks($startPage, $endPage, $currentPage, $links);
            $pagination[] = $this->addLastPageLink($endPage, $totalPages, $links);
        }

        if ($currentPage < $totalPages) {
            $pagination[] = $this->getNextPageItem($this->nextPageLink());
        }

        $pagination[] = '</ul>';

        return implode('', $pagination);
    }

    /**
     * Get the URI for pagination
     * @param bool $withBaseUrl
     * @return string
     */
    protected function getUri(bool $withBaseUrl = false): string
    {
        $routeUrl = preg_replace('/([?&](page|per_page)=\d+)/', '', route_uri());
        $routeUrl = preg_replace('/&/', '?', $routeUrl, 1);
        $url = $routeUrl;

        if ($withBaseUrl) {
            $url = $this->baseUrl . $routeUrl;
        }

        $delimiter = strpos($url, '?') ? '&' : '?';

        return $url . $delimiter;
    }

    /**
     * Get page link
     * @param int|null $pageNumber
     * @param bool $withBaseUrl
     * @return string|null
     */
    protected function getPageLink(?int $pageNumber, bool $withBaseUrl = false): ?string
    {
        if (!empty($pageNumber)) {
            return $this->getUri($withBaseUrl) . Pagination::PER_PAGE . '=' . $this->perPage . '&' . Pagination::PAGE . '=' . $pageNumber;
        }

        return null;
    }

    /**
     * Get next page item HTML
     * @param string|null $nextPageLink
     * @return string
     */
    protected function getNextPageItem(?string $nextPageLink): string
    {
        $link = '';

        if (!empty($nextPageLink)) {
            $link = '<li><a href="' . $nextPageLink . '">' . t('common.pagination.next') . '</a></li>';
        }

        return $link;
    }

    /**
     * Get previous page item HTML
     * @param string|null $previousPageLink
     * @return string
     */
    protected function getPreviousPageItem(?string $previousPageLink): string
    {
        $link = '';

        if (!empty($previousPageLink)) {
            $link = '<li><a href="' . $previousPageLink . '">' . t('common.pagination.prev') . '</a></li>';
        }

        return $link;
    }

    /**
     * Get items links HTML
     * @param int $startPage
     * @param int $endPage
     * @param int $currentPage
     * @param array $links
     * @return string
     */
    protected function getItemsLinks(int $startPage, int $endPage, int $currentPage, array $links): string
    {
        $pagination = '';

        for ($i = $startPage; $i <= $endPage; $i++) {
            $active = $i == $currentPage ? 'class="' . Pagination::PAGINATION_CLASS_ACTIVE . '"' : '';
            $pagination .= '<li ' . $active . '><a href="' . $links[$i - 1] . '">' . $i . '</a></li>';
        }

        return $pagination;
    }

    /**
     * Calculate start and end pages
     * @param int $currentPage
     * @param int $totalPages
     * @param int $pageItemsCount
     * @return array
     */
    protected function calculateStartEndPages(int $currentPage, int $totalPages, int $pageItemsCount): array
    {
        $startPage = max(1, $currentPage - ceil(($pageItemsCount - Pagination::EDGE_PADDING) / 2));
        $endPage = min($totalPages, $startPage + $pageItemsCount - Pagination::EDGE_PADDING);

        return [$startPage, $endPage];
    }

    /**
     * Add first page link HTML
     * @param int $startPage
     * @return string
     */
    protected function addFirstPageLink(int $startPage): string
    {
        $pagination = '';

        if ($startPage > 1) {
            $pagination .= '<li><a href="' . $this->firstPageLink() . '">' . Pagination::FIRST_PAGE_NUMBER . '</a></li>';
            if ($startPage > 2) {
                $pagination .= '<li><span>...</span></li>';
            }
        }

        return $pagination;
    }

    /**
     * Add last page link HTML
     * @param int $endPage
     * @param int $totalPages
     * @param array $links
     * @return string
     */
    protected function addLastPageLink(int $endPage, int $totalPages, array $links): string
    {
        $pagination = '';

        if ($endPage < $totalPages) {
            if ($endPage < $totalPages - 1) {
                $pagination .= '<li><span>...</span></li>';
            }
            $pagination .= '<li><a href="' . $links[$totalPages - 1] . '">' . $totalPages . '</a></li>';
        }

        return $pagination;
    }
} 

1			<?php
2
3			/**
4			* Quantum PHP Framework
5			*
6			* An open source software development framework for PHP
7			*
8			* @package Quantum
9			* @author Arman Ag. <[email protected]>
10			* @copyright Copyright (c) 2018 Softberg LLC (https://softberg.org)
11			* @link http://quantum.softberg.org/
12			* @since 2.9.7
13			*/
14
15			namespace Quantum\Paginator\Traits;
16
17			use Quantum\Paginator\Constants\Pagination;
18
19			/**
20			* Trait PaginatorTrait
21			* @package Quantum\Paginator
22			*/
23			trait PaginatorTrait
24			{
25
26			/**
27			* @var string
28			*/
29			protected $baseUrl;
30
31			/**
32			* @var int
33			*/
34			protected $total;
35
36			/**
37			* @var int
38			*/
39			protected $perPage;
40
41			/**
42			* @var int
43			*/
44			protected $page;
45
46			/**
47			* @param int $perPage
48			* @param int $page
49			*/
50			protected function initialize(int $perPage, int $page = 1): void
51			{
52			$this->baseUrl = base_url();
53			$this->perPage = $perPage;
54			$this->page = $page;
55			}
56
57			/**
58			* Get total number of items
59			* @return int
60			*/
61			public function total(): int
62			{
63			return $this->total;
64			}
65
66			/**
67			* Get current page number
68			* @return int
69			*/
70			public function currentPageNumber(): int
71			{
72			return $this->page;
73			}
74
75			/**
76			* Get previous page number
77			* @return int\|null
78			*/
79			public function previousPageNumber(): ?int
80			{
81			if ($this->page > 1) {
82			return $this->page - 1;
83			}
84
85			if ($this->page == 1) {
86			return $this->page;
87			}
88
89			return null;
90			}
91
92			/**
93			* Get next page number
94			* @return int\|null
95			*/
96			public function nextPageNumber(): ?int
97			{
98			if ($this->page < $this->lastPageNumber()) {
99			return $this->page + 1;
100			}
101
102			if ($this->page == $this->lastPageNumber()) {
103			return $this->page;
104			}
105
106			return null;
107			}
108
109			/**
110			* Get last page number
111			* @return int
112			*/
113			public function lastPageNumber(): int
114			{
115			return (int)ceil($this->total() / $this->perPage);
116			}
117
118			/**
119			* Get current page link
120			* @param bool $withBaseUrl
121			* @return string\|null
122			*/
123			public function currentPageLink(bool $withBaseUrl = false): ?string
124			{
125			return $this->getPageLink($this->page, $withBaseUrl);
126			}
127
128			/**
129			* Get first page link
130			* @param bool $withBaseUrl
131			* @return string\|null
132			*/
133			public function firstPageLink(bool $withBaseUrl = false): ?string
134			{
135			return $this->getPageLink(Pagination::FIRST_PAGE_NUMBER, $withBaseUrl);
136			}
137
138			/**
139			* Get previous page link
140			* @param bool $withBaseUrl
141			* @return string\|null
142			*/
143			public function previousPageLink(bool $withBaseUrl = false): ?string
144			{
145			return $this->getPageLink($this->previousPageNumber(), $withBaseUrl);
146			}
147
148			/**
149			* Get next page link
150			* @param bool $withBaseUrl
151			* @return string\|null
152			*/
153			public function nextPageLink(bool $withBaseUrl = false): ?string
154			{
155			return $this->getPageLink($this->nextPageNumber(), $withBaseUrl);
156			}
157
158			/**
159			* Get last page link
160			* @param bool $withBaseUrl
161			* @return string\|null
162			*/
163			public function lastPageLink(bool $withBaseUrl = false): ?string
164			{
165			return $this->getPageLink($this->lastPageNumber(), $withBaseUrl);
166			}
167
168			/**
169			* Get items per page
170			* @return int
171			*/
172			public function perPage(): int
173			{
174			return $this->perPage;
175			}
176
177			/**
178			* Get all page links
179			* @param bool $withBaseUrl
180			* @return array
181			*/
182			public function links(bool $withBaseUrl = false): array
183			{
184			$links = [];
185
186			for ($i = 1; $i <= $this->lastPageNumber(); $i++) {
187			$links[] = $this->getPageLink($i, $withBaseUrl);
188			}
189
190			return $links;
191			}
192
193			/**
194			* Get pagination HTML
195			* @param bool $withBaseUrl
196			* @param int\|null $pageItemsCount
197			* @return string\|null
198			*/
199			public function getPagination(bool $withBaseUrl = false, ?int $pageItemsCount = null): ?string
200			{
201			$totalPages = $this->lastPageNumber();
202			$currentPage = $this->currentPageNumber();
203
204			if ($totalPages <= 1) {
205			return null;
206			}
207
208			$pageItemsCount = max(Pagination::MINIMUM_PAGE_ITEMS_COUNT, $pageItemsCount ?? Pagination::MINIMUM_PAGE_ITEMS_COUNT);
209
210			$pagination = ['<ul class="' . Pagination::PAGINATION_CLASS . '">'];
211
212			if ($currentPage > 1) {
213			$pagination[] = $this->getPreviousPageItem($this->previousPageLink());
214			}
215
216			if ($pageItemsCount) {
217			$links = $this->links($withBaseUrl);
218
219			list($startPage, $endPage) = $this->calculateStartEndPages($currentPage, $totalPages, $pageItemsCount);
220
221			$pagination[] = $this->addFirstPageLink($startPage);
222			$pagination[] = $this->getItemsLinks($startPage, $endPage, $currentPage, $links);
223			$pagination[] = $this->addLastPageLink($endPage, $totalPages, $links);
224			}
225
226			if ($currentPage < $totalPages) {
227			$pagination[] = $this->getNextPageItem($this->nextPageLink());
228			}
229
230			$pagination[] = '</ul>';
231
232			return implode('', $pagination);
233			}
234
235			/**
236			* Get the URI for pagination
237			* @param bool $withBaseUrl
238			* @return string
239			*/
240			protected function getUri(bool $withBaseUrl = false): string
241			{
242			$routeUrl = preg_replace('/([?&](page\|per_page)=\d+)/', '', route_uri());
243			$routeUrl = preg_replace('/&/', '?', $routeUrl, 1);
244			$url = $routeUrl;
245
246			if ($withBaseUrl) {
247			$url = $this->baseUrl . $routeUrl;
248			}
249
250			$delimiter = strpos($url, '?') ? '&' : '?';
251
252			return $url . $delimiter;
253			}
254
255			/**
256			* Get page link
257			* @param int\|null $pageNumber
258			* @param bool $withBaseUrl
259			* @return string\|null
260			*/
261			protected function getPageLink(?int $pageNumber, bool $withBaseUrl = false): ?string
262			{
263			if (!empty($pageNumber)) {
264			return $this->getUri($withBaseUrl) . Pagination::PER_PAGE . '=' . $this->perPage . '&' . Pagination::PAGE . '=' . $pageNumber;
265			}
266
267			return null;
268			}
269
270			/**
271			* Get next page item HTML
272			* @param string\|null $nextPageLink
273			* @return string
274			*/
275			protected function getNextPageItem(?string $nextPageLink): string
276			{
277			$link = '';
278
279			if (!empty($nextPageLink)) {
280			$link = '<li><a href="' . $nextPageLink . '">' . t('common.pagination.next') . '</a></li>';
281			}
282
283			return $link;
284			}
285
286			/**
287			* Get previous page item HTML
288			* @param string\|null $previousPageLink
289			* @return string
290			*/
291			protected function getPreviousPageItem(?string $previousPageLink): string
292			{
293			$link = '';
294
295			if (!empty($previousPageLink)) {
296			$link = '<li><a href="' . $previousPageLink . '">' . t('common.pagination.prev') . '</a></li>';
297			}
298
299			return $link;
300			}
301
302			/**
303			* Get items links HTML
304			* @param int $startPage
305			* @param int $endPage
306			* @param int $currentPage
307			* @param array $links
308			* @return string
309			*/
310			protected function getItemsLinks(int $startPage, int $endPage, int $currentPage, array $links): string
311			{
312			$pagination = '';
313
314			for ($i = $startPage; $i <= $endPage; $i++) {
315			$active = $i == $currentPage ? 'class="' . Pagination::PAGINATION_CLASS_ACTIVE . '"' : '';
316			$pagination .= '<li ' . $active . '><a href="' . $links[$i - 1] . '">' . $i . '</a></li>';
317			}
318
319			return $pagination;
320			}
321
322			/**
323			* Calculate start and end pages
324			* @param int $currentPage
325			* @param int $totalPages
326			* @param int $pageItemsCount
327			* @return array
328			*/
329			protected function calculateStartEndPages(int $currentPage, int $totalPages, int $pageItemsCount): array
330			{
331			$startPage = max(1, $currentPage - ceil(($pageItemsCount - Pagination::EDGE_PADDING) / 2));
332			$endPage = min($totalPages, $startPage + $pageItemsCount - Pagination::EDGE_PADDING);
333
334			return [$startPage, $endPage];
335			}
336
337			/**
338			* Add first page link HTML
339			* @param int $startPage
340			* @return string
341			*/
342			protected function addFirstPageLink(int $startPage): string
343			{
344			$pagination = '';
345
346			if ($startPage > 1) {
347			$pagination .= '<li><a href="' . $this->firstPageLink() . '">' . Pagination::FIRST_PAGE_NUMBER . '</a></li>';
348			if ($startPage > 2) {
349			$pagination .= '<li><span>...</span></li>';
350			}
351			}
352
353			return $pagination;
354			}
355
356			/**
357			* Add last page link HTML
358			* @param int $endPage
359			* @param int $totalPages
360			* @param array $links
361			* @return string
362			*/
363			protected function addLastPageLink(int $endPage, int $totalPages, array $links): string
364			{
365			$pagination = '';
366
367			if ($endPage < $totalPages) {
368			if ($endPage < $totalPages - 1) {
369			$pagination .= '<li><span>...</span></li>';
370			}
371			$pagination .= '<li><a href="' . $links[$totalPages - 1] . '">' . $totalPages . '</a></li>';
372			}
373
374			return $pagination;
375			}
376			}

softberg / quantum-php-core

PaginatorTrait::links() A last analyzed 2025-10-31 10:07 UTC

Complexity

Size

Duplication

Importance

Duplication Side-by-Side

Filter issues like

PaginatorTrait::links() A
last analyzed 2025-10-31 10:07 UTC