Feature/add faq translations

appendices/examples.xml

@@ -0,0 +1,38 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- EN-Revision: bce2cb849721c70737eb32ce958131e22677770c Maintainer: lacatoire Status: ready -->
+<appendix xml:id="examples" xmlns="http://docbook.org/ns/docbook">
+ <title>Informazioni sugli esempi del manuale</title>
+ <simpara>
+  Si noti che molti esempi nella documentazione PHP omettono la gestione
+  di errori ed eccezioni per chiarezza e brevità.
+ </simpara>
+ <simpara>
+  Questo non significa che la gestione degli errori debba essere omessa nel codice di produzione
+  poiché ciò può portare al lancio di <exceptionname>TypeError</exceptionname>,
+  alla conversione di valori di fallimento, come &false; in una stringa vuota,
+  o alla violazione di assunzioni che potrebbero causare bug difficili da tracciare.
+  Alcune estensioni forniscono esempi completi in cui è inclusa la gestione degli errori
+  per dimostrare l'uso corretto delle varie funzioni e metodi forniti
+  dall'estensione.
+ </simpara>
+</appendix>
+<!-- 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
+-->

appendices/transports.xml

@@ -0,0 +1,142 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- EN-Revision: 1268a5eebbd09dbc4c4d5272c2bcdc0b035c256c Maintainer: lacatoire Status: ready -->
+<appendix xml:id="transports" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
+ <title>Elenco dei Trasporti Socket Supportati</title>
+ <para>
+  Di seguito è riportato un elenco dei vari trasporti socket in stile URL
+  che PHP ha integrati per l'uso con le funzioni socket basate sugli stream
+  come <function>fsockopen</function> e
+  <function>stream_socket_client</function>. Questi trasporti
+  <emphasis>non</emphasis> si applicano alle
+  <link linkend="ref.sockets">Funzioni Socket</link> dell'estensione Sockets.
+ </para>
+
+ <para>
+  Per un elenco dei trasporti installati nella tua versione di
+  PHP usa <function>stream_get_transports</function>.
+ </para>
+
+ <section xml:id="transports.inet">
+  <title>Dominio Internet: TCP, UDP, SSL e TLS</title>
+  <simpara>
+   <literal>ssl://</literal>, <literal>tls://</literal>,
+   <literal>sslv2://</literal> &amp; <literal>sslv3://</literal>.
+  </simpara>
+
+  <note>
+   <simpara>
+    Se non viene specificato alcun trasporto, verrà assunto <literal>tcp://</literal>.
+   </simpara>
+  </note>
+
+  <itemizedlist>
+   <listitem><simpara><literal>127.0.0.1</literal></simpara></listitem>
+   <listitem><simpara><literal>fe80::1</literal></simpara></listitem>
+   <listitem><simpara><literal>www.example.com</literal></simpara></listitem>
+   <listitem><simpara><literal>tcp://127.0.0.1</literal></simpara></listitem>
+   <listitem><simpara><literal>tcp://fe80::1</literal></simpara></listitem>
+   <listitem><simpara><literal>tcp://www.example.com</literal></simpara></listitem>
+   <listitem><simpara><literal>udp://www.example.com</literal></simpara></listitem>
+   <listitem><simpara><literal>ssl://www.example.com</literal></simpara></listitem>
+   <listitem><simpara><literal>sslv2://www.example.com</literal></simpara></listitem>
+   <listitem><simpara><literal>sslv3://www.example.com</literal></simpara></listitem>
+   <listitem><simpara><literal>tls://www.example.com</literal></simpara></listitem>
+  </itemizedlist>
+
+  <simpara>
+   I socket del dominio Internet si aspettano un numero di porta oltre
+   a un indirizzo di destinazione. Nel caso di <function>fsockopen</function>
+   questo è specificato in un secondo parametro e quindi non
+   influisce sulla formattazione dell'URL del trasporto. Con
+   <function>stream_socket_client</function> e funzioni correlate,
+   come con gli URL tradizionali, il numero di porta è specificato
+   come suffisso dell'URL del trasporto delimitato da due punti.
+  </simpara>
+
+  <itemizedlist>
+   <listitem><simpara><literal>tcp://127.0.0.1:80</literal></simpara></listitem>
+   <listitem><simpara><literal>tcp://[fe80::1]:80</literal></simpara></listitem>
+   <listitem><simpara><literal>tcp://www.example.com:80</literal></simpara></listitem>
+  </itemizedlist>
+
+  <note>
+   <title>Indirizzi IPv6 numerici con numeri di porta</title>
+   <simpara>
+    Nel secondo esempio sopra, mentre gli esempi IPv4 e hostname
+    sono lasciati intatti a parte l'aggiunta dei
+    due punti e del numero di porta, l'indirizzo IPv6 è racchiuso tra
+    parentesi quadre: <literal>[fe80::1]</literal>. Questo serve a
+    distinguere tra i due punti usati in un indirizzo IPv6 e
+    i due punti usati per delimitare il numero di porta.
+   </simpara>
+  </note>
+
+  <simpara>
+   I trasporti <literal>ssl://</literal> e <literal>tls://</literal>
+   (disponibili solo quando il supporto openssl è compilato in PHP) sono estensioni
+   del trasporto <literal>tcp://</literal> che includono la crittografia SSL.
+  </simpara>
+
+  <simpara>
+   <literal>ssl://</literal> tenterà di negoziare una connessione SSL V2
+   o SSL V3 a seconda delle capacità e delle preferenze
+   dell'host remoto. <literal>sslv2://</literal> e
+   <literal>sslv3://</literal> selezioneranno il protocollo SSL V2 o SSL V3
+   esplicitamente.
+  </simpara>
+ </section>
+
+ <section xml:id="transports.unix">
+  <title>Dominio Unix: Unix e UDG</title>
+  <simpara>
+   <literal>unix://</literal> e
+   <literal>udg://</literal>.
+  </simpara>
+
+  <itemizedlist>
+   <listitem><simpara><literal>unix:///tmp/mysock</literal></simpara></listitem>
+   <listitem><simpara><literal>udg:///tmp/mysock</literal></simpara></listitem>
+  </itemizedlist>
+
+  <simpara>
+   <literal>unix://</literal> fornisce accesso a una connessione stream socket
+   nel dominio Unix. <literal>udg://</literal> fornisce
+   un trasporto alternativo a un socket del dominio Unix usando il protocollo
+   user datagram.
+  </simpara>
+
+  <simpara>
+   I socket del dominio Unix, a differenza dei socket del dominio Internet, non si aspettano
+   un numero di porta. Nel caso di <function>fsockopen</function> il
+   parametro <parameter>portno</parameter> dovrebbe essere impostato a 0.
+  </simpara>
+
+  <note>
+   <simpara>
+    I socket del dominio Unix non sono supportati su Windows.
+   </simpara>
+  </note>
+ </section>
+
+</appendix>
+
+<!-- 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
+-->