Add terminate_after support

Author: babenkoivan

.github/workflows/code-style.yml

@@ -4,7 +4,7 @@ on: [push, pull_request]
 
 jobs:
   style-check:
-    runs-on: ubuntu-18.04
+    runs-on: ubuntu-latest
     steps:
       - name: Checkout code
         uses: actions/checkout@v2

.github/workflows/static-analysis.yml

@@ -4,7 +4,7 @@ on: [push, pull_request]
 
 jobs:
   static-analysis:
-    runs-on: ubuntu-18.04
+    runs-on: ubuntu-latest
     steps:
       - name: Checkout code
         uses: actions/checkout@v2

.github/workflows/test.yml

@@ -4,7 +4,7 @@ on: [push, pull_request]
 
 jobs:
   test:
-    runs-on: ubuntu-18.04
+    runs-on: ubuntu-latest
     strategy:
       matrix:
         php: [7.4, 8.0, 8.1]

README.md

@@ -465,6 +465,9 @@ $searchParameters->routing(['user1', 'user2']);
 // enable explanation
 $searchParameters->explain(true);
 
+// set maximum number of documents to collect for each shard
+$searchParameters->terminateAfter(10);
+
 // perform the search and get the result
 $searchResult = $documentManager->search($searchParameters);
 

src/Search/SearchParameters.php

@@ -152,6 +152,12 @@ public function explain(bool $explain): self
         return $this;
     }
 
+    public function terminateAfter(int $terminateAfter): self
+    {
+        $this->params['terminate_after'] = $terminateAfter;
+        return $this;
+    }
+
     public function toArray(): array
     {
         return $this->params;

tests/Unit/Search/SearchParametersTest.php

@@ -394,4 +394,10 @@ public function test_array_casting_with_explain(): void
             ],
         ], $searchParameters->toArray());
     }
+
+    public function test_array_casting_with_terminate_after(): void
+    {
+        $searchParameters = (new SearchParameters())->terminateAfter(10);
+        $this->assertSame(['terminate_after' => 10], $searchParameters->toArray());
+    }
 }