Current File : /www/varak.net/paste.varak.net-5.6/vendor/laravel/framework/src/Illuminate/Pagination/Paginator.php
<?php namespace Illuminate\Pagination;
use Countable;
use ArrayAccess;
use ArrayIterator;
use IteratorAggregate;
use Illuminate\Support\Collection;
use Illuminate\Support\Contracts\JsonableInterface;
use Illuminate\Support\Contracts\ArrayableInterface;
class Paginator implements ArrayableInterface, ArrayAccess, Countable, IteratorAggregate, JsonableInterface {
/**
* The pagination factory.
*
* @var \Illuminate\Pagination\Factory
*/
protected $factory;
/**
* The items being paginated.
*
* @var array
*/
protected $items;
/**
* The total number of items.
*
* @var int
*/
protected $total;
/**
* Indicates if a pagination doing "quick" pagination has more items.
*
* @var bool
*/
protected $hasMore;
/**
* The amount of items to show per page.
*
* @var int
*/
protected $perPage;
/**
* Get the current page for the request.
*
* @var int
*/
protected $currentPage;
/**
* Get the last available page number.
*
* @return int
*/
protected $lastPage;
/**
* The number of the first item in this range.
*
* @var int
*/
protected $from;
/**
* The number of the last item in this range.
*
* @var int
*/
protected $to;
/**
* All of the additional query string values.
*
* @var array
*/
protected $query = array();
/**
* The fragment to be appended to all URLs.
*
* @var string
*/
protected $fragment;
/**
* Create a new Paginator instance.
*
* @param \Illuminate\Pagination\Factory $factory
* @param array $items
* @param int $total
* @param int|null $perPage
* @return void
*/
public function __construct(Factory $factory, array $items, $total, $perPage = null)
{
$this->factory = $factory;
if (is_null($perPage))
{
$this->perPage = (int) $total;
$this->hasMore = count($items) > $this->perPage;
$this->items = array_slice($items, 0, $this->perPage);
}
else
{
$this->items = $items;
$this->total = (int) $total;
$this->perPage = (int) $perPage;
}
}
/**
* Setup the pagination context (current and last page).
*
* @return $this
*/
public function setupPaginationContext()
{
$this->calculateCurrentAndLastPages();
$this->calculateItemRanges();
return $this;
}
/**
* Calculate the current and last pages for this instance.
*
* @return void
*/
protected function calculateCurrentAndLastPages()
{
if ($this->isQuickPaginating())
{
$this->currentPage = $this->factory->getCurrentPage();
$this->lastPage = $this->hasMore ? $this->currentPage + 1 : $this->currentPage;
}
else
{
$this->lastPage = (int) ceil($this->total / $this->perPage);
$this->currentPage = $this->calculateCurrentPage($this->lastPage);
}
}
/**
* Calculate the first and last item number for this instance.
*
* @return void
*/
protected function calculateItemRanges()
{
$this->from = $this->total ? ($this->currentPage - 1) * $this->perPage + 1 : 0;
$this->to = min($this->total, $this->currentPage * $this->perPage);
}
/**
* Get the current page for the request.
*
* @param int $lastPage
* @return int
*/
protected function calculateCurrentPage($lastPage)
{
$page = $this->factory->getCurrentPage();
// The page number will get validated and adjusted if it either less than one
// or greater than the last page available based on the count of the given
// items array. If it's greater than the last, we'll give back the last.
if (is_numeric($page) && $page > $lastPage)
{
return $lastPage > 0 ? $lastPage : 1;
}
return $this->isValidPageNumber($page) ? (int) $page : 1;
}
/**
* Determine if the given value is a valid page number.
*
* @param int $page
* @return bool
*/
protected function isValidPageNumber($page)
{
return $page >= 1 && filter_var($page, FILTER_VALIDATE_INT) !== false;
}
/**
* Get the pagination links view.
*
* @param string $view
* @return \Illuminate\View\View
*/
public function links($view = null)
{
return $this->factory->getPaginationView($this, $view);
}
/**
* Get a URL for a given page number.
*
* @param int $page
* @return string
*/
public function getUrl($page)
{
$parameters = array(
$this->factory->getPageName() => $page,
);
// If we have any extra query string key / value pairs that need to be added
// onto the URL, we will put them in query string form and then attach it
// to the URL. This allows for extra information like sortings storage.
if (count($this->query) > 0)
{
$parameters = array_merge($this->query, $parameters);
}
$fragment = $this->buildFragment();
return $this->factory->getCurrentUrl().'?'.http_build_query($parameters, null, '&').$fragment;
}
/**
* Get / set the URL fragment to be appended to URLs.
*
* @param string|null $fragment
* @return $this|string
*/
public function fragment($fragment = null)
{
if (is_null($fragment)) return $this->fragment;
$this->fragment = $fragment;
return $this;
}
/**
* Build the full fragment portion of a URL.
*
* @return string
*/
protected function buildFragment()
{
return $this->fragment ? '#'.$this->fragment : '';
}
/**
* Add a query string value to the paginator.
*
* @param string $key
* @param string $value
* @return $this
*/
public function appends($key, $value = null)
{
if (is_array($key)) return $this->appendArray($key);
return $this->addQuery($key, $value);
}
/**
* Add an array of query string values.
*
* @param array $keys
* @return $this
*/
protected function appendArray(array $keys)
{
foreach ($keys as $key => $value)
{
$this->addQuery($key, $value);
}
return $this;
}
/**
* Add a query string value to the paginator.
*
* @param string $key
* @param string $value
* @return $this
*/
public function addQuery($key, $value)
{
if ($key !== $this->factory->getPageName())
{
$this->query[$key] = $value;
}
return $this;
}
/**
* Determine if the paginator is doing "quick" pagination.
*
* @return bool
*/
public function isQuickPaginating()
{
return is_null($this->total);
}
/**
* Get the current page for the request.
*
* @param int|null $total
* @return int
*/
public function getCurrentPage($total = null)
{
if (is_null($total))
{
return $this->currentPage;
}
return min($this->currentPage, (int) ceil($total / $this->perPage));
}
/**
* Get the last page that should be available.
*
* @return int
*/
public function getLastPage()
{
return $this->lastPage;
}
/**
* Get the number of the first item on the paginator.
*
* @return int
*/
public function getFrom()
{
return $this->from;
}
/**
* Get the number of the last item on the paginator.
*
* @return int
*/
public function getTo()
{
return $this->to;
}
/**
* Get the number of items to be displayed per page.
*
* @return int
*/
public function getPerPage()
{
return $this->perPage;
}
/**
* Get a collection instance containing the items.
*
* @return \Illuminate\Support\Collection
*/
public function getCollection()
{
return new Collection($this->items);
}
/**
* Get the items being paginated.
*
* @return array
*/
public function getItems()
{
return $this->items;
}
/**
* Set the items being paginated.
*
* @param mixed $items
* @return void
*/
public function setItems($items)
{
$this->items = $items;
}
/**
* Get the total number of items in the collection.
*
* @return int
*/
public function getTotal()
{
return $this->total;
}
/**
* Set the base URL in use by the paginator.
*
* @param string $baseUrl
* @return void
*/
public function setBaseUrl($baseUrl)
{
$this->factory->setBaseUrl($baseUrl);
}
/**
* Get the pagination factory.
*
* @return \Illuminate\Pagination\Factory
*/
public function getFactory()
{
return $this->factory;
}
/**
* Get an iterator for the items.
*
* @return \ArrayIterator
*/
public function getIterator()
{
return new ArrayIterator($this->items);
}
/**
* Determine if the list of items is empty or not.
*
* @return bool
*/
public function isEmpty()
{
return empty($this->items);
}
/**
* Get the number of items for the current page.
*
* @return int
*/
public function count()
{
return count($this->items);
}
/**
* Determine if the given item exists.
*
* @param mixed $key
* @return bool
*/
public function offsetExists($key)
{
return array_key_exists($key, $this->items);
}
/**
* Get the item at the given offset.
*
* @param mixed $key
* @return mixed
*/
public function offsetGet($key)
{
return $this->items[$key];
}
/**
* Set the item at the given offset.
*
* @param mixed $key
* @param mixed $value
* @return void
*/
public function offsetSet($key, $value)
{
$this->items[$key] = $value;
}
/**
* Unset the item at the given key.
*
* @param mixed $key
* @return void
*/
public function offsetUnset($key)
{
unset($this->items[$key]);
}
/**
* Get the instance as an array.
*
* @return array
*/
public function toArray()
{
return array(
'total' => $this->total, 'per_page' => $this->perPage,
'current_page' => $this->currentPage, 'last_page' => $this->lastPage,
'from' => $this->from, 'to' => $this->to, 'data' => $this->getCollection()->toArray(),
);
}
/**
* Convert the object to its JSON representation.
*
* @param int $options
* @return string
*/
public function toJson($options = 0)
{
return json_encode($this->toArray(), $options);
}
/**
* Call a method on the underlying Collection
*
* @param string $method
* @param array $arguments
* @return mixed
*/
public function __call($method, $arguments)
{
return call_user_func_array(array($this->getCollection(), $method), $arguments);
}
}
Mini Shell