archived-doc-fr/appendices/transports.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: ae90ecc9328f3abea16a9af69a5f18b24d530832 Maintainer: lacatoire 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> aux
  <link linkend="ref.sockets">fonctions de socket</link> de l'extension Sockets.
 </para>

 <para>
  Pour connaître la liste des modes de transport installés sur la version
  de PHP utilisée, se servir de <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>
    Les transports <literal>sslv2://</literal> et <literal>sslv3://</literal>
    sont obsolètes et ne devraient pas être utilisés. Ils ne sont documentés
    que pour des raisons de rétrocompatibilité.
   </simpara>
  </note>

  <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>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> tente de négocier une connexion SSL/TLS sécurisée
   en fonction des capacités et des préférences du client et de l'hôte distant.
   Les protocoles effectivement utilisés sont déterminés par la configuration
   d'OpenSSL et par les options fournies via
   <function>stream_context_create</function>, telles que
   <literal>ssl.crypto_method</literal>.
  </simpara>

  <simpara>
   Les protocoles SSLv2 et SSLv3 sont obsolètes et non sécurisés. Leur
   utilisation est fortement déconseillée et ils ne sont plus activés par
   défaut dans les versions modernes de PHP et d'OpenSSL.
  </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
-->