Skip to content

[Sync-En] context.http: document the uri_parser_class option added in PHP 8.5 #1281

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

Open
lacatoire wants to merge 1 commit into
base: master
Choose a base branch
from
Open

[Sync-En] context.http: document the uri_parser_class option added in PHP 8.5 #1281

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
76 changes: 59 additions & 17 deletions language/context/http.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: 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">
Expand All @@ -16,7 +16,7 @@
</para>
</refsect1>

<refsect1 role="options"><!-- {{{ -->
<refsect1 role="options">
&reftitle.options;
<para>
<variablelist>
Expand Down Expand Up @@ -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>
Expand All @@ -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>
Expand Down Expand Up @@ -196,22 +196,64 @@
</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[
<?php

$postdata = http_build_query(
[
'var1' => 'du contenu',
'var1' => 'algún contenido',
'var2' => 'doh',
]
);
Expand All @@ -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[
Expand All @@ -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;
Expand All @@ -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>
Expand Down