New in Symfony 6.3: HttpClient Improvements

Added JsonMockResponse

Contributed by
Thomas Calvet

in #50044.

The HttpClient component provides some utilities to test HTTP requests and responses
using a MockHttpClient that returns MockResponse objects. In Symfony 6.3
we’ve introduced the JsonMockResponse utility class to mock JSON responses:

use SymfonyComponentHttpClientResponseMockResponse;

new MockResponse(
json_encode([‚foo‘ => ‚bar‘]),
[‚response_headers‘ => [‚content-type‘ => ‚application/json‘]]

use SymfonyComponentHttpClientResponseJsonMockResponse;

new JsonMockResponse([‚foo‘ => ‚bar‘]);

Configure Extra Options

Contributed by
Roman Andreev

in #48797.

The extra option passed to the request() method of the HttpClient component
allows to define additional configuration, such as cURL options. In Symfony 6.3
you can also define those extra options when configuring the HttpClient.

This way, you can configure cURL options such as certificates once and use them
in all requests made with that HTTP client:

// this example shows how to configure these options when using
// PHP config format; but it also works with YAML and XML
return static function (FrameworkConfig $frameworkConfig): void {
$httpClient = $frameworkConfig->httpClient();
‚extra‘ => [‚curl‘ => [‚foo‘ => ‚bar‘]]

->header(‚Accept‘, ‚application/json‘)
->extra([‚curl‘ => [‚foo‘ => ‚bar‘]]);

Multiple Retry URIs

Contributed by
Benjamin Zaslavsky

in #49809.

Retrying failed requests is one of the features that provides the HttpClient
component to handle failed requests due to network issues or temporary server errors.
In Symfony 6.3 we’ve improved this feature to allow defining multiple base URIs
that are selected alternatively when retrying the requests:

$response = $client->request(‚GET‘, ‚foo-bar‘, [
‚base_uri‘ => [
‚‘, // first request will use this base URI
‚‘, // if first request fails, the second base URI will be used

File Upload Improvements

Contributed by
Nicolas Grekas

in #49911.

When uploading data with the HttpClient component, the data is encoded by
default as application/x-www-form-urlencoded. If you wanted to submit a form
with file uploads, it was your responsibility to encode the body according to
the multipart/form-data content-type.

In Symfony 6.3 we’ve improved this situation and now you can upload one or more
files using multipart/form-data as follows:

$fileHandle = fopen(‚/path/to/the/file‘ ‚r‘);
$client->request(‚POST‘, ‚https://…‘, [‚body‘ => [‚the_file‘ => $fileHandle]]);

By default, this code will populate the filename and content-type with the data
of the opened file, but you can configure both with the PHP streaming configuration:

stream_context_set_option($fileHandle, ‚http‘, ‚filename‘, ‚the-name.txt‘);
stream_context_set_option($fileHandle, ‚http‘, ‚content_type‘, ‚my/content-type‘)

Add Support for URI Templates

Contributed by
Thomas Calvet

in #49302.

URI templates, defined in the RFC 6570, describe a range of URLs via some
variable parts. For example,{username}/ uses a variable
in the URL path and{?q,lang} uses two variables
in the query string part of the URL.

In Symfony 6.3 you can use these URI templates with a new UriTemplateHttpClient():

$client = new UriTemplateHttpClient();

// This request will result on querying
$client->request(‚GET‘, ‚{resource}{?page}‘, [
‚vars‘ => [
‚resource‘ => ‚users‘,
‚page‘ => 1,

You can even configure variables that will be replaced globally in all URI
templates of your application:

# config/packages/framework.yaml
secret: ’secret-token‘

Sponsor the Symfony project.

Symfony Blog

Read More

Latest News


PHP 8.2.16 released!

PHP 8.3.3 released!

PHP 8.1.27 released!

Generated by Feedzy