Paginator::addGetParams() - Code Metrics - Inspection of "Adicionando parâmetros get ao passar um array com..." - robsonvleite/paginator - Measure and Improve Code Quality continuously with Scrutinizer

Passed

Pull Request — master (#5)

unknown

created 2020-10-09 20:16 UTC

Paginator::addGetParams() A

↳ Parent: Paginator

Complexity

Conditions	3
Paths	3

Size

Total Lines	15
Code Lines	7

Duplication

Lines	0
Ratio	0 %

Importance

Changes	2
Bugs	0	Features	0

Metric	Value
cc	3
eloc	7
c	2
b	0
f	0
nc	3
nop	1
dl	0
loc	15
rs	10

<?php

namespace CoffeeCode\Paginator;

/**
 * Class CoffeeCode Paginator
 *
 * @author Robson V. Leite <https://github.com/robsonvleite>
 * @package CoffeeCode\Paginator
 */
class Paginator
{
    /** @var int */
    private $page;

    /** @var int */
    private $pages;

    /** @var int */
    private $rows;

    /** @var int */
    private $limit;

    /** @var int */
    private $offset;

    /** @var int */
    private $range;

    /** @var string */
    private $link;

    /** @var string */
    private $title;

    /** @var string */
    private $class;

    /** @var string */
    private $hash;

    /** @var array */
    private $first;

    /** @var array */
    private $last;

    /** @var string */
    private $params;
	
    /**
     * Paginator constructor.
     * @param string|null $link
     * @param string|null $title
     * @param array|null $first
     * @param array|null $last
     */
    public function __construct(string $link = null, string $title = null, array $first = null, array $last = null)
    {
        $this->link = ($link ?? "?page=");
        $this->title = ($title ?? "Página");
        $this->first = ($first ?? ["Primeira página", "<<"]);
        $this->last = ($last ?? ["Última página", ">>"]);
    }

    /**
     * @param int $rows
     * @param int $limit
     * @param int|null $page
     * @param int $range
     * @param string|null $hash
     */
    public function pager(int $rows, int $limit = 10, int $page = null, int $range = 3, string $hash = null, array $params = []): void
    {
        $this->rows = $this->toPositive($rows);
        $this->limit = $this->toPositive($limit);
        $this->range = $this->toPositive($range);
        $this->pages = (int)ceil($this->rows / $this->limit);
        $this->page = ($page <= $this->pages ? $this->toPositive($page) : $this->pages);

        $this->offset = (($this->page * $this->limit) - $this->limit >= 0 ? ($this->page * $this->limit) - $this->limit : 0);
        $this->hash = (!empty($hash) ? "#{$hash}" : null);
		
		$this->addGetParams($params);

        if ($this->rows && $this->offset >= $this->rows) {
            header("Location: {$this->link}" . ceil($this->rows / $this->limit));
            exit;
        }
    }

    /**
     * @return int
     */
    public function limit(): int
    {
        return $this->limit;
    }

    /**
     * @return int
     */
    public function offset(): int
    {
        return $this->offset;
    }

    /**
     * @return int
     */
    public function page()
    {
        return $this->page;
    }

    /**
     * @return int
     */
    public function pages()
    {
        return $this->pages;
    }

    /**
     * @param string $cssClass
     * @param bool $fixedFirstAndLastPage
     * @return null|string
     */
    public function render(string $cssClass = null, bool $fixedFirstAndLastPage = true): ?string
    {
        $this->class = $cssClass ?? "paginator";

        if ($this->rows > $this->limit):
            $paginator = "<nav class=\"{$this->class}\">";
            $paginator .= $this->firstPage($fixedFirstAndLastPage);
            $paginator .= $this->beforePages();
            $paginator .= "<span class=\"{$this->class}_item {$this->class}_active\">{$this->page}</span>";
            $paginator .= $this->afterPages();
            $paginator .= $this->lastPage($fixedFirstAndLastPage);
            $paginator .= "</nav>";
            return $paginator;
        endif;

        return null;
    }

    /**
     * @return null|string
     */
    private function beforePages(): ?string
    {
        $before = null;
        for ($iPag = $this->page - $this->range; $iPag <= $this->page - 1; $iPag++):
            if ($iPag >= 1):
                $before .= "<a class='{$this->class}_item' title=\"{$this->title} {$iPag}\" href=\"{$this->link}{$iPag}{$this->hash}{$this->params}\">{$iPag}</a>";
            endif;
        endfor;

        return $before;
    }

    /**
     * @return string|null
     */
    private function afterPages(): ?string
    {
        $after = null;
        for ($dPag = $this->page + 1; $dPag <= $this->page + $this->range; $dPag++):
            if ($dPag <= $this->pages):
                $after .= "<a class='{$this->class}_item' title=\"{$this->title} {$dPag}\" href=\"{$this->link}{$dPag}{$this->hash}{$this->params}\">{$dPag}</a>";
            endif;
        endfor;

        return $after;
    }

    /**
     * @param bool $fixedFirstAndLastPage
     * @return string|null
     */
    public function firstPage(bool $fixedFirstAndLastPage = true): ?string
    {
        if ($fixedFirstAndLastPage || $this->page != 1) {
            return "<a class='{$this->class}_item' title=\"{$this->first[0]}\" href=\"{$this->link}1{$this->hash}{$this->params}\">{$this->first[1]}</a>";
        }
        return null;
    }

    /**
     * @param bool $fixedFirstAndLastPage
     * @return string|null
     */
    public function lastPage(bool $fixedFirstAndLastPage = true): ?string
    {
        if ($fixedFirstAndLastPage || $this->page != $this->pages) {
            return "<a class='{$this->class}_item' title=\"{$this->last[0]}\" href=\"{$this->link}{$this->pages}{$this->hash}{$this->params}\">{$this->last[1]}</a>";
        }
        return null;
    }

    /**
     * @param $number
     * @return int
     */
    private function toPositive($number): int
    {
        return ($number >= 1 ? $number : 1);
    }
	
    /**
     * Add get parameters
     * @param array $params
     * @return null
     */
    private function addGetParams(array $params)
    {
        $this->params = '';
        
        if (count($params) > 0) {
			
            if (isset($params['page'])) {
                unset($params['page']);
            }
            
            $this->params  = '&';
            $this->params .= http_build_query($params);
        }
        
        return $this;

    }
}

1			<?php
2
3			namespace CoffeeCode\Paginator;
4
5			/**
6			* Class CoffeeCode Paginator
7			*
8			* @author Robson V. Leite <https://github.com/robsonvleite>
9			* @package CoffeeCode\Paginator
10			*/
11			class Paginator
12			{
13			/** @var int */
14			private $page;
15
16			/** @var int */
17			private $pages;
18
19			/** @var int */
20			private $rows;
21
22			/** @var int */
23			private $limit;
24
25			/** @var int */
26			private $offset;
27
28			/** @var int */
29			private $range;
30
31			/** @var string */
32			private $link;
33
34			/** @var string */
35			private $title;
36
37			/** @var string */
38			private $class;
39
40			/** @var string */
41			private $hash;
42
43			/** @var array */
44			private $first;
45
46			/** @var array */
47			private $last;
48
49			/** @var string */
50			private $params;
51
52			/**
53			* Paginator constructor.
54			* @param string\|null $link
55			* @param string\|null $title
56			* @param array\|null $first
57			* @param array\|null $last
58			*/
59			public function __construct(string $link = null, string $title = null, array $first = null, array $last = null)
60			{
61			$this->link = ($link ?? "?page=");
62			$this->title = ($title ?? "Página");
63			$this->first = ($first ?? ["Primeira página", "<<"]);
64			$this->last = ($last ?? ["Última página", ">>"]);
65			}
66
67			/**
68			* @param int $rows
69			* @param int $limit
70			* @param int\|null $page
71			* @param int $range
72			* @param string\|null $hash
73			*/
74			public function pager(int $rows, int $limit = 10, int $page = null, int $range = 3, string $hash = null, array $params = []): void
75			{
76			$this->rows = $this->toPositive($rows);
77			$this->limit = $this->toPositive($limit);
78			$this->range = $this->toPositive($range);
79			$this->pages = (int)ceil($this->rows / $this->limit);
80			$this->page = ($page <= $this->pages ? $this->toPositive($page) : $this->pages);
81
82			$this->offset = (($this->page * $this->limit) - $this->limit >= 0 ? ($this->page * $this->limit) - $this->limit : 0);
83			$this->hash = (!empty($hash) ? "#{$hash}" : null);
84
85			$this->addGetParams($params);
86
87			if ($this->rows && $this->offset >= $this->rows) {
88			header("Location: {$this->link}" . ceil($this->rows / $this->limit));
89			exit;
90			}
91			}
92
93			/**
94			* @return int
95			*/
96			public function limit(): int
97			{
98			return $this->limit;
99			}
100
101			/**
102			* @return int
103			*/
104			public function offset(): int
105			{
106			return $this->offset;
107			}
108
109			/**
110			* @return int
111			*/
112			public function page()
113			{
114			return $this->page;
115			}
116
117			/**
118			* @return int
119			*/
120			public function pages()
121			{
122			return $this->pages;
123			}
124
125			/**
126			* @param string $cssClass
127			* @param bool $fixedFirstAndLastPage
128			* @return null\|string
129			*/
130			public function render(string $cssClass = null, bool $fixedFirstAndLastPage = true): ?string
131			{
132			$this->class = $cssClass ?? "paginator";
133
134			if ($this->rows > $this->limit):
135			$paginator = "<nav class=\"{$this->class}\">";
136			$paginator .= $this->firstPage($fixedFirstAndLastPage);
137			$paginator .= $this->beforePages();
138			$paginator .= "<span class=\"{$this->class}_item {$this->class}_active\">{$this->page}</span>";
139			$paginator .= $this->afterPages();
140			$paginator .= $this->lastPage($fixedFirstAndLastPage);
141			$paginator .= "</nav>";
142			return $paginator;
143			endif;
144
145			return null;
146			}
147
148			/**
149			* @return null\|string
150			*/
151			private function beforePages(): ?string
152			{
153			$before = null;
154			for ($iPag = $this->page - $this->range; $iPag <= $this->page - 1; $iPag++):
155			if ($iPag >= 1):
156			$before .= "<a class='{$this->class}_item' title=\"{$this->title} {$iPag}\" href=\"{$this->link}{$iPag}{$this->hash}{$this->params}\">{$iPag}</a>";
157			endif;
158			endfor;
159
160			return $before;
161			}
162
163			/**
164			* @return string\|null
165			*/
166			private function afterPages(): ?string
167			{
168			$after = null;
169			for ($dPag = $this->page + 1; $dPag <= $this->page + $this->range; $dPag++):
170			if ($dPag <= $this->pages):
171			$after .= "<a class='{$this->class}_item' title=\"{$this->title} {$dPag}\" href=\"{$this->link}{$dPag}{$this->hash}{$this->params}\">{$dPag}</a>";
172			endif;
173			endfor;
174
175			return $after;
176			}
177
178			/**
179			* @param bool $fixedFirstAndLastPage
180			* @return string\|null
181			*/
182			public function firstPage(bool $fixedFirstAndLastPage = true): ?string
183			{
184			if ($fixedFirstAndLastPage \|\| $this->page != 1) {
185			return "<a class='{$this->class}_item' title=\"{$this->first[0]}\" href=\"{$this->link}1{$this->hash}{$this->params}\">{$this->first[1]}</a>";
186			}
187			return null;
188			}
189
190			/**
191			* @param bool $fixedFirstAndLastPage
192			* @return string\|null
193			*/
194			public function lastPage(bool $fixedFirstAndLastPage = true): ?string
195			{
196			if ($fixedFirstAndLastPage \|\| $this->page != $this->pages) {
197			return "<a class='{$this->class}_item' title=\"{$this->last[0]}\" href=\"{$this->link}{$this->pages}{$this->hash}{$this->params}\">{$this->last[1]}</a>";
198			}
199			return null;
200			}
201
202			/**
203			* @param $number
204			* @return int
205			*/
206			private function toPositive($number): int
207			{
208			return ($number >= 1 ? $number : 1);
209			}
210
211			/**
212			* Add get parameters
213			* @param array $params
214			* @return null
215			*/
216			private function addGetParams(array $params)
217			{
218			$this->params = '';
219
220			if (count($params) > 0) {
221
222			if (isset($params['page'])) {
223			unset($params['page']);
224			}
225
226			$this->params = '&';
227			$this->params .= http_build_query($params);
228			}
229
230			return $this;
			0 ignored issues – show Bug Best Practice introduced 2020-10-09 20:18 UTC by Report Bug Copy Issue Report The expression `return $this` returns the type `CoffeeCode\Paginator\Paginator` which is incompatible with the documented return type `null`. Loading history...
231			}
232			}

robsonvleite / paginator

Pull Request — master (#5)

Paginator::addGetParams() A

Complexity

Size

Duplication

Importance

Duplication Side-by-Side

Filter issues like