cvs: phpdoc-fr /reference/stream/functions stream-socket-client.xml
| From: | Yannick Torres | Date: | Mon, 09 Feb 2009 07:24:30 +0000 |
| Subject: | cvs: phpdoc-fr /reference/stream/functions stream-socket-client.xml | ||
| Groups: | php.doc.fr | ||
| Request: | Send a blank email to doc-fr+get-6607@lists.php.net to get a copy of this message | ||
yannick Mon Feb 9 07:24:30 2009 UTC
Modified files:
/phpdoc-fr/reference/stream/functions stream-socket-client.xml
Log:
sync with EN
http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/stream/functions/stream-socket-client.xml?r1=1.21&r2=1.22&diff_format=u Index: phpdoc-fr/reference/stream/functions/stream-socket-client.xml diff -u phpdoc-fr/reference/stream/functions/stream-socket-client.xml:1.21 phpdoc-fr/reference/stream/functions/stream-socket-client.xml:1.22 --- phpdoc-fr/reference/stream/functions/stream-socket-client.xml:1.21 Sat Jan 24 20:11:59 2009 +++ phpdoc-fr/reference/stream/functions/stream-socket-client.xml Mon Feb 9 07:24:30 2009 @@ -1,16 +1,15 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.21 $ --> +<!-- $Revision: 1.22 $ --> <!-- EN-Revision: 1.18 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> <refentry xml:id="function.stream-socket-client" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>stream_socket_client</refname> - <refpurpose> - Ouvre une connexion socket Internet ou Unix - </refpurpose> + <refpurpose>Ouvre une connexion socket Internet ou Unix</refpurpose> </refnamediv> - <refsect1> + + <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>resource</type><methodname>stream_socket_client</methodname> @@ -22,43 +21,114 @@ <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éée 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> + Initie un flux ou une connexion datagramme avec la destination + <parameter>remote_socket</parameter>. Le type de socket créée est déterminé + par le transport spécifié avec le formatage URL suivant : + <literal>transport://target</literal>. Pour une socket Internet, + (AF_INET) 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. - Le paramètre optionnel <parameter>timeout</parameter> sert à imposer un - délai d'expiration, en secondes, à l'appel système. - <parameter>flags</parameter> est un champ de bits qui peut être la combinaison - de n'importe quelles options 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> - <note> - <simpara> - Le paramètre <parameter>timeout</parameter> n'est appliqué que si vous ne tentez - pas de connexion asynchrone. - </simpara> + <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>. + </para> </note> + </refsect1> + + <refsect1 role="parameters"><!-- {{{ --> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>remote_socket</parameter></term> + <listitem> + <para> + L'adresse du socket. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>errno</parameter></term> + <listitem> + <para> + Contiendra le numéro de l'erreur système si la connexion échoue. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>errstr</parameter></term> + <listitem> + <para> + Contiendra le message de l'erreur système si la connexion échoue. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>timeout</parameter></term> + <listitem> + <para> + Délai d'expiration, en secondes, pour l'appel système + <literal>connect()</literal>. + <note> + <simpara> + Ce paramètre n'est appliqué que pour les connexions + qui ne sont pas asynchrones. + </simpara> + </note> + <note> + <para> + Pour définir un délai d'expiration lors de la lecture/écriture de + données via un socket, utilisez la fonction + <function>stream_set_timeout</function>, vu que le paramètre + <parameter>timeout</parameter> n'est appliqué que lors de la connexion + au socket. + </para> + </note> + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>flags</parameter></term> + <listitem> + <para> + Champ de bits qui peut être la combinaison de n'importe quelles options + de connexion. Actuellement, les valeurs possibles pour ces options sont + <constant>STREAM_CLIENT_CONNECT</constant> (défaut), + <constant>STREAM_CLIENT_ASYNC_CONNECT</constant> et + <constant>STREAM_CLIENT_PERSISTENT</constant>. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>context</parameter></term> + <listitem> + <para> + Une ressource de contexte valide, créée par la fonction + <function>stream_context_create</function>. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1><!-- }}} --> + + <refsect1 role="returnvalues"><!-- {{{ --> + &reftitle.returnvalues; <para> - <function>stream_socket_client</function> retourne une ressource de flux, - qui peut être utilisée avec d'autres fonctions de fichiers, comme + En cas de succès, une ressource de flux est retournée, 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>). + <function>fwrite</function>, <function>fclose</function>, et + <function>feof</function>, &false; si une erreur survient. </para> + </refsect1><!-- }}} --> + + <refsect1 role="errors"><!-- {{{ --> + &reftitle.errors; <para> Si l'appel échoue, <function>stream_socket_client</function> va retourner &false; et si les paramètres optionnels <parameter>errno</parameter> et @@ -72,80 +142,96 @@ <parameter>errno</parameter> et<parameter>errstr</parameter> doivent être passés par référence. </para> + </refsect1><!-- }}} --> + + + <refsect1 role="examples"><!-- {{{ --> + &reftitle.examples; <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> + <example xml:id="stream-socket-client.example.basic"><!-- {{{ --> <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"; + 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); + fwrite($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> + </example><!-- }}} --> + <example xml:id="stream-socket-client.example.daytime"><!-- {{{ --> <title>Utilisation de connexions UDP</title> + <para> + Lit la date et l'heure sur un service UDP de type + "<literal>daytime</literal>" (port 13) sur votre propre machine : + </para> <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"; + echo "ERREUR : $errno - $errstr<br />\n"; } else { - fwrite($fp,"\n"); - echo fread($fp, 26); - fclose($fp); + 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> + </example><!-- }}} --> </para> + </refsect1><!-- }}} --> + + <refsect1 role="notes"><!-- {{{ --> + &reftitle.notes; + <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> &ipv6.brackets; + <note> + <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> + </note> + </refsect1><!-- }}} --> + + <refsect1 role="seealso"><!-- {{{ --> + &reftitle.seealso; <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>. + <simplelist> + <member><function>stream_socket_server</function></member> + <member><function>stream_set_blocking</function></member> + <member><function>stream_set_timeout</function></member> + <member><function>stream_select</function></member> + <member><function>fgets</function></member> + <member><function>fgetss</function></member> + <member><function>fwrite</function></member> + <member><function>fclose</function></member> + <member><function>feof</function></member> + <member><xref linkend="ref.curl" /></member> + </simplelist> </para> - </refsect1> + </refsect1><!-- }}} --> + </refentry> <!-- Keep this comment at the end of the file
http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/stream/functions/stream-socket-client.xml?r1=1.21&r2=1.22&diff_format=u Index: phpdoc-fr/reference/stream/functions/stream-socket-client.xml diff -u phpdoc-fr/reference/stream/functions/stream-socket-client.xml:1.21 phpdoc-fr/reference/stream/functions/stream-socket-client.xml:1.22 --- phpdoc-fr/reference/stream/functions/stream-socket-client.xml:1.21 Sat Jan 24 20:11:59 2009 +++ phpdoc-fr/reference/stream/functions/stream-socket-client.xml Mon Feb 9 07:24:30 2009 @@ -1,16 +1,15 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.21 $ --> +<!-- $Revision: 1.22 $ --> <!-- EN-Revision: 1.18 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> <refentry xml:id="function.stream-socket-client" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>stream_socket_client</refname> - <refpurpose> - Ouvre une connexion socket Internet ou Unix - </refpurpose> + <refpurpose>Ouvre une connexion socket Internet ou Unix</refpurpose> </refnamediv> - <refsect1> + + <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>resource</type><methodname>stream_socket_client</methodname> @@ -22,43 +21,114 @@ <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éée 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> + Initie un flux ou une connexion datagramme avec la destination + <parameter>remote_socket</parameter>. Le type de socket créée est déterminé + par le transport spécifié avec le formatage URL suivant : + <literal>transport://target</literal>. Pour une socket Internet, + (AF_INET) 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. - Le paramètre optionnel <parameter>timeout</parameter> sert à imposer un - délai d'expiration, en secondes, à l'appel système. - <parameter>flags</parameter> est un champ de bits qui peut être la combinaison - de n'importe quelles options 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> - <note> - <simpara> - Le paramètre <parameter>timeout</parameter> n'est appliqué que si vous ne tentez - pas de connexion asynchrone. - </simpara> + <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>. + </para> </note> + </refsect1> + + <refsect1 role="parameters"><!-- {{{ --> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>remote_socket</parameter></term> + <listitem> + <para> + L'adresse du socket. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>errno</parameter></term> + <listitem> + <para> + Contiendra le numéro de l'erreur système si la connexion échoue. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>errstr</parameter></term> + <listitem> + <para> + Contiendra le message de l'erreur système si la connexion échoue. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>timeout</parameter></term> + <listitem> + <para> + Délai d'expiration, en secondes, pour l'appel système + <literal>connect()</literal>. + <note> + <simpara> + Ce paramètre n'est appliqué que pour les connexions + qui ne sont pas asynchrones. + </simpara> + </note> + <note> + <para> + Pour définir un délai d'expiration lors de la lecture/écriture de + données via un socket, utilisez la fonction + <function>stream_set_timeout</function>, vu que le paramètre + <parameter>timeout</parameter> n'est appliqué que lors de la connexion + au socket. + </para> + </note> + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>flags</parameter></term> + <listitem> + <para> + Champ de bits qui peut être la combinaison de n'importe quelles options + de connexion. Actuellement, les valeurs possibles pour ces options sont + <constant>STREAM_CLIENT_CONNECT</constant> (défaut), + <constant>STREAM_CLIENT_ASYNC_CONNECT</constant> et + <constant>STREAM_CLIENT_PERSISTENT</constant>. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>context</parameter></term> + <listitem> + <para> + Une ressource de contexte valide, créée par la fonction + <function>stream_context_create</function>. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1><!-- }}} --> + + <refsect1 role="returnvalues"><!-- {{{ --> + &reftitle.returnvalues; <para> - <function>stream_socket_client</function> retourne une ressource de flux, - qui peut être utilisée avec d'autres fonctions de fichiers, comme + En cas de succès, une ressource de flux est retournée, 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>). + <function>fwrite</function>, <function>fclose</function>, et + <function>feof</function>, &false; si une erreur survient. </para> + </refsect1><!-- }}} --> + + <refsect1 role="errors"><!-- {{{ --> + &reftitle.errors; <para> Si l'appel échoue, <function>stream_socket_client</function> va retourner &false; et si les paramètres optionnels <parameter>errno</parameter> et @@ -72,80 +142,96 @@ <parameter>errno</parameter> et<parameter>errstr</parameter> doivent être passés par référence. </para> + </refsect1><!-- }}} --> + + + <refsect1 role="examples"><!-- {{{ --> + &reftitle.examples; <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> + <example xml:id="stream-socket-client.example.basic"><!-- {{{ --> <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"; + 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); + fwrite($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> + </example><!-- }}} --> + <example xml:id="stream-socket-client.example.daytime"><!-- {{{ --> <title>Utilisation de connexions UDP</title> + <para> + Lit la date et l'heure sur un service UDP de type + "<literal>daytime</literal>" (port 13) sur votre propre machine : + </para> <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"; + echo "ERREUR : $errno - $errstr<br />\n"; } else { - fwrite($fp,"\n"); - echo fread($fp, 26); - fclose($fp); + 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> + </example><!-- }}} --> </para> + </refsect1><!-- }}} --> + + <refsect1 role="notes"><!-- {{{ --> + &reftitle.notes; + <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> &ipv6.brackets; + <note> + <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> + </note> + </refsect1><!-- }}} --> + + <refsect1 role="seealso"><!-- {{{ --> + &reftitle.seealso; <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>. + <simplelist> + <member><function>stream_socket_server</function></member> + <member><function>stream_set_blocking</function></member> + <member><function>stream_set_timeout</function></member> + <member><function>stream_select</function></member> + <member><function>fgets</function></member> + <member><function>fgetss</function></member> + <member><function>fwrite</function></member> + <member><function>fclose</function></member> + <member><function>feof</function></member> + <member><xref linkend="ref.curl" /></member> + </simplelist> </para> - </refsect1> + </refsect1><!-- }}} --> + </refentry> <!-- Keep this comment at the end of the file