cvs: phpdoc-fr /reference/stream/functions stream-socket-enable-crypto.xml
| From: | Yannick Torres | Date: | Fri, 13 Feb 2009 07:04:57 +0000 |
| Subject: | cvs: phpdoc-fr /reference/stream/functions stream-socket-enable-crypto.xml | ||
| Groups: | php.doc.fr | ||
| Request: | Send a blank email to doc-fr+get-6666@lists.php.net to get a copy of this message | ||
yannick Fri Feb 13 07:04:57 2009 UTC
Modified files:
/phpdoc-fr/reference/stream/functions
stream-socket-enable-crypto.xml
Log:
sync with EN
http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/stream/functions/stream-socket-enable-crypto.xml?r1=1.10&r2=1.11&diff_format=u Index: phpdoc-fr/reference/stream/functions/stream-socket-enable-crypto.xml diff -u phpdoc-fr/reference/stream/functions/stream-socket-enable-crypto.xml:1.10 phpdoc-fr/reference/stream/functions/stream-socket-enable-crypto.xml:1.11 --- phpdoc-fr/reference/stream/functions/stream-socket-enable-crypto.xml:1.10 Fri Apr 25 18:57:20 2008 +++ phpdoc-fr/reference/stream/functions/stream-socket-enable-crypto.xml Fri Feb 13 07:04:57 2009 @@ -1,94 +1,145 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.10 $ --> -<!-- EN-Revision: 1.5 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.11 $ --> +<!-- EN-Revision: 1.6 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> - <refentry xml:id="function.stream-socket-enable-crypto" xmlns="http://docbook.org/ns/docbook"> - <refnamediv> - <refname>stream_socket_enable_crypto</refname> - <refpurpose> - Active ou non le chiffrement, pour une socket déjà connectée - </refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>mixed</type><methodname>stream_socket_enable_crypto</methodname> - <methodparam><type>resource</type><parameter>stream</parameter></methodparam> - <methodparam><type>bool</type><parameter>enable</parameter></methodparam> - <methodparam choice="opt"><type>int</type><parameter>crypto_type</parameter></methodparam> - <methodparam choice="opt"><type>resource</type><parameter>session_stream</parameter></methodparam> - </methodsynopsis> - - <simpara> - Lorsqu'appelé avec le paramètre <parameter>crypto_type</parameter>, - <function>stream_socket_enable_crypto</function> active le chiffrement - sur le flux <parameter>stream</parameter> en utilisant la méthode spécifiée. - </simpara> - - <para> - Valeurs possibles pour le paramètre <parameter>crypto_type</parameter> - <itemizedlist> - <listitem><simpara><constant>STREAM_CRYPTO_METHOD_SSLv2_CLIENT</constant></simpara></listitem> - <listitem><simpara><constant>STREAM_CRYPTO_METHOD_SSLv3_CLIENT</constant></simpara></listitem> - <listitem><simpara><constant>STREAM_CRYPTO_METHOD_SSLv23_CLIENT</constant></simpara></listitem> - <listitem><simpara><constant>STREAM_CRYPTO_METHOD_TLS_CLIENT</constant></simpara></listitem> - <listitem><simpara><constant>STREAM_CRYPTO_METHOD_SSLv2_SERVER</constant></simpara></listitem> - <listitem><simpara><constant>STREAM_CRYPTO_METHOD_SSLv3_SERVER</constant></simpara></listitem> - <listitem><simpara><constant>STREAM_CRYPTO_METHOD_SSLv23_SERVER</constant></simpara></listitem> - <listitem><simpara><constant>STREAM_CRYPTO_METHOD_TLS_SERVER</constant></simpara></listitem> - </itemizedlist> - </para> - - <simpara> - Une fois les paramètres de chiffrement définis, le chiffrement peut être activé - et désactivé dynamiquement en passant &true; ou &false; - dans le paramètre <parameter>enable</parameter>. - </simpara> - - <simpara> - Si ce flux doit être défini avec les paramètres d'un flux actif crypté, passez la ressource de - ce flux au paramètre <parameter>session_stream</parameter>. - </simpara> - - <simpara> - Retourne &true; en cas de succès, &false; si la négociation a échoué ou - &zero; s'il n'y a pas assez de données et que vous devez essayer - encore (uniquement pour les sockets non-bloquantes). - </simpara> - - <example> - <title>Exemple avec <function>stream_socket_enable_crypto</function></title> - <programlisting role="php"> +<refentry xml:id="function.stream-socket-enable-crypto" xmlns="http://docbook.org/ns/docbook"> + <refnamediv> + <refname>stream_socket_enable_crypto</refname> + <refpurpose>Active ou non le chiffrement, pour une socket déjà connectée</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>mixed</type><methodname>stream_socket_enable_crypto</methodname> + <methodparam><type>resource</type><parameter>stream</parameter></methodparam> + <methodparam><type>bool</type><parameter>enable</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>crypto_type</parameter></methodparam> + <methodparam choice="opt"><type>resource</type><parameter>session_stream</parameter></methodparam> + </methodsynopsis> + + <simpara> + Active ou non le chiffrement, pour une socket déjà connectée. + </simpara> + + <simpara> + Une fois les paramètres de chiffrement définis, le chiffrement peut être activé + et désactivé dynamiquement en passant &true; ou &false; + dans le paramètre <parameter>enable</parameter>. + </simpara> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>stream</parameter></term> + <listitem> + <para> + La ressource de flux. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>enable</parameter></term> + <listitem> + <para> + Active ou non le chiffrement sur le flux. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>crypto_type</parameter></term> + <listitem> + <para> + Configure le chiffrement sur le flux. + Les méthodes valides sont + <itemizedlist> + <listitem><simpara><constant>STREAM_CRYPTO_METHOD_SSLv2_CLIENT</constant></simpara></listitem> + <listitem><simpara><constant>STREAM_CRYPTO_METHOD_SSLv3_CLIENT</constant></simpara></listitem> + <listitem><simpara><constant>STREAM_CRYPTO_METHOD_SSLv23_CLIENT</constant></simpara></listitem> + <listitem><simpara><constant>STREAM_CRYPTO_METHOD_TLS_CLIENT</constant></simpara></listitem> + <listitem><simpara><constant>STREAM_CRYPTO_METHOD_SSLv2_SERVER</constant></simpara></listitem> + <listitem><simpara><constant>STREAM_CRYPTO_METHOD_SSLv3_SERVER</constant></simpara></listitem> + <listitem><simpara><constant>STREAM_CRYPTO_METHOD_SSLv23_SERVER</constant></simpara></listitem> + <listitem><simpara><constant>STREAM_CRYPTO_METHOD_TLS_SERVER</constant></simpara></listitem> + </itemizedlist> + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>session_stream</parameter></term> + <listitem> + <para> + Initialise le flux avec la configuration issue du paramètre + <parameter>session_stream</parameter>. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Retourne &true; en cas de succès, &false; si la négociation a échoué ou + <literal>0</literal> s'il n'y a pas assez de données et que vous devez essayer + encore (uniquement pour les sockets non-bloquantes). + </para> + </refsect1> + + <refsect1 role="examples"><!-- {{{ --> + &reftitle.examples; + <para> + <example xml:id="stream-socket-enable-crypto.example.basic"><!-- {{{ --> + <title>Exemple avec <function>stream_socket_enable_crypto</function></title> + <programlisting role="php"> <![CDATA[ <?php -$fp = stream_socket_client("tcp://monproto.example.com:31337", $errno, $errstr, 30); +$fp = stream_socket_client("tcp://myproto.example.com:31337", $errno, $errstr, 30); if (!$fp) { - die("Impossible de se connecter : $errstr ($errno)"); + die("Impossible de se connecter : $errstr ($errno)"); } /* Activation du chiffrement durant l'identification */ stream_socket_enable_crypto($fp, true, STREAM_CRYPTO_METHOD_SSLv23_CLIENT); -fwrite($fp, "USER Linus\r\n"); +fwrite($fp, "USER god\r\n"); fwrite($fp, "PASS secret\r\n"); /* Désactivation du chiffrement pour le reste */ stream_socket_enable_crypto($fp, false); while ($motd = fgets($fp)) { - echo $motd; + echo $motd; } + fclose($fp); ?> ]]> - </programlisting> - </example> - <simpara> - <xref linkend="ref.openssl"/> et - <xref linkend="transports"/>. - </simpara> - </refsect1> - </refentry> + </programlisting> + &example.outputs.similar; + <screen> +<![CDATA[ +]]> + </screen> + </example><!-- }}} --> + </para> + </refsect1><!-- }}} --> + + <refsect1 role="seealso"><!-- {{{ --> + &reftitle.seealso; + <para> + <simplelist> + <member><xref linkend="ref.openssl" /></member> + <member><xref linkend="transports" /></member> + </simplelist> + </para> + </refsect1><!-- }}} --> + +</refentry> <!-- Keep this comment at the end of the file Local variables:
http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/stream/functions/stream-socket-enable-crypto.xml?r1=1.10&r2=1.11&diff_format=u Index: phpdoc-fr/reference/stream/functions/stream-socket-enable-crypto.xml diff -u phpdoc-fr/reference/stream/functions/stream-socket-enable-crypto.xml:1.10 phpdoc-fr/reference/stream/functions/stream-socket-enable-crypto.xml:1.11 --- phpdoc-fr/reference/stream/functions/stream-socket-enable-crypto.xml:1.10 Fri Apr 25 18:57:20 2008 +++ phpdoc-fr/reference/stream/functions/stream-socket-enable-crypto.xml Fri Feb 13 07:04:57 2009 @@ -1,94 +1,145 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.10 $ --> -<!-- EN-Revision: 1.5 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.11 $ --> +<!-- EN-Revision: 1.6 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> - <refentry xml:id="function.stream-socket-enable-crypto" xmlns="http://docbook.org/ns/docbook"> - <refnamediv> - <refname>stream_socket_enable_crypto</refname> - <refpurpose> - Active ou non le chiffrement, pour une socket déjà connectée - </refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>mixed</type><methodname>stream_socket_enable_crypto</methodname> - <methodparam><type>resource</type><parameter>stream</parameter></methodparam> - <methodparam><type>bool</type><parameter>enable</parameter></methodparam> - <methodparam choice="opt"><type>int</type><parameter>crypto_type</parameter></methodparam> - <methodparam choice="opt"><type>resource</type><parameter>session_stream</parameter></methodparam> - </methodsynopsis> - - <simpara> - Lorsqu'appelé avec le paramètre <parameter>crypto_type</parameter>, - <function>stream_socket_enable_crypto</function> active le chiffrement - sur le flux <parameter>stream</parameter> en utilisant la méthode spécifiée. - </simpara> - - <para> - Valeurs possibles pour le paramètre <parameter>crypto_type</parameter> - <itemizedlist> - <listitem><simpara><constant>STREAM_CRYPTO_METHOD_SSLv2_CLIENT</constant></simpara></listitem> - <listitem><simpara><constant>STREAM_CRYPTO_METHOD_SSLv3_CLIENT</constant></simpara></listitem> - <listitem><simpara><constant>STREAM_CRYPTO_METHOD_SSLv23_CLIENT</constant></simpara></listitem> - <listitem><simpara><constant>STREAM_CRYPTO_METHOD_TLS_CLIENT</constant></simpara></listitem> - <listitem><simpara><constant>STREAM_CRYPTO_METHOD_SSLv2_SERVER</constant></simpara></listitem> - <listitem><simpara><constant>STREAM_CRYPTO_METHOD_SSLv3_SERVER</constant></simpara></listitem> - <listitem><simpara><constant>STREAM_CRYPTO_METHOD_SSLv23_SERVER</constant></simpara></listitem> - <listitem><simpara><constant>STREAM_CRYPTO_METHOD_TLS_SERVER</constant></simpara></listitem> - </itemizedlist> - </para> - - <simpara> - Une fois les paramètres de chiffrement définis, le chiffrement peut être activé - et désactivé dynamiquement en passant &true; ou &false; - dans le paramètre <parameter>enable</parameter>. - </simpara> - - <simpara> - Si ce flux doit être défini avec les paramètres d'un flux actif crypté, passez la ressource de - ce flux au paramètre <parameter>session_stream</parameter>. - </simpara> - - <simpara> - Retourne &true; en cas de succès, &false; si la négociation a échoué ou - &zero; s'il n'y a pas assez de données et que vous devez essayer - encore (uniquement pour les sockets non-bloquantes). - </simpara> - - <example> - <title>Exemple avec <function>stream_socket_enable_crypto</function></title> - <programlisting role="php"> +<refentry xml:id="function.stream-socket-enable-crypto" xmlns="http://docbook.org/ns/docbook"> + <refnamediv> + <refname>stream_socket_enable_crypto</refname> + <refpurpose>Active ou non le chiffrement, pour une socket déjà connectée</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>mixed</type><methodname>stream_socket_enable_crypto</methodname> + <methodparam><type>resource</type><parameter>stream</parameter></methodparam> + <methodparam><type>bool</type><parameter>enable</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>crypto_type</parameter></methodparam> + <methodparam choice="opt"><type>resource</type><parameter>session_stream</parameter></methodparam> + </methodsynopsis> + + <simpara> + Active ou non le chiffrement, pour une socket déjà connectée. + </simpara> + + <simpara> + Une fois les paramètres de chiffrement définis, le chiffrement peut être activé + et désactivé dynamiquement en passant &true; ou &false; + dans le paramètre <parameter>enable</parameter>. + </simpara> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>stream</parameter></term> + <listitem> + <para> + La ressource de flux. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>enable</parameter></term> + <listitem> + <para> + Active ou non le chiffrement sur le flux. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>crypto_type</parameter></term> + <listitem> + <para> + Configure le chiffrement sur le flux. + Les méthodes valides sont + <itemizedlist> + <listitem><simpara><constant>STREAM_CRYPTO_METHOD_SSLv2_CLIENT</constant></simpara></listitem> + <listitem><simpara><constant>STREAM_CRYPTO_METHOD_SSLv3_CLIENT</constant></simpara></listitem> + <listitem><simpara><constant>STREAM_CRYPTO_METHOD_SSLv23_CLIENT</constant></simpara></listitem> + <listitem><simpara><constant>STREAM_CRYPTO_METHOD_TLS_CLIENT</constant></simpara></listitem> + <listitem><simpara><constant>STREAM_CRYPTO_METHOD_SSLv2_SERVER</constant></simpara></listitem> + <listitem><simpara><constant>STREAM_CRYPTO_METHOD_SSLv3_SERVER</constant></simpara></listitem> + <listitem><simpara><constant>STREAM_CRYPTO_METHOD_SSLv23_SERVER</constant></simpara></listitem> + <listitem><simpara><constant>STREAM_CRYPTO_METHOD_TLS_SERVER</constant></simpara></listitem> + </itemizedlist> + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>session_stream</parameter></term> + <listitem> + <para> + Initialise le flux avec la configuration issue du paramètre + <parameter>session_stream</parameter>. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Retourne &true; en cas de succès, &false; si la négociation a échoué ou + <literal>0</literal> s'il n'y a pas assez de données et que vous devez essayer + encore (uniquement pour les sockets non-bloquantes). + </para> + </refsect1> + + <refsect1 role="examples"><!-- {{{ --> + &reftitle.examples; + <para> + <example xml:id="stream-socket-enable-crypto.example.basic"><!-- {{{ --> + <title>Exemple avec <function>stream_socket_enable_crypto</function></title> + <programlisting role="php"> <![CDATA[ <?php -$fp = stream_socket_client("tcp://monproto.example.com:31337", $errno, $errstr, 30); +$fp = stream_socket_client("tcp://myproto.example.com:31337", $errno, $errstr, 30); if (!$fp) { - die("Impossible de se connecter : $errstr ($errno)"); + die("Impossible de se connecter : $errstr ($errno)"); } /* Activation du chiffrement durant l'identification */ stream_socket_enable_crypto($fp, true, STREAM_CRYPTO_METHOD_SSLv23_CLIENT); -fwrite($fp, "USER Linus\r\n"); +fwrite($fp, "USER god\r\n"); fwrite($fp, "PASS secret\r\n"); /* Désactivation du chiffrement pour le reste */ stream_socket_enable_crypto($fp, false); while ($motd = fgets($fp)) { - echo $motd; + echo $motd; } + fclose($fp); ?> ]]> - </programlisting> - </example> - <simpara> - <xref linkend="ref.openssl"/> et - <xref linkend="transports"/>. - </simpara> - </refsect1> - </refentry> + </programlisting> + &example.outputs.similar; + <screen> +<![CDATA[ +]]> + </screen> + </example><!-- }}} --> + </para> + </refsect1><!-- }}} --> + + <refsect1 role="seealso"><!-- {{{ --> + &reftitle.seealso; + <para> + <simplelist> + <member><xref linkend="ref.openssl" /></member> + <member><xref linkend="transports" /></member> + </simplelist> + </para> + </refsect1><!-- }}} --> + +</refentry> <!-- Keep this comment at the end of the file Local variables: