Described disabling counting the results

Author: mnocon

code_samples/api/public_php_api/src/perform_count.php

@@ -0,0 +1,18 @@
+<?php declare(strict_types=1);
+
+use Ibexa\Contracts\Core\Repository\Values\Content\LocationQuery;
+use Ibexa\Contracts\Core\Repository\Values\Content\Query;
+
+/** @var \Ibexa\Contracts\Core\Repository\SearchService $searchService */
+
+// For location searches
+$locationQuery = new LocationQuery();
+$locationQuery->performCount = false;
+
+$locationResult = $searchService->findLocations($locationQuery);
+
+// For content searches
+$contentQuery = new Query();
+$contentQuery->performCount = false;
+
+$contentResult = $searchService->findContent($contentQuery);

docs/search/search_api.md

@@ -61,6 +61,17 @@ $output->writeln($result->getName());
     $query->limit = 100;
     ```
 
+#### Disable result count
+
+By default, a search query also counts all matching results.
+If you don't need the total count, set `performCount` to `false` on `Query` or `LocationQuery` to improve performance, especially for large result sets.
+
+``` php
+[[= include_code('code_samples/api/public_php_api/src/perform_count.php') =]]
+```
+
+When `performCount` is set to `false`, `$result->totalCount` is `null`.
+
 #### Search with `query` and `filter`
 
 You can use two properties of the `Query` object to search for content: `query` and `filter`.