Webklex / php-imap

src/Support/PaginatedCollection.php

<?php
/*
* File:     PaginatedCollection.php
* Category: Collection
* Author:   M. Goldenbaum
* Created:  16.03.18 03:13
* Updated:  -
*
* Description:
*  -
*/

namespace Webklex\PHPIMAP\Support;

use Illuminate\Pagination\LengthAwarePaginator;
use Illuminate\Support\Collection;
use Illuminate\Pagination\Paginator;

/**
 * Class PaginatedCollection
 *
 * @package Webklex\PHPIMAP\Support
 */
class PaginatedCollection extends Collection {

    /**
     * Number of total entries
     *
     * @var int $total
     */
    protected $total;

    /**
     * Paginate the current collection.
     * @param int $per_page
     * @param int|null $page
     * @param string $page_name
     * @param boolean $prepaginated
     *
     * @return LengthAwarePaginator
     */
    public function paginate(int $per_page = 15, $page = null, string $page_name = 'page', bool $prepaginated = false): LengthAwarePaginator {
        $page = $page ?: Paginator::resolveCurrentPage($page_name);

        $total = $this->total ?: $this->count();

        $results = !$prepaginated && $total ? $this->forPage($page, $per_page)->toArray() : $this->all();

        return $this->paginator($results, $total, $per_page, $page, [
            'path'      => Paginator::resolveCurrentPath(),
            'pageName'  => $page_name,
        ]);
    }

    /**
     * Create a new length-aware paginator instance.
     * @param array $items
     * @param int $total
     * @param int $per_page
     * @param  int|null $current_page
     * @param  array    $options
     *
     * @return LengthAwarePaginator
     */
    protected function paginator(array $items, int $total, int $per_page, $current_page, array $options): LengthAwarePaginator {
        return new LengthAwarePaginator($items, $total, $per_page, $current_page, $options);
    }

    /**
     * Get and set the total amount
     * @param null $total

Are you sure the doc-type for parameter $total is correct as it would always require null to be passed?

     *
     * @return int|null
     */
    public function total($total = null) {
        if($total === null) {

The condition $total === null is always true.

            return $this->total;
        }

        return $this->total = $total;
    }
}