doc-fr/appendices/transports.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: aab33d644359aba597e810e2fc0c0caa0d347c9c Maintainer: yannick Status: ready -->
<!-- Reviewed: yes -->

<appendix xml:id="transports" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
 <title>Liste des modes de transport de sockets disponibles</title>
 <para>
  Voici la liste des différents modes de transport, format URL, dont
  PHP dispose en interne pour les flux qui exploitent les sockets, tels
  que <function>fsockopen</function> et
  <function>stream_socket_client</function>. Ces modes de transport
  <emphasis>ne s'appliquent pas</emphasis> à l'extension
  <link linkend="ref.sockets">sockets</link>.
 </para>

 <para>
  Pour connaître la liste des modes de transport installés sur votre version
  de PHP, utilisez <function>stream_get_transports</function>.
 </para>

 <section xml:id="transports.inet">
  <title>Domaines Internet : TCP, UDP, SSL et TLS</title>
  <simpara>
   <literal>ssl://</literal>, <literal>tls://</literal>,
   <literal>sslv2://</literal> &amp; <literal>sslv3://</literal>.
  </simpara>

  <note>
   <simpara>
    Si aucun transport n'est spécifié, <literal>tcp://</literal>
    est utilisé.
   </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>
   Les sockets du domaine Internet utilisent un numéro de port en plus
   de l'adresse de l'hôte. Dans le cas de <function>fsockopen</function>,
   il est spécifié en deuxième paramètre et, donc, n'a pas d'impact
   sur le format du mode de transport. Avec <function>stream_socket_client</function>
   et les autres fonctions de la même famille, le numéro de port est
   spécifié comme un suffixe dans l'URL de transport,
   identifié par le signe deux-points.
  </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>Adresse IPv6 et numéro de port</title>
   <simpara>
    Dans le deuxième exemple ci-dessus, les exemples en IPv4 et les
    noms d'hôtes sont identiques, mais les IPv6 sont placées entre
    crochets, en plus d'avoir les deux-points et le numéro de port :
    <literal>[fe80::1]</literal>. Cela permet de distinguer les deux-points
    utilisés en IPv6 et le deux-points utilisés pour délimiter
    le numéro de port.
   </simpara>
  </note>

  <simpara>
   Les modes <literal>ssl://</literal> et <literal>tls://</literal>
   (disponibles uniquement lorsque le support OpenSSl est compilé avec PHP) sont
   des extensions de <literal>tcp://</literal> qui incluent le chiffrement SSL.
  </simpara>

  <simpara>
   <literal>ssl://</literal> va tenter de négocier une connexion SSL V2 ou SSL V3,
   suivant les capacités et les références de l'hôte distant. <literal>sslv2://</literal> et
   <literal>sslv3://</literal> sélectionnent explicitement le protocole.
  </simpara>
 </section>

 <section xml:id="transports.unix">
  <title>Domaine Unix : UNIX et UDG</title>
  <simpara>
   <literal>unix://</literal> et
   <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> fournit l'accès à un flux de type socket, sur
   un domaine Unix. <literal>udg://</literal> fournit un mode de transport
   alternatif, avec un protocole de datagrammes utilisateurs.
  </simpara>

  <simpara>
   Les sockets du domaine Unix, contrairement à celles du domaine Internet,
   n'utilisent pas de numéro de port. Dans ce cas, le paramètre
   <parameter>portno</parameter> de <function>fsockopen</function> doit valoir 0.
  </simpara>

  <note>
   <simpara>
    Les sockets du domaine Unix ne sont pas supportés sur 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
-->