Skip to content

Sync with EN documentation (http_build_query, php/doc-en@f72c6031) #2792

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

Merged
lacatoire merged 1 commit into from
May 5, 2026
Merged

Sync with EN documentation (http_build_query, php/doc-en@f72c6031) #2792

Changes from all commits
Commits
Show all changes
1 commit
Select commit
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
48 changes: 47 additions & 1 deletion reference/url/functions/http-build-query.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: e80ef2394f0c64be66917a5d4335736ae05b774f Maintainer: yannick Status: ready -->
<!-- EN-Revision: f72c6031982a6f8152ef351d20f8e0d90e8f1612 Maintainer: lacatoire Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="function.http-build-query" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
Expand Down Expand Up @@ -40,6 +40,14 @@
Si <parameter>data</parameter> est un objet, alors seuls les
attributs publics seront utilisés dans le résultat.
</para>
<note>
<simpara>
La méthode magique <link linkend="object.tostring">__toString()</link>
n'est pas appelée lorsqu'un objet est évalué. Pour utiliser la
représentation sous forme de chaîne d'un objet dans la chaîne de requête,
l'objet doit être explicitement converti en chaîne.
</simpara>
</note>
</listitem>
</varlistentry>
<varlistentry>
Expand Down Expand Up @@ -265,6 +273,44 @@ echo http_build_query($parent);
<screen>
<![CDATA[
pub=publicParent&pub_bar%5Bpub%5D=publicChild
]]>
</screen>
</example>

<example>
<title>Utilisation de <function>http_build_query</function> avec des objets contenant
<link linkend="object.tostring">__toString()</link>
</title>
<programlisting role="php">
<![CDATA[
<?php
class Foo {
public $publicProperty = 'visible';

public function __toString() {
return "bar";
}
}

$params = array(
'a' => 'b',
'foo' => new Foo()
);

// Sans conversion, http_build_query lit les propriétés publiques
echo http_build_query($params) . "\n";

// Avec une conversion explicite, http_build_query utilise la sortie de __toString()
$params['foo'] = (string) new Foo();
echo http_build_query($params) . "\n";
?>
]]>
</programlisting>
&example.outputs;
<screen>
<![CDATA[
a=b&foo%5BpublicProperty%5D=visible
a=b&foo=bar
]]>
</screen>
</example>
Expand Down
Loading