Skip to content

Add translation for context streams (http, socket, ssl) #141

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

Add translation for context streams (http, socket, ssl) #141

Show file tree
Hide file tree
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
342 changes: 342 additions & 0 deletions language/context/http.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,342 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 3abd17e61d5022d503604cc06894254e3281acf5 Maintainer: lacatoire Status: ready -->

<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">
<refnamediv>
<refname>Opzioni di contesto HTTP</refname>
<refpurpose>Elenco delle opzioni di contesto HTTP</refpurpose>
</refnamediv>

<refsect1 role="description">
&reftitle.description;
<para>
Opzioni di contesto per i trasporti <literal>http://</literal> e <literal>https://</literal>.
</para>
</refsect1>

<refsect1 role="options"><!-- {{{ -->
&reftitle.options;
<para>
<variablelist>
<varlistentry xml:id="context.http.method">
<term>
<parameter>method</parameter>
<type>string</type>
</term>
<listitem>
<para>
<constant>GET</constant>, <constant>POST</constant>, o
qualsiasi altro metodo HTTP supportato dal server remoto.
</para>
<para>
Il valore predefinito è <constant>GET</constant>.
</para>
</listitem>
</varlistentry>
<varlistentry xml:id="context.http.header">
<term>
<parameter>header</parameter>
<type>array</type> o <type>string</type>
</term>
<listitem>
<para>
Intestazioni aggiuntive da inviare durante la richiesta. I valori
in questa opzione sovrascriveranno altri valori (come
<literal>User-agent:</literal>, <literal>Host:</literal>,
e <literal>Authentication:</literal>),
anche quando si seguono i reindirizzamenti <literal>Location:</literal>.
Pertanto non è consigliato impostare un'intestazione <literal>Host:</literal>,
se <parameter>follow_location</parameter> è abilitato.
</para>
<para>
Il valore stringa deve essere costituito da coppie <literal>Chiave: valore</literal> delimitate da
<literal>\r\n</literal>, ad es.
<literal>"Content-Type: application/json\r\nConnection: close"</literal>.
Il valore array deve essere un elenco di coppie <literal>Chiave: valore</literal>, ad es.
<literal>["Content-Type: application/json", "Connection: close"]</literal>.
</para>
</listitem>
</varlistentry>
<varlistentry xml:id="context.http.user-agent">
<term>
<parameter>user_agent</parameter>
<type>string</type>
</term>
<listitem>
<para>
Valore da inviare con l'intestazione <literal>User-Agent:</literal>. Questo valore verrà
utilizzato solo se user-agent <emphasis>non</emphasis> è specificato
nell'opzione di contesto <literal>header</literal> sopra indicata.
</para>
<para>
Per impostazione predefinita viene utilizzata l'impostazione
<link linkend="ini.user-agent">user_agent</link>
del &php.ini;.
</para>
</listitem>
</varlistentry>
<varlistentry xml:id="context.http.content">
<term>
<parameter>content</parameter>
<type>string</type>
</term>
<listitem>
<para>
Dati aggiuntivi da inviare dopo le intestazioni. Generalmente utilizzato
con le richieste POST o PUT.
</para>
</listitem>
</varlistentry>
<varlistentry xml:id="context.http.proxy">
<term>
<parameter>proxy</parameter>
<type>string</type>
</term>
<listitem>
<para>
URI che specifica l'indirizzo del server proxy (ad es.
<literal>tcp://proxy.example.com:5100</literal>).
</para>
</listitem>
</varlistentry>
<varlistentry xml:id="context.http.request-fulluri">
<term>
<parameter>request_fulluri</parameter>
<type>bool</type>
</term>
<listitem>
<para>
Quando impostato a &true;, l'intero URI verrà utilizzato nella
costruzione della richiesta (ad es.
<literal>GET http://www.example.com/path/to/file.html HTTP/1.0</literal>).
Sebbene questo sia un formato di richiesta non standard, alcuni
server proxy lo richiedono.
</para>
<para>
Il valore predefinito è &false;.
</para>
</listitem>
</varlistentry>
<varlistentry xml:id="context.http.follow-location">
<term>
<parameter>follow_location</parameter>
<type>int</type>
</term>
<listitem>
<para>
Segue i reindirizzamenti dell'intestazione <literal>Location</literal>. Impostare a
<literal>0</literal> per disabilitare.
</para>
<para>
Il valore predefinito è <literal>1</literal>.
</para>
</listitem>
</varlistentry>
<varlistentry xml:id="context.http.max-redirects">
<term>
<parameter>max_redirects</parameter>
<type>int</type>
</term>
<listitem>
<para>
Il numero massimo di reindirizzamenti da seguire. Il valore <literal>1</literal> o
inferiore significa che non vengono seguiti reindirizzamenti.
</para>
<para>
Il valore predefinito è <literal>20</literal>.
</para>
</listitem>
</varlistentry>
<varlistentry xml:id="context.http.protocol-version">
<term>
<parameter>protocol_version</parameter>
<type>float</type>
</term>
<listitem>
<para>
Versione del protocollo HTTP.
</para>
<para>
Il valore predefinito è <literal>1.1</literal> a partire da PHP 8.0.0;
nelle versioni precedenti il valore predefinito era <literal>1.0</literal>.
</para>
</listitem>
</varlistentry>
<varlistentry xml:id="context.http.timeout">
<term>
<parameter>timeout</parameter>
<type>float</type>
</term>
<listitem>
<para>
Timeout di lettura in secondi, specificato come <type>float</type>
(ad es. <literal>10.5</literal>).
</para>
<para>
Per impostazione predefinita viene utilizzata l'impostazione
<link linkend="ini.default-socket-timeout">default_socket_timeout</link>
del &php.ini;.
</para>
</listitem>
</varlistentry>
<varlistentry xml:id="context.http.ignore-errors">
<term>
<parameter>ignore_errors</parameter>
<type>bool</type>
</term>
<listitem>
<para>
Recupera il contenuto anche in caso di codici di stato di errore.
</para>
<para>
Il valore predefinito è &false;.
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1><!-- }}} -->

<refsect1 role="examples"><!-- {{{ -->
&reftitle.examples;
<para>
<example xml:id="context.http.example-post"><!-- {{{ -->
<title>Recuperare una pagina e inviare dati POST</title>
<programlisting role="php">
<![CDATA[
<?php

$postdata = http_build_query(
[
'var1' => 'some content',
'var2' => 'doh',
]
);

$opts = [
'http' => [
'method' => 'POST',
'header' => 'Content-type: application/x-www-form-urlencoded',
'content' => $postdata,
]
];

$context = stream_context_create($opts);

$result = file_get_contents('http://example.com/submit.php', false, $context);

?>
]]>
</programlisting>
</example><!-- }}} -->
</para>
<para>
<example xml:id="context.http.example-fetch-ignore-redirect"><!-- {{{ -->
<title>Ignorare i reindirizzamenti ma recuperare intestazioni e contenuto</title>
<programlisting role="php">
<![CDATA[
<?php

$url = "http://www.example.org/header.php";

$opts = [
'http' => [
'method' => 'GET',
'max_redirects' => '0',
'ignore_errors' => '1',
]
];

$context = stream_context_create($opts);
$stream = fopen($url, 'r', false, $context);

// informazioni sulle intestazioni e metadati
// dello stream
var_dump(stream_get_meta_data($stream));

// dati effettivi all'URL $url
var_dump(stream_get_contents($stream));
fclose($stream);
?>
]]>
</programlisting>
</example><!-- }}} -->
</para>
</refsect1><!-- }}} -->

<refsect1 role="notes">
&reftitle.notes;
<note>
<title>Opzioni di contesto del socket sottostante</title>
<simpara>
Opzioni di contesto aggiuntive possono essere supportate dal
<link linkend="transports.inet">trasporto sottostante</link>.
Per gli stream <literal>http://</literal>, fare riferimento alle opzioni
di contesto per il trasporto <literal>tcp://</literal>. Per gli
stream <literal>https://</literal>, fare riferimento alle opzioni di contesto
per il trasporto <literal>ssl://</literal>.
</simpara>
</note>
<note>
<title>Riga di stato HTTP</title>
<simpara>
Quando questo wrapper dello stream segue un reindirizzamento, il
<literal>wrapper_data</literal> restituito da
<function>stream_get_meta_data</function> potrebbe non contenere necessariamente
la riga di stato HTTP che si applica effettivamente ai dati del contenuto all'indice
<literal>0</literal>.
</simpara>
<screen>
<![CDATA[
array (
'wrapper_data' =>
array (
0 => 'HTTP/1.0 301 Moved Permanently',
1 => 'Cache-Control: no-cache',
2 => 'Connection: close',
3 => 'Location: http://example.com/foo.jpg',
4 => 'HTTP/1.1 200 OK',
...
]]>
</screen>
<simpara>
La prima richiesta ha restituito un <literal>301</literal> (reindirizzamento permanente),
quindi il wrapper dello stream ha seguito automaticamente il reindirizzamento per ottenere una
risposta <literal>200</literal> (indice = <literal>4</literal>).
</simpara>
</note>
</refsect1>

<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><xref linkend="wrappers.http" /></member>
<member><xref linkend="context.socket" /></member>
<member><xref linkend="context.ssl" /></member>
</simplelist>
</para>
</refsect1>

</refentry>

<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->
Loading