From 0254e633d2a0cf36c3b3a2ba19350019e12d3b4b Mon Sep 17 00:00:00 2001
From: "Christoph M. Becker" <cmbecker69@gmx.de>
Date: Fri, 24 Sep 2021 18:46:45 +0200
Subject: [PATCH] Fix #80431: parse_url() return fragment, query while there is
 not

---
 reference/url/functions/parse-url.xml | 40 +++++++++++++++++++++++++++
 1 file changed, 40 insertions(+)

diff --git a/reference/url/functions/parse-url.xml b/reference/url/functions/parse-url.xml
index dd27d6b803..b8f378e9cb 100644
--- a/reference/url/functions/parse-url.xml
+++ b/reference/url/functions/parse-url.xml
@@ -118,6 +118,23 @@
    <type>int</type>, in the case of <constant>PHP_URL_PORT</constant>)
    instead of an <type>array</type>. If the requested component doesn't exist
    within the given URL, &null; will be returned.
+   As of PHP 8.0.0, <function>parse_url</function> distinguishes absent and empty
+   queries and fragments:
+  </para>
+  <para>
+   <informalexample>
+    <screen>
+<![CDATA[
+http://example.com/foo → query = null, fragment = null
+http://example.com/foo? → query = "",   fragment = null
+http://example.com/foo# → query = null, fragment = ""
+http://example.com/foo?# → query = "",   fragment = ""
+]]>
+    </screen>
+   </informalexample>
+  </para>
+  <para>
+    Previously all cases resulted in query and fragment being &null;.
   </para>
   <para>
    Note that control characters (cf. <function>ctype_cntrl</function>) in the
@@ -125,6 +142,29 @@
   </para>
  </refsect1>
 
+ <refsect1 role="changelog">
+  &reftitle.changelog;
+  <informaltable>
+   <tgroup cols="2">
+    <thead>
+     <row>
+      <entry>&Version;</entry>
+      <entry>&Description;</entry>
+     </row>
+    </thead>
+    <tbody>
+     <row>
+      <entry>8.0.0</entry>
+      <entry>
+       <function>parse_url</function> will now distinguish absent and empty queries
+       and fragments.
+      </entry>
+     </row>
+    </tbody>
+   </tgroup>
+  </informaltable>
+ </refsect1>
+
  <refsect1 role="examples">
   &reftitle.examples;
   <para>