From c07ed600658717ac0290d96be77824c399c26d63 Mon Sep 17 00:00:00 2001
From: lacatoire <la.catoire@gmail.com>
Date: Tue, 8 Sep 2026 09:36:35 +0200
Subject: [PATCH] [Sync-En] context.http: document the uri_parser_class option
 added in PHP 8.5

---
 language/context/http.xml | 76 ++++++++++++++++++++++++++++++---------
 1 file changed, 59 insertions(+), 17 deletions(-)

diff --git a/language/context/http.xml b/language/context/http.xml
index d0b9de1ad3..86d4a6ae50 100644
--- a/language/context/http.xml
+++ b/language/context/http.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 3abd17e61d5022d503604cc06894254e3281acf5 Maintainer: PhilDaiguille Status: ready -->
+<!-- EN-Revision: aa42c6da04101f58317a901ccc38ee0d1faeab47 Maintainer: PhilDaiguille Status: ready -->
 <!-- Reviewed: no -->
 
 <refentry xml:id="context.http" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" annotations="verify_info:false" role="stream_context_option">
@@ -16,7 +16,7 @@
   </para>
  </refsect1>
 
- <refsect1 role="options"><!-- {{{ -->
+ <refsect1 role="options">
   &reftitle.options;
   <para>
    <variablelist>
@@ -52,10 +52,10 @@
        está activado.
       </para>
       <para>
-       Una cadena debe contener pares <literal>Clave : valor</literal>
-       delimitados por <literal>\r\n</literal>, por ejemplo :
+       Una cadena debe contener pares <literal>Clave: valor</literal>
+       delimitados por <literal>\r\n</literal>, por ejemplo:
        <literal>"Content-Type: application/json\r\nConnection: close"</literal>.
-       Un array debe contener una lista de pares <literal>Clave : valor</literal>, por ejemplo :
+       Un array debe contener una lista de pares <literal>Clave: valor</literal>, por ejemplo:
        <literal>["Content-Type: application/json", "Connection: close"]</literal>.
       </para>
      </listitem>
@@ -68,7 +68,7 @@
      <listitem>
       <para>
        Valor a enviar con el encabezado <literal>User-Agent:</literal>. Este valor
-       solo debe ser utilizado si el agente de usuario <emphasis>no</emphasis> está
+       solo se utilizará si el agente de usuario <emphasis>no</emphasis> está
        especificado en la opción de contexto <literal>header</literal> anterior.
       </para>
       <para>
@@ -196,14 +196,56 @@
       </para>
      </listitem>
     </varlistentry>
+    <varlistentry xml:id="context.http.uri-parser-class">
+     <term>
+      <parameter>uri_parser_class</parameter>
+      <type>string</type> o <type>null</type>
+     </term>
+     <listitem>
+      <simpara>
+       La clase a utilizar para analizar las URI. Cuando esta opción vale
+       &null;, se utiliza el comportamiento histórico basado en
+       <function>parse_url</function>. Los valores aceptados son
+       <classname>Uri\Rfc3986\Uri</classname> (analizador conforme a la
+       RFC 3986) y <classname>Uri\WhatWg\Url</classname> (analizador conforme
+       al estándar WHATWG URL). Las implementaciones personalizadas escritas en
+       PHP no están soportadas.
+      </simpara>
+      <simpara>
+       Por omisión, vale &null;.
+      </simpara>
+     </listitem>
+    </varlistentry>
    </variablelist>
   </para>
- </refsect1><!-- }}} -->
+ </refsect1>
+
+ <refsect1 role="changelog">
+  &reftitle.changelog;
+  <informaltable>
+   <tgroup cols="2">
+    <thead>
+     <row>
+      <entry>&Version;</entry>
+      <entry>&Description;</entry>
+     </row>
+    </thead>
+    <tbody>
+     <row>
+      <entry>8.5.0</entry>
+      <entry>
+       Se añadió la opción <parameter>uri_parser_class</parameter>.
+      </entry>
+     </row>
+    </tbody>
+   </tgroup>
+  </informaltable>
+ </refsect1>
 
- <refsect1 role="examples"><!-- {{{ -->
+ <refsect1 role="examples">
   &reftitle.examples;
   <para>
-   <example xml:id="context.http.example-post"><!-- {{{ -->
+   <example xml:id="context.http.example-post">
     <title>Obtención de una página y envío de datos POST</title>
     <programlisting role="php">
 <![CDATA[
@@ -211,7 +253,7 @@
 
 $postdata = http_build_query(
     [
-        'var1' => 'du contenu',
+        'var1' => 'algún contenido',
         'var2' => 'doh',
     ]
 );
@@ -231,10 +273,10 @@ $result = file_get_contents('http://example.com/submit.php', false, $context);
 ?>
 ]]>
     </programlisting>
-   </example><!-- }}} -->
+   </example>
   </para>
   <para>
-   <example xml:id="context.http.example-fetch-ignore-redirect"><!-- {{{ -->
+   <example xml:id="context.http.example-fetch-ignore-redirect">
     <title>Ignora las redirecciones pero obtiene los encabezados y el contenido</title>
     <programlisting role="php">
 <![CDATA[
@@ -256,15 +298,15 @@ $stream = fopen($url, 'r', false, $context);
 // información sobre los encabezados y metadatos del flujo
 var_dump(stream_get_meta_data($stream));
 
-// datos actuales de $url
+// datos reales de $url
 var_dump(stream_get_contents($stream));
 fclose($stream);
 ?>
 ]]>
     </programlisting>
-   </example><!-- }}} -->
+   </example>
   </para>
- </refsect1><!-- }}} -->
+ </refsect1>
 
  <refsect1 role="notes">
   &reftitle.notes;
@@ -284,8 +326,8 @@ fclose($stream);
    <title>Línea de estado HTTP</title>
    <simpara>
     Cuando este manejador de flujo sigue una redirección,
-    <literal>wrapper_data</literal>, devuelto por la función
-    <function>stream_get_meta_data</function> no debe contener
+    el <literal>wrapper_data</literal> devuelto por la función
+    <function>stream_get_meta_data</function> podría no contener
     necesariamente la línea de estado HTTP que se aplica a los
     datos de contenido en el índice <literal>0</literal>.
    </simpara>