php · julionc · Sep 18, 2026 · Sep 16, 2026
diff --git a/language-snippets.ent b/language-snippets.ent
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 8648d1cda141537b5dbd403a0bf0e6eb8c086e9d Maintainer: argosback Status: ready -->
+<!-- EN-Revision: 9bf8b904f30d04adcccd3e202c9e870b79284789 Maintainer: argosback Status: ready -->
 
 <!ENTITY installation.enabled.disable 'Esta extensión está activada por defecto. Puede ser desactivada utilizando la opción de configuración: '>
 
@@ -4457,6 +4457,18 @@ local: {
   </simpara>
 '>
 
+<!ENTITY uri.normalization '
+  <simpara>
+   Los tripletes hexadecimales se convierten a mayúsculas, los caracteres no reservados codificados con porcentaje se decodifican, los componentes de esquema y de host se normalizan a minúsculas y los segmentos de punto se eliminan de la ruta, conforme a la RFC 3986.
+  </simpara>
+'>
+
+<!ENTITY uri.non-normalization '
+  <simpara>
+   Los tripletes hexadecimales no se convierten a mayúsculas, los caracteres no reservados codificados con porcentaje permanecen codificados, los componentes de esquema y de host conservan las mayúsculas y minúsculas con las que se proporcionaron y los segmentos de punto se mantienen en la ruta.
+  </simpara>
+'>
+
 <!-- UOPZ snippets -->
 
 <!ENTITY uopz.warn.removed.function-5-0-0 '<warning

diff --git a/reference/uri/uri.whatwg.urlvalidationerrortype.xml b/reference/uri/uri.whatwg.urlvalidationerrortype.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 8352249a84d0b91b38c741ff1c256061127dbfbb Maintainer: lacatoire Status: ready -->
+<!-- EN-Revision: 9bf8b904f30d04adcccd3e202c9e870b79284789 Maintainer: lacatoire Status: ready -->
 <reference xml:id="enum.uri-whatwg-urlvalidationerrortype" role="enum" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns="http://docbook.org/ns/docbook">
  <title>La enumeración Uri\WhatWg\UrlValidationErrorType</title>
  <titleabbrev>Uri\WhatWg\UrlValidationErrorType</titleabbrev>
@@ -106,7 +106,7 @@
 
      <enumitem>
       <enumidentifier>Ipv4InIpv6InvalidCodePoint</enumidentifier>
-      <enumitemdescription>Una dirección IPv6 con sintaxis de dirección IPv4.</enumitemdescription>
+      <enumitemdescription>Una dirección IPv6 con sintaxis de dirección IPv4: una parte IPv4 está vacía, contiene un dígito no ASCII o un cero inicial, o hay demasiadas partes IPv4.</enumitemdescription>
      </enumitem>
 
      <enumitem>

diff --git a/reference/uri/uri/rfc3986/uri/getfragment.xml b/reference/uri/uri/rfc3986/uri/getfragment.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 39596f1226fd3b502bfbba09068ad6701235426f Maintainer: lacatoire Status: ready -->
+<!-- EN-Revision: 9bf8b904f30d04adcccd3e202c9e870b79284789 Maintainer: lacatoire Status: ready -->
 <refentry xml:id="uri-rfc3986-uri.getfragment" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
   <refname>Uri\Rfc3986\Uri::getFragment</refname>
@@ -15,6 +15,7 @@
   <simpara>
    Recupera el componente de fragmento normalizado.
   </simpara>
+  &uri.normalization;
  </refsect1>
 
  <refsect1 role="parameters">

diff --git a/reference/uri/uri/rfc3986/uri/gethost.xml b/reference/uri/uri/rfc3986/uri/gethost.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 39596f1226fd3b502bfbba09068ad6701235426f Maintainer: lacatoire Status: ready -->
+<!-- EN-Revision: 9bf8b904f30d04adcccd3e202c9e870b79284789 Maintainer: lacatoire Status: ready -->
 <refentry xml:id="uri-rfc3986-uri.gethost" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
   <refname>Uri\Rfc3986\Uri::getHost</refname>
@@ -15,6 +15,7 @@
   <simpara>
    Recupera el componente de host normalizado.
   </simpara>
+  &uri.normalization;
  </refsect1>
 
  <refsect1 role="parameters">

diff --git a/reference/uri/uri/rfc3986/uri/getpassword.xml b/reference/uri/uri/rfc3986/uri/getpassword.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: c5ff5efb9c44487de448c0294af6f6b214f87594 Maintainer: lacatoire Status: ready -->
+<!-- EN-Revision: 9bf8b904f30d04adcccd3e202c9e870b79284789 Maintainer: lacatoire Status: ready -->
 <refentry xml:id="uri-rfc3986-uri.getpassword" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
   <refname>Uri\Rfc3986\Uri::getPassword</refname>
@@ -16,6 +16,7 @@
    Recupera la parte de contraseña normalizada (el texto después del primer carácter <literal>:</literal>)
    del componente userinfo.
   </simpara>
+  &uri.normalization;
  </refsect1>
 
  <refsect1 role="parameters">

diff --git a/reference/uri/uri/rfc3986/uri/getpath.xml b/reference/uri/uri/rfc3986/uri/getpath.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: c5ff5efb9c44487de448c0294af6f6b214f87594 Maintainer: lacatoire Status: ready -->
+<!-- EN-Revision: 9bf8b904f30d04adcccd3e202c9e870b79284789 Maintainer: lacatoire Status: ready -->
 <refentry xml:id="uri-rfc3986-uri.getpath" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
   <refname>Uri\Rfc3986\Uri::getPath</refname>
@@ -15,6 +15,7 @@
   <simpara>
    Recupera el componente de ruta normalizado.
   </simpara>
+  &uri.normalization;
  </refsect1>
 
  <refsect1 role="parameters">

diff --git a/reference/uri/uri/rfc3986/uri/getquery.xml b/reference/uri/uri/rfc3986/uri/getquery.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: c5ff5efb9c44487de448c0294af6f6b214f87594 Maintainer: lacatoire Status: ready -->
+<!-- EN-Revision: 9bf8b904f30d04adcccd3e202c9e870b79284789 Maintainer: lacatoire Status: ready -->
 <refentry xml:id="uri-rfc3986-uri.getquery" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
   <refname>Uri\Rfc3986\Uri::getQuery</refname>
@@ -15,6 +15,7 @@
   <simpara>
    Recupera el componente de consulta normalizado.
   </simpara>
+  &uri.normalization;
  </refsect1>
 
  <refsect1 role="parameters">

diff --git a/reference/uri/uri/rfc3986/uri/getrawfragment.xml b/reference/uri/uri/rfc3986/uri/getrawfragment.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: c5ff5efb9c44487de448c0294af6f6b214f87594 Maintainer: lacatoire Status: ready -->
+<!-- EN-Revision: 9bf8b904f30d04adcccd3e202c9e870b79284789 Maintainer: lacatoire Status: ready -->
 <refentry xml:id="uri-rfc3986-uri.getrawfragment" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
   <refname>Uri\Rfc3986\Uri::getRawFragment</refname>
@@ -15,6 +15,7 @@
   <simpara>
    Recupera el componente de fragmento sin procesar (no normalizado).
   </simpara>
+  &uri.non-normalization;
  </refsect1>
 
  <refsect1 role="parameters">

diff --git a/reference/uri/uri/rfc3986/uri/getrawhost.xml b/reference/uri/uri/rfc3986/uri/getrawhost.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 39596f1226fd3b502bfbba09068ad6701235426f Maintainer: lacatoire Status: ready -->
+<!-- EN-Revision: 9bf8b904f30d04adcccd3e202c9e870b79284789 Maintainer: lacatoire Status: ready -->
 <refentry xml:id="uri-rfc3986-uri.getrawhost" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
   <refname>Uri\Rfc3986\Uri::getRawHost</refname>
@@ -15,6 +15,7 @@
   <simpara>
    Recupera el componente de host sin procesar (no normalizado).
   </simpara>
+  &uri.non-normalization;
  </refsect1>
 
  <refsect1 role="parameters">

diff --git a/reference/uri/uri/rfc3986/uri/getrawpassword.xml b/reference/uri/uri/rfc3986/uri/getrawpassword.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 39596f1226fd3b502bfbba09068ad6701235426f Maintainer: lacatoire Status: ready -->
+<!-- EN-Revision: 9bf8b904f30d04adcccd3e202c9e870b79284789 Maintainer: lacatoire Status: ready -->
 <refentry xml:id="uri-rfc3986-uri.getrawpassword" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
   <refname>Uri\Rfc3986\Uri::getRawPassword</refname>
@@ -16,6 +16,7 @@
    Recupera la parte de contraseña sin procesar (no normalizada) (el texto después del primer carácter <literal>:</literal>)
    del componente userinfo.
   </simpara>
+  &uri.non-normalization;
  </refsect1>
 
  <refsect1 role="parameters">
@@ -26,7 +27,7 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <simpara>
-   Devuelve la contraseña sin procesar (no normalizada) como un &string; si el componente userinfo contiene un carácter <literal>:</literal>.
+   Devuelve la contraseña sin procesar como un &string; si el componente userinfo contiene un carácter <literal>:</literal>.
    Se devuelve una cadena vacía cuando el componente userinfo no contiene un carácter <literal>:</literal>.
    Se devuelve &null; cuando el componente userinfo no existe.
   </simpara>

diff --git a/reference/uri/uri/rfc3986/uri/getrawpath.xml b/reference/uri/uri/rfc3986/uri/getrawpath.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 39596f1226fd3b502bfbba09068ad6701235426f Maintainer: lacatoire Status: ready -->
+<!-- EN-Revision: 9bf8b904f30d04adcccd3e202c9e870b79284789 Maintainer: lacatoire Status: ready -->
 <refentry xml:id="uri-rfc3986-uri.getrawpath" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
   <refname>Uri\Rfc3986\Uri::getRawPath</refname>
@@ -15,6 +15,7 @@
   <simpara>
    Recupera el componente de ruta sin procesar (no normalizado).
   </simpara>
+  &uri.non-normalization;
  </refsect1>
 
  <refsect1 role="parameters">

diff --git a/reference/uri/uri/rfc3986/uri/getrawquery.xml b/reference/uri/uri/rfc3986/uri/getrawquery.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 39596f1226fd3b502bfbba09068ad6701235426f Maintainer: lacatoire Status: ready -->
+<!-- EN-Revision: 9bf8b904f30d04adcccd3e202c9e870b79284789 Maintainer: lacatoire Status: ready -->
 <refentry xml:id="uri-rfc3986-uri.getrawquery" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
   <refname>Uri\Rfc3986\Uri::getRawQuery</refname>
@@ -15,6 +15,7 @@
   <simpara>
    Recupera el componente de consulta sin procesar (no normalizado).
   </simpara>
+  &uri.non-normalization;
  </refsect1>
 
  <refsect1 role="parameters">

diff --git a/reference/uri/uri/rfc3986/uri/getrawscheme.xml b/reference/uri/uri/rfc3986/uri/getrawscheme.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 39596f1226fd3b502bfbba09068ad6701235426f Maintainer: lacatoire Status: ready -->
+<!-- EN-Revision: 9bf8b904f30d04adcccd3e202c9e870b79284789 Maintainer: lacatoire Status: ready -->
 <refentry xml:id="uri-rfc3986-uri.getrawscheme" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
   <refname>Uri\Rfc3986\Uri::getRawScheme</refname>
@@ -15,6 +15,7 @@
   <simpara>
    Recupera el componente de esquema sin procesar (no normalizado).
   </simpara>
+  &uri.non-normalization;
  </refsect1>
 
  <refsect1 role="parameters">

diff --git a/reference/uri/uri/rfc3986/uri/getrawuserinfo.xml b/reference/uri/uri/rfc3986/uri/getrawuserinfo.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 39596f1226fd3b502bfbba09068ad6701235426f Maintainer: lacatoire Status: ready -->
+<!-- EN-Revision: 9bf8b904f30d04adcccd3e202c9e870b79284789 Maintainer: lacatoire Status: ready -->
 <refentry xml:id="uri-rfc3986-uri.getrawuserinfo" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
   <refname>Uri\Rfc3986\Uri::getRawUserInfo</refname>
@@ -15,6 +15,7 @@
   <simpara>
    Recupera el componente userinfo sin procesar (no normalizado).
   </simpara>
+  &uri.non-normalization;
  </refsect1>
 
  <refsect1 role="parameters">

diff --git a/reference/uri/uri/rfc3986/uri/getrawusername.xml b/reference/uri/uri/rfc3986/uri/getrawusername.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 39596f1226fd3b502bfbba09068ad6701235426f Maintainer: lacatoire Status: ready -->
+<!-- EN-Revision: 9bf8b904f30d04adcccd3e202c9e870b79284789 Maintainer: lacatoire Status: ready -->
 <refentry xml:id="uri-rfc3986-uri.getrawusername" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
   <refname>Uri\Rfc3986\Uri::getRawUsername</refname>
@@ -16,6 +16,7 @@
    Recupera la parte del nombre de usuario sin procesar (no normalizado) (el texto antes del primer carácter <literal>:</literal>)
    del componente userinfo.
   </simpara>
+  &uri.non-normalization;
  </refsect1>
 
  <refsect1 role="parameters">
@@ -26,7 +27,7 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <simpara>
-   Devuelve el nombre de usuario sin procesar (no normalizado) como un &string; si el componente userinfo existe; de lo contrario, se devuelve &null;.
+   Devuelve el nombre de usuario sin procesar como un &string; si el componente userinfo existe; de lo contrario, se devuelve &null;.
   </simpara>
  </refsect1>
 

diff --git a/reference/uri/uri/rfc3986/uri/getscheme.xml b/reference/uri/uri/rfc3986/uri/getscheme.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 39596f1226fd3b502bfbba09068ad6701235426f Maintainer: lacatoire Status: ready -->
+<!-- EN-Revision: 9bf8b904f30d04adcccd3e202c9e870b79284789 Maintainer: lacatoire Status: ready -->
 <refentry xml:id="uri-rfc3986-uri.getscheme" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
   <refname>Uri\Rfc3986\Uri::getScheme</refname>
@@ -15,6 +15,7 @@
   <simpara>
    Recupera el componente de esquema normalizado.
   </simpara>
+  &uri.normalization;
  </refsect1>
 
  <refsect1 role="parameters">

diff --git a/reference/uri/uri/rfc3986/uri/getuserinfo.xml b/reference/uri/uri/rfc3986/uri/getuserinfo.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 39596f1226fd3b502bfbba09068ad6701235426f Maintainer: lacatoire Status: ready -->
+<!-- EN-Revision: 9bf8b904f30d04adcccd3e202c9e870b79284789 Maintainer: lacatoire Status: ready -->
 <refentry xml:id="uri-rfc3986-uri.getuserinfo" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
   <refname>Uri\Rfc3986\Uri::getUserInfo</refname>
@@ -15,6 +15,7 @@
   <simpara>
    Recupera el componente userinfo normalizado.
   </simpara>
+  &uri.normalization;
  </refsect1>
 
  <refsect1 role="parameters">

diff --git a/reference/uri/uri/rfc3986/uri/getusername.xml b/reference/uri/uri/rfc3986/uri/getusername.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 39596f1226fd3b502bfbba09068ad6701235426f Maintainer: lacatoire Status: ready -->
+<!-- EN-Revision: 9bf8b904f30d04adcccd3e202c9e870b79284789 Maintainer: lacatoire Status: ready -->
 <refentry xml:id="uri-rfc3986-uri.getusername" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
   <refname>Uri\Rfc3986\Uri::getUsername</refname>
@@ -16,6 +16,7 @@
    Recupera la parte del nombre de usuario normalizado (el texto antes del primer carácter <literal>:</literal>)
    del componente userinfo.
   </simpara>
+  &uri.normalization;
  </refsect1>
 
  <refsect1 role="parameters">

diff --git a/reference/uri/uri/rfc3986/uri/parse.xml b/reference/uri/uri/rfc3986/uri/parse.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 8e2cfbdce0cd028a6521c6e073f148e0f7efac7c Maintainer: lacatoire Status: ready -->
+<!-- EN-Revision: 9bf8b904f30d04adcccd3e202c9e870b79284789 Maintainer: lacatoire Status: ready -->
 <refentry xml:id="uri-rfc3986-uri.parse" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
   <refname>Uri\Rfc3986\Uri::parse</refname>
@@ -57,14 +57,14 @@
    <programlisting role="php">
 <![CDATA[
 <?php
+
 $uri = \Uri\Rfc3986\Uri::parse("https://example.com");
 
 if ($uri !== null) {
     echo "Valid URI: " . $uri->toString();
 } else {
     echo "Invalid URI";
 }
-?>
 ]]>
    </programlisting>
    &example.outputs;

diff --git a/reference/uri/uri/rfc3986/uri/resolve.xml b/reference/uri/uri/rfc3986/uri/resolve.xml
@@ -1,9 +1,9 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 39596f1226fd3b502bfbba09068ad6701235426f Maintainer: lacatoire Status: ready -->
+<!-- EN-Revision: 9bf8b904f30d04adcccd3e202c9e870b79284789 Maintainer: lacatoire Status: ready -->
 <refentry xml:id="uri-rfc3986-uri.resolve" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
   <refname>Uri\Rfc3986\Uri::resolve</refname>
-  <refpurpose>Resuelve una URI con el objeto actual como URL base</refpurpose>
+  <refpurpose>Resuelve una URI con el objeto actual como URI base</refpurpose>
  </refnamediv>
 
  <refsect1 role="description">
@@ -13,7 +13,7 @@
    <methodparam><type>string</type><parameter>uri</parameter></methodparam>
   </methodsynopsis>
   <simpara>
-   Resuelve una URI - que puede ser potencialmente una referencia relativa - con el objeto actual como URL base.
+   Resuelve una URI - que puede ser potencialmente una referencia relativa - con el objeto actual como URI base.
   </simpara>
  </refsect1>
 
@@ -50,11 +50,11 @@
    <programlisting role="php">
 <![CDATA[
 <?php
+
 $uri = new \Uri\Rfc3986\Uri("https://example.com");
 $uri = $uri->resolve("/foo");
 
 echo $uri->toRawString();
-?>
 ]]>
    </programlisting>
    &example.outputs;

diff --git a/reference/uri/uri/rfc3986/uri/torawstring.xml b/reference/uri/uri/rfc3986/uri/torawstring.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 39596f1226fd3b502bfbba09068ad6701235426f Maintainer: lacatoire Status: ready -->
+<!-- EN-Revision: 9bf8b904f30d04adcccd3e202c9e870b79284789 Maintainer: lacatoire Status: ready -->
 <refentry xml:id="uri-rfc3986-uri.torawstring" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
   <refname>Uri\Rfc3986\Uri::toRawString</refname>
@@ -15,6 +15,12 @@
   <simpara>
    Recompone la URI sin procesar (no normalizada) en un &string;.
   </simpara>
+  &uri.non-normalization;
+  <simpara>
+   Un host IPv6 constituye una excepción: se recompone a partir de su forma
+   analizada y, por lo tanto, se devuelve completamente expandido y en
+   minúsculas, independientemente de la notación utilizada en la entrada.
+  </simpara>
  </refsect1>
 
  <refsect1 role="parameters">
@@ -25,7 +31,7 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <simpara>
-   Devuelve la URI recompuesta sin procesar (no normalizada) como un &string;.
+   Devuelve la URI recompuesta sin procesar como un &string;.
   </simpara>
  </refsect1>