Best way of handling pagination in a PHP client library - php

Question

Assume I have a REST API that supports pagination (and filtering). Upon executing a GET request to myapi.com/api/users, it returns something like this:
{
total: 100
data: . . .
first_page_url: "/?page=1"
from: 0
next_page_url: "/?page=2"
path: "/"
per_page: 10
prev_page_url: null
to: 10
}
And then in my PHP client library I have something similar to this for a function that performs this request and returns the JSON response as an associative array:
public function users($page = 1, $verified = null, $admin = null, $joined = null, $active_until = null, $banned_until = null, $referral_code = null) {
. . .
}
What would be the best way to fetch the next result?
I am envisioning something like this:
$users = [];
$request = users(); // gets the first page
while ($request) {
$request = next_users();
array_push($users, $request['data']);
}
The problem is that I have no idea where to begin when it comes to putting the result of users() into next_users() while preserving any filter values (the optional parameters of users()), all while doing it elegantly. I have tried looking around, but I can't find many results of API clients handling pagination. As demonstrated above, the ideal scenario would be having the ability to keep getting the next page of results until there are none left with next_users().

Answer 1

You just keep your filter and go through all pages. Something like this:
$filter = [
$admin = true,
$joined = null,
$active_until = null,
$banned_until = null,
$referral_code = "RJ08"
];
$page = 1;
$response = users($page, ...$filter); // gets the first page
$usersData = $response['data'];
while (null !== $response['next_page_url']) {
$response = users(++$page, ...$filter);
array_push($usersData, $response['data']);
}