feature #15883 [HttpClient] HttpClientInterface::setResponseFactory method (greeflas)

This PR was merged into the 5.4 branch.

Discussion
----------

[HttpClient] HttpClientInterface::setResponseFactory method

<!--

If your pull request fixes a BUG, use the oldest maintained branch that contains
the bug (see https://symfony.com/releases for the list of maintained branches).

If your pull request documents a NEW FEATURE, use the same Symfony branch where
the feature was introduced (and `5.x` for features of unreleased versions).

-->

Commits
-------

76bd5fb [HttpClient] HttpClientInterface::setResponseFactory method

Author: wouterj

http_client.rst

@@ -1709,6 +1709,23 @@ responses dynamically when it's called::
     $client = new MockHttpClient($callback);
     $response = $client->request('...'); // calls $callback to get the response
 
+.. tip::
+
+    Instead of using the first argument, you can also set the (list of)
+    responses or callbacks using the ``setResponseFactory()`` method::
+
+        $responses = [
+            new MockResponse($body1, $info1),
+            new MockResponse($body2, $info2),
+        ];
+
+        $client = new MockHttpClient();
+        $client->setResponseFactory($responses);
+
+    .. versionadded:: 5.4
+
+        The ``setResponseFactory()`` method was introduced in Symfony 5.4.
+
 If you need to test responses with HTTP status codes different than 200,
 define the ``http_code`` option::