Unable to get total anymore, it was removed but the documentation not updated

[vesper8]

In your latest 3 commits two weeks ago you removed the total and getTotal but didn't update the documentation. I'm not sure if you entirely meant to remove these as they are useful for using pagination and not retrieve a large number of jira issues not all at once.

Hoping you find the time to update the documentation soon to show us how to do pagination with the new updates.

Many thanks

[Q1tum]

It looks like I'm running into the same issue mentioned by @vesper8. I used the following code:

<?php

require 'vendor/autoload.php';

use JiraCloud\Configuration\ArrayConfiguration;
use JiraCloud\Issue\IssueService;
use JiraCloud\JiraException;

$jql = 'project not in (TEST)';

try {
    $issueService = new IssueService(new ArrayConfiguration(
        [
            'jiraHost' => 'https://<<<DOMAIN>>.jira.com',
            'jiraUser' => '<<USERNAME>>',
            'personalAccessToken' => '<<TOKEN>>',

            // custom log config
            'jiraLogEnabled' => true,
            'jiraLogFile' => "my-jira-rest-client.log",
            'jiraLogLevel' => 'INFO',
        ]
    ));

    $pagination = -1;

    $startAt = 0;	//the index of the first issue to return (0-based)
    $maxResult = 3;	// the maximum number of issues to return (defaults to 50).
    $totalCount = -1;	// the number of issues to return

    // first fetch
    $ret = $issueService->search($jql, $startAt, $maxResult);
    $totalCount = $ret->total;

    // do something with fetched data
    foreach ($ret->issues as $issue) {
        print (sprintf("Found ticket: %s \n", $issue->key));
    }

    // fetch remained data
    $page = $totalCount / $maxResult;

    var_dump($page, $totalCount);

} catch (JiraCloud\JiraException $e) {
    $this->assertTrue(false, 'testSearch Failed : '.$e->getMessage());
}

The above code gives the following result (output):

PHP Warning:  Undefined property: JiraCloud\Issue\IssueSearchResult::$total in /home/arno/data/tmp/jira/search.php on line 33
Found ticket: PJ-3 
Found ticket: PJ-2 
Found ticket: APJ-1164 
int(0)
NULL

Variable $ret->total is defined as NULL.

[Q1tum]

@vesper8 please notices that the documentation is not correct, there is a correct implementation of search: https://github.com/lesstif/php-JiraCloud-RESTAPI/blob/main/src/Issue/IssueService.php#L495

An example would be:

$maxResult = 500;

$issues = $issueService->search($jql, '', $maxResult);
$combinedIssues = $issues;

while ($issues->isLast === false) {
    $issues = $issueService->search($jql, $issues->nextPageToken, $maxResult);
    $combinedIssues->issues = array_merge($combinedIssues->issues, $issues->issues);
}

[SmartHMI-OSS]

Actually it only works with this now:

$issues = $issueService->search($jql, '', $maxResult);
$combinedIssues = $issues;

while ($issues->isLast === false && $issues->nextPageToken) {
    $issues = $issueService->search($jql, $issues->nextPageToken, $maxResult);
    $combinedIssues->issues = array_merge($combinedIssues->issues, $issues->issues);
}