[8.x] Add onLastPage method to the Paginator (#40265)

* Add onLastPage method and add tests

* CS tweaks

* Trim spaces

Author: johanvanhelden

src/Illuminate/Pagination/AbstractPaginator.php

@@ -379,6 +379,16 @@ public function onFirstPage()
         return $this->currentPage() <= 1;
     }
 
+    /**
+     * Determine if the paginator is on the last page.
+     *
+     * @return bool
+     */
+    public function onLastPage()
+    {
+        return ! $this->hasMorePages();
+    }
+
     /**
      * Get the current page.
      *

tests/Pagination/LengthAwarePaginatorTest.php

@@ -56,6 +56,19 @@ public function testLengthAwarePaginatorSetCorrectInformationWithNoItems()
         $this->assertEmpty($paginator->items());
     }
 
+    public function testLengthAwarePaginatorisOnFirstAndLastPage()
+    {
+        $paginator = new LengthAwarePaginator(['1', '2', '3', '4'], 4, 2, 2);
+
+        $this->assertTrue($paginator->onLastPage());
+        $this->assertFalse($paginator->onFirstPage());
+
+        $paginator = new LengthAwarePaginator(['1', '2', '3', '4'], 4, 2, 1);
+
+        $this->assertFalse($paginator->onLastPage());
+        $this->assertTrue($paginator->onFirstPage());
+    }
+
     public function testLengthAwarePaginatorCanGenerateUrls()
     {
         $this->p->setPath('http://website.com');