Skip to content

[HttpClient] Adding DataPart to manually set the Content-Type #20960

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 2 commits into
base: 6.4
Choose a base branch
from
Open

[HttpClient] Adding DataPart to manually set the Content-Type #20960

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
aa84c7d
[Form] Adding `DataPart` to manually set the `Content-Type`
ThomasLandauer May 13, 2025
f8ae9b9
Update http_client.rst
ThomasLandauer May 13, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
9 changes: 9 additions & 0 deletions http_client.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -665,6 +665,15 @@ of the opened file, but you can configure both with the PHP streaming configurat
$formData->getParts(); // Returns two instances of TextPart both
// with the name "array_field"

Usually, the ``Content-Type`` of each form's part is detected automatically. However,
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Asking because I don't know much about this. When you say this:

Usually the content type [...] is detected automatically.

When is not detected? I want to better understand the scenarios where the reader needs to use this explicit content type definition.

Thanks.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

When is not detected?

Actually, I'm not sure if it's actually detected at all ;-) I just had the requirement to post to an external API as multipart/form-data, but with one of those parts being JSON (application/json), and this here was the way to make it work.

you can override it by passing a ``DataPart``::

use Symfony\Component\Mime\Part\DataPart;

$formData = new FormDataPart([
['json_data' => new DataPart(json_encode($json), null, 'application/json')]
]);

By default, HttpClient streams the body contents when uploading them. This might
not work with all servers, resulting in HTTP status code 411 ("Length Required")
because there is no ``Content-Length`` header. The solution is to turn the body
Expand Down