resultMapper = $resultMapper; $this->call = $call; $this->config = $config + [ 'itemsKey' => 'items', 'nextResultTokenKey' => 'nextPageToken', 'resultTokenKey' => 'pageToken', 'firstPage' => null, 'resultLimit' => 0, 'setNextResultTokenCondition' => function () { return true; } ]; $this->callOptions = $callOptions; $this->resultTokenPath = explode('.', $this->config['resultTokenKey']); $this->nextResultTokenPath = explode('.', $this->config['nextResultTokenKey']); $this->itemsPath = explode('.', $this->config['itemsKey']); $this->initialResultToken = $this->nextResultToken(); } /** * Fetch the token used to get the next set of results. * * @return string|null */ public function nextResultToken() { return $this->get($this->resultTokenPath, $this->callOptions); } /** * Rewind the iterator. * * @return null */ public function rewind() { $this->itemCount = 0; $this->position = 0; if ($this->config['firstPage']) { list($this->page, $shouldContinue) = $this->mapResults($this->config['firstPage']); $nextResultToken = $this->determineNextResultToken($this->page, $shouldContinue); } else { $this->page = null; $nextResultToken = $this->initialResultToken; } if ($nextResultToken) { $this->set($this->resultTokenPath, $this->callOptions, $nextResultToken); } } /** * Get the current page. * * @return array|null */ public function current() { if ($this->page === null) { $this->page = $this->executeCall(); } $page = $this->get($this->itemsPath, $this->page); if ($this->nextResultToken()) { return $page ?: []; } return $page; } /** * Get the key current page's key. * * @return int */ public function key() { return $this->position; } /** * Advances to the next page. * * @return null */ public function next() { $this->position++; $this->page = $this->nextResultToken() ? $this->executeCall() : null; } /** * Determines if the current position is valid. * * @return bool */ public function valid() { if (!$this->page && $this->position) { return false; } return true; } /** * Executes the provided call to get a set of results. * * @return array */ private function executeCall() { $call = $this->call; list($results, $shouldContinue) = $this->mapResults( $call($this->callOptions) ); $this->set( $this->resultTokenPath, $this->callOptions, $this->determineNextResultToken($results, $shouldContinue) ); return $results; } /** * @param array $results * @return array */ private function mapResults(array $results) { $items = $this->get($this->itemsPath, $results); $resultMapper = $this->resultMapper; $shouldContinue = true; if ($items) { foreach ($items as $key => $item) { $items[$key] = $resultMapper($item); $this->itemCount++; if ($this->config['resultLimit'] && $this->config['resultLimit'] <= $this->itemCount) { $items = array_slice($items, 0, $key + 1); $shouldContinue = false; break; } } $this->set($this->itemsPath, $results, $items); } return [$results, $shouldContinue]; } /** * @param array $results * @param bool $shouldContinue * @return null */ private function determineNextResultToken(array $results, $shouldContinue = true) { return $shouldContinue && $this->config['setNextResultTokenCondition']($results) ? $this->get($this->nextResultTokenPath, $results) : null; } /** * @param array $path * @param array $array * @return mixed */ private function get(array $path, array $array) { $result = $array; foreach ($path as $key) { if (!isset($result[$key])) { return null; } $result = $result[$key]; } return $result; } /** * @param array $path * @param array $array * @param mixed $value * @return null */ private function set(array $path, array &$array, $value) { $temp = &$array; foreach ($path as $key) { $temp = &$temp[$key]; } $temp = $value; } }