doc-fr/reference/stream/functions/stream-socket-client.xml

<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.12 $ -->
<!-- EN-Revision: 1.12 Maintainer: didou Status: ready -->
  <refentry id="function.stream-socket-client">
   <refnamediv>
    <refname>stream_socket_client</refname>
    <refpurpose>
     Ouvre une connexion socket Internet ou Unix
    </refpurpose> 
   </refnamediv>
   <refsect1>
    <title>Description</title>
     <methodsynopsis>
      <type>resource</type><methodname>stream_socket_client</methodname>
      <methodparam><type>string</type><parameter>remote_socket</parameter></methodparam>
      <methodparam choice="opt"><type>int</type><parameter>&amp;errno</parameter></methodparam>
      <methodparam choice="opt"><type>string</type><parameter>&amp;errstr</parameter></methodparam>
      <methodparam choice="opt"><type>float</type><parameter>timeout</parameter></methodparam>
      <methodparam choice="opt"><type>int</type><parameter>flags</parameter></methodparam>
      <methodparam choice="opt"><type>resource</type><parameter>context</parameter></methodparam>
     </methodsynopsis>
    <para>
     <function>stream_socket_client</function> initie un flux ou une connexion
     datagramme avec la destination <parameter>remote_socket</parameter>. Le type
     de socket créé est déterminé par le transport spécifié avec le formatage
     URL suivant : <literal>transport://target</literal>. Pour une socket Internet,
     (<constant>AF_INET</constant>) comme TCP et UDP, la <literal>cible</literal> 
     de <parameter>remote_socket</parameter> sera une adresse IP ou un nom d'hôte.
     Pour une socket Unix,la <literal>cible</literal> doit être un fichier de
     socket du système.
    </para>
    <para>
     Le paramètre optionnel <parameter>timeout</parameter> sert à imposer un
     délai d'expiration, en secondes, à l'appel système.
    </para>
    <para>
     <parameter>flags</parameter> est un champ de bits qui peut être la combinaison
     de n'importe quelle option de connexion. Actuellement, les valeurs possibles
     pour ces options sont <constant>STREAM_CLIENT_ASYNC_CONNECT</constant> (défaut), 
     <constant>STREAM_CLIENT_ASYNC_CONNECT</constant> et
     <constant>STREAM_CLIENT_PERSISTENT</constant>.
    </para>
    <note>
     <simpara>
      Si vous n'avez pas besoin de mettre de délai d'expiration pour les opérations
      via la socket, utilisez la fonction <function>stream_set_timeout</function>, 
      car <parameter>timeout</parameter> de <function>stream_socket_client</function> 
      ne s'applique que lors de la connexion à la socket.
     </simpara>
    </note>
    <para>
     <function>stream_socket_client</function> retourne une ressource de flux,
     qui peut être utilisée avec d'autres fonctions de fichiers, comme
     <function>fgets</function>, <function>fgetss</function>,
     <function>fputs</function>, <function>fclose</function> et
     <function>feof</function>).
    </para>
    <para>
     Si l'appel échoue, <function>stream_socket_client</function> va retourner
     &false; et si les paramètres optionnels <parameter>errno</parameter> et
     <parameter>errstr</parameter> sont fournis, ils recevront l'erreur
     exacte qui est survenue dans le système lors de l'appel à 
     <literal>connect()</literal>. Si la valeur retournée dans
     <parameter>errno</parameter> est &zero; et que la fonction
     a retournée &false;, c'est une indication que l'erreur est survenue
     avant l'appel à <literal>connect()</literal>. Cela est probablement du
     à un problème d'initialisation de la socket. Notez que 
     <parameter>errno</parameter> et<parameter>errstr</parameter> 
     doivent être passés par référence.
    </para>
    <para>
     Suivant votre environnement, les sockets Unix ou le délai d'expiration
     peuvent ne pas être disponibles. Une liste des transports disponibles
     sur le système est accessible via <function>stream_get_transports</function>.
     Voyez <xref linkend="transports"/> pour une liste de transports natifs.
    </para>
    <para>
     Le flux sera par défaut ouvert en mode bloquant. Vous pouvez le passer
     en mode non bloquant en utilisant la fonction 
     <function>stream_set_blocking</function>.
     <example>
      <title>Exemple avec <function>stream_socket_client</function></title>
      <programlisting role="php">
<![CDATA[
<?php
$fp = stream_socket_client("tcp://www.example.com:80", $errno, $errstr, 30);
if (!$fp) {
    echo "$errstr ($errno)<br />\n";
} else {
    fputs($fp, "GET / HTTP/1.0\r\nHost: www.example.com\r\nAccept: */*\r\n\r\n");
    while (!feof($fp)) {
        echo fgets ($fp,1024);
    }
    fclose($fp);
}
?>
]]>
      </programlisting>
     </example>
     L'exemple ci-dessous vous montre comment lire la date et l'heure
     sur un service UDP de type "<literal>daytime</literal>" (port 13) 
     sur votre propre machine : 
     <example>
     <title>Utilisation de connexions UDP</title>
     <programlisting role="php">
<![CDATA[
<?php
$fp = stream_socket_client("udp://127.0.0.1:13", $errno, $errstr);
if (!$fp) {
    echo "ERREUR : $errno - $errstr<br />\n";
} else {
    fwrite($fp,"\n");
    echo fread($fp, 26);
    fclose($fp);
}
?>
]]>
     </programlisting>
     </example>
     <warning>
      <simpara>
       Les sockets UDP sembleront parfois s'ouvrir sans erreur, même si l'hôte
       distant n'est pas accessible. Cette erreur ne deviendra apparente que
       lorsque vous essaierez de lire ou écrire des données avec cette
       socket. La raison à cela est que UDP est un protocole sans connexion,
       ce qui signifie que le système d'exploitation n'a pas à établir de
       lien pour la socket, jusqu'à ce qu'il commence à échanger des données.
      </simpara>
     </warning>
    </para>
     &ipv6.brackets;
    <para>
     Voir aussi
     <function>stream_socket_server</function>, 
     <function>stream_set_blocking</function>,
     <function>stream_set_timeout</function>, 
     <function>fgets</function>,
     <function>fgetss</function>, 
     <function>fputs</function>,
     <function>fclose</function>, 
     <function>feof</function> et
     l'<link linkend="ref.curl">extension CURL</link>.
    </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:"../../../../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
-->