From 7a7ad98fe2604fcb8c72d6b14ad054a093650847 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Maur=C3=ADcio=20Meneghini=20Fauth?= <mauricio@php.net>
Date: Fri, 3 Sep 2021 13:52:33 -0300
Subject: [PATCH] Document the null behaviour for http_build_query

---
 reference/url/functions/http-build-query.xml | 7 ++++---
 1 file changed, 4 insertions(+), 3 deletions(-)

diff --git a/reference/url/functions/http-build-query.xml b/reference/url/functions/http-build-query.xml
index c416f93522..7a0e219d48 100644
--- a/reference/url/functions/http-build-query.xml
+++ b/reference/url/functions/http-build-query.xml
@@ -109,6 +109,7 @@ $data = array(
     'foo' => 'bar',
     'baz' => 'boom',
     'cow' => 'milk',
+    'null' => null,
     'php' => 'hypertext processor'
 );
 
@@ -132,7 +133,7 @@ foo=bar&amp;baz=boom&amp;cow=milk&amp;php=hypertext+processor
    <programlisting role="php">
 <![CDATA[
 <?php
-$data = array('foo', 'bar', 'baz', 'boom', 'cow' => 'milk', 'php' => 'hypertext processor');
+$data = array('foo', 'bar', 'baz', null, 'boom', 'cow' => 'milk', 'php' => 'hypertext processor');
 
 echo http_build_query($data) . "\n";
 echo http_build_query($data, 'myvar_');
@@ -142,8 +143,8 @@ echo http_build_query($data, 'myvar_');
    &example.outputs;
    <screen>
 <![CDATA[
-0=foo&1=bar&2=baz&3=boom&cow=milk&php=hypertext+processor
-myvar_0=foo&myvar_1=bar&myvar_2=baz&myvar_3=boom&cow=milk&php=hypertext+processor
+0=foo&1=bar&2=baz&4=boom&cow=milk&php=hypertext+processor
+myvar_0=foo&myvar_1=bar&myvar_2=baz&myvar_4=boom&cow=milk&php=hypertext+processor
 ]]>
    </screen>
   </example>