cvs: phpdoc-fr /reference/stream reference.xml /reference/stream/functions stream-context-create.xml stream-context-get-options.xml
stream-copy-to-stream.xml stream-filter-append.xml stream-filter-prepend.xml stream-get-line.xml stream-get-meta-data.xml stream-get-transports.xml
stream-register-filter.xml stream-register-wrapper.xml stream-socket-accept.xml stream-socket-client.xml stream-socket-get-name.xml
stream-socket-server.xml

From: Date: Mon, 28 Apr 2003 15:49:21 +0000
Subject: cvs: phpdoc-fr /reference/stream reference.xml /reference/stream/functions stream-context-create.xml stream-context-get-options.xml
stream-copy-to-stream.xml stream-filter-append.xml stream-filter-prepend.xml stream-get-line.xml stream-get-meta-data.xml stream-get-transports.xml
stream-register-filter.xml stream-register-wrapper.xml stream-socket-accept.xml stream-socket-client.xml stream-socket-get-name.xml
stream-socket-server.xml
Groups: php.doc.fr 
Request: Send a blank email to doc-fr+get-313@lists.php.net to get a copy of this message
dams Mon Apr 28 11:49:21 2003 EDT Added files: /phpdoc-fr/reference/stream/functions stream-copy-to-stream.xml stream-get-line.xml stream-get-transports.xml stream-socket-accept.xml stream-socket-client.xml stream-socket-get-name.xml stream-socket-server.xml Modified files: /phpdoc-fr/reference/stream reference.xml /phpdoc-fr/reference/stream/functions stream-context-create.xml stream-context-get-options.xml stream-filter-append.xml stream-filter-prepend.xml stream-get-meta-data.xml stream-register-filter.xml stream-register-wrapper.xml Log: spring commit

Index: phpdoc-fr/reference/stream/reference.xml diff -u phpdoc-fr/reference/stream/reference.xml:1.4 phpdoc-fr/reference/stream/reference.xml:1.5 --- phpdoc-fr/reference/stream/reference.xml:1.4 Sun Apr 13 09:27:15 2003 +++ phpdoc-fr/reference/stream/reference.xml Mon Apr 28 11:49:20 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.4 $ --> +<!-- $Revision: 1.5 $ --> <reference id="ref.stream"> <title>Fl&ocirc;ts</title> <titleabbrev>Fl&ocirc;ts</titleabbrev> @@ -32,6 +32,10 @@ des gestionnaires actuellement enregistr&eacute;s, utilisez la fonction <function>stream_get_wrappers</function>. </simpara> + </section> + + <section id="stream.filters"> + <title>Filtres de fl&ocirc;ts</title> <simpara> Un <literal>filtre</literal> est une fonction finale qui effectue des op&eacute;rations sur les donn&eacute;es qui sont lues ou &eacute;crites dans un fl&ocirc;t. Un nombre arbitraire de @@ -68,10 +72,52 @@ </itemizedlist> </para> </section> - - <section id="stream.requirements"> - &reftitle.required; - &no.requirement; + + <section id="stream.contexts"> + <title>Contextes de fl&ocirc;ts</title> + <simpara> + Un <literal>contexte</literal> est un jeu de param&egrave;tres et d'options + sp&eacute;cifiques &agrave; un gestionnaire qui modifie ou am&eacute;liore le comportement + d'un fl&ocirc;t. Les contextes sont cr&eacute;&eacute;s en utilisant la fonction + <function>stream_context_create</function> et peuvent &ecirc;tre donn&eacute; aux + fonctions de cr&eacute;ations de fl&ocirc;ts sur le syst&egrave;me de fichier + (i.e. <function>fopen</function>, <function>file</function>, + <function>file_get_contents</function>, etc...). + </simpara> + <simpara> + Les options peuvent &ecirc;tre sp&eacute;cifi&eacute;es en appelant + <function>stream_context_create</function>, ou plus tard, avec + <function>stream_context_set_option</function>. + Une liste des options sp&eacute;cifiques &agrave; des gestionnaires est disponible + dans la liste des gestionnaires int&eacute;gr&eacute;s (voyez <xref linkend="wrappers"/>). + </simpara> + <simpara> + De plus, les param&egrave;tres peuvent &ecirc;tre envoy&eacute;s &agrave; un contexte en utilisant + la fonction <function>stream_context_set_params</function>. Actuellement, le + seul param&egrave;tre de contexte support&eacute; par &php; est <literal>notification</literal>. + La valeur de ce param&egrave;tre doit &ecirc;tre le nom d'une fonction qui sera appel&eacute;e + lorsqu'un &eacute;v&eacute;nement survient pour un fl&ocirc;t. La fonction d'alerte + est appel&eacute; durant la reception de l'&eacute;v&eacute;nement, et doit accepter 6 param&egrave;tres : + </simpara> + <methodsynopsis> + <type>void</type><methodname>my_notifier</methodname> + <methodparam><type>int</type><parameter>notification_code</parameter></methodparam> + <methodparam><type>int</type><parameter>severity</parameter></methodparam> + <methodparam><type>string</type><parameter>message</parameter></methodparam> + <methodparam><type>int</type><parameter>message_code</parameter></methodparam> + <methodparam><type>int</type><parameter>bytes_transferred</parameter></methodparam> + <methodparam><type>int</type><parameter>bytes_max</parameter></methodparam> + </methodsynopsis> + <simpara> + <parameter>notification_code</parameter> et <parameter>severity</parameter> + sont des valeurs num&eacute;riques qui correspondent aux constantes <constant>STREAM_NOTIFY_*</constant> + list&eacute;es ci-dessous. Si un message descriptif est disponible dans un fl&ocirc;t, les + param&egrave;tre <parameter>message</parameter> et <parameter>message_code</parameter> + en seront &eacute;quip&eacute;. La signification de ces valeurs est d&eacute;pendante du gestionnaire. + + <parameter>bytes_transferred</parameter> et <parameter>bytes_max</parameter> seront + fournies lorsque possible. + </simpara> </section> <section id="stream.installation"> @@ -82,13 +128,8 @@ </para> </section> - <section id="stream.configuration"> - &reftitle.runtime; - &no.config; - </section> - <section id="stream.resources"> - <title>Stream Classes</title> + <title>Classes Stream</title> <simpara> Des gestionnaires personnalis&eacute;s peuvent &ecirc;tre enregistr&eacute;s via la fonction <function>stream_register_wrapper</function>, en utilisant la d&eacute;finition de @@ -102,37 +143,7 @@ </simpara> </section> - <section id="stream.constants"> - &reftitle.constants; - <para> - <informaltable> - <tgroup cols="2"> - <thead> - <row> - <entry>Constante</entry> - <entry>Description</entry> - </row> - </thead> - <tbody> - <row> - <entry><constant>STREAM_USE_PATH</constant></entry> - <entry><literal>Flag</literal> indique si le fl&ocirc;t fait partie de - l'include_path. - </entry> - </row> - <row> - <entry><constant>STREAM_REPORT_ERRORS</constant></entry> - <entry><literal>Flag</literal> indiquant si le gestionnaire est responsable - de la lev&eacute;e des erreurs via <function>trigger_error</function> durant les - op&eacute;rations de fl&ocirc;ts. Si cette option n'est pas activ&eacute;e, vous ne - pourrez pas g&eacute;n&eacute;rer d'erreurs. - </entry> - </row> - </tbody> - </tgroup> - </informaltable> - </para> - </section> + &reference.stream.constants; <section id="stream.errors"> <title>Erreurs de fl&ocirc;ts</title> @@ -226,7 +237,7 @@ <programlisting role="php"> <![CDATA[ <?php -/* Creation d'un fichier compressee; contenant une chaine arbitraire +/* Cr&eacute;ation d'un fichier compress&eacute; contenant une cha&icirc;ne arbitraire * Le fichier peut etre lu en utilisant le gestionnaire compress.zlib * ou simplement decompresse; en ligne de commande avec 'gzip -d foo-bar.txt.gz' */ Index: phpdoc-fr/reference/stream/functions/stream-context-create.xml diff -u phpdoc-fr/reference/stream/functions/stream-context-create.xml:1.1 phpdoc-fr/reference/stream/functions/stream-context-create.xml:1.2 --- phpdoc-fr/reference/stream/functions/stream-context-create.xml:1.1 Mon Jan 13 14:56:55 2003 +++ phpdoc-fr/reference/stream/functions/stream-context-create.xml Mon Apr 28 11:49:21 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.1 $ --> +<!-- $Revision: 1.2 $ --> <refentry id="function.stream-context-create"> <refnamediv> <refname>stream_context_create</refname> @@ -9,15 +9,45 @@ <title>Description</title> <methodsynopsis> <type>resource</type><methodname>stream_context_create</methodname> - <methodparam><type>array</type><parameter>params</parameter></methodparam> + <methodparam><type>array</type><parameter>options</parameter></methodparam> </methodsynopsis> <simpara> <methodname>stream_context_create</methodname> cr&eacute;e et retourne un contexte - de fl&ocirc;t, avec les param&egrave;tres fournis par <parameter>params</parameter>. + de fl&ocirc;t, avec les param&egrave;tres fournis par <parameter>options</parameter>. </simpara> <simpara> + Le param&egrave;tre <parameter>options</parameter> doit &ecirc;tre un tableau + associatif, au format <literal>$arr['wrapper']['option'] = $value</literal>. + </simpara> + <example> + <title>Exemple avec <function>stream_context_create</function></title> + <programlisting role="php"> +<![CDATA[ +<?php + $opts = array( + 'http'=>array( + 'method'=>"GET", + 'header'=>"Accept-language: en\r\n" . + "Cookie: foo=bar\r\n" + ) + ); + + $context = stream_context_create($opts); + +/* Envoie une requ&ecirc;te HTTP &agrave; www.exemple.com + avec des ent&ecirc;tes suppl&eacute;mentaires */ + $fp = fopen('http://www.exemple.com', 'r', false, $context); + fpassthru($fp); + fclose($fp); +?> +]]> + </programlisting> + </example> + <simpara> Voir aussi - <function>stream_context_set_params</function>. + <function>stream_context_set_params</function> et + la liste des gestionnaires avec des options de contexte + (<xref linkend="wrappers"/>). </simpara> </refsect1> </refentry> Index: phpdoc-fr/reference/stream/functions/stream-context-get-options.xml diff -u phpdoc-fr/reference/stream/functions/stream-context-get-options.xml:1.1 phpdoc-fr/reference/stream/functions/stream-context-get-options.xml:1.2 --- phpdoc-fr/reference/stream/functions/stream-context-get-options.xml:1.1 Mon Jan 13 14:56:55 2003 +++ phpdoc-fr/reference/stream/functions/stream-context-get-options.xml Mon Apr 28 11:49:21 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.1 $ --> +<!-- $Revision: 1.2 $ --> <refentry id="function.stream-context-get-options"> <refnamediv> <refname>stream_context_get_options</refname> @@ -8,7 +8,7 @@ <refsect1> <title>Description</title> <methodsynopsis> - <type>bool</type><methodname>stream_context_get_options</methodname> + <type>array</type><methodname>stream_context_get_options</methodname> <methodparam><type>resource</type><parameter>stream|context</parameter></methodparam> </methodsynopsis> <simpara> Index: phpdoc-fr/reference/stream/functions/stream-filter-append.xml diff -u phpdoc-fr/reference/stream/functions/stream-filter-append.xml:1.1 phpdoc-fr/reference/stream/functions/stream-filter-append.xml:1.2 --- phpdoc-fr/reference/stream/functions/stream-filter-append.xml:1.1 Mon Jan 13 14:56:55 2003 +++ phpdoc-fr/reference/stream/functions/stream-filter-append.xml Mon Apr 28 11:49:21 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.1 $ --> +<!-- $Revision: 1.2 $ --> <refentry id="function.stream-filter-append"> <refnamediv> <refname>stream_filter_append</refname> @@ -11,6 +11,7 @@ <type>bool</type><methodname>stream_filter_append</methodname> <methodparam><type>resource</type><parameter>stream</parameter></methodparam> <methodparam><type>string</type><parameter>filtername</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>read_write</parameter></methodparam> <methodparam choice="opt"><type>string</type><parameter>params</parameter></methodparam> </methodsynopsis> <para> @@ -23,10 +24,67 @@ Pour ajouter un filtre au d&eacute;but de la liste, utilisez la fonction <function>stream_filter_prepend</function>. </para> - <note> + <para> + Par d&eacute;faut, <function>stream_filter_prepend</function> va ajouter + le filtre &agrave; la liste de filtre de lecture si le fichier a &eacute;t&eacute; ouvert + en mode lecture (<literal>r</literal> et/ou <literal>+</literal>). Le + filtre sera aussi attach&eacute; &agrave; la liste des filtres de lecture + si le fichier a &eacute;t&eacute; ouvert en mode lecture (<literal>w</literal>, + <literal>a</literal> et/ou <literal>+</literal>). + <constant>STREAM_FILTER_READ</constant>, + <constant>STREAM_FILTER_WRITE</constant>, et/ou + <constant>STREAM_FILTER_ALL</constant> peuvent aussi &ecirc;tre utilis&eacute;es + dans le param&egrave;tre <parameter>read_write</parameter> pour contr&ocirc;ler + ce comportement. Voyez la fonction + <function>stream_filter_append</function> pour un exemple de l'utilisation + de ce param&egrave;tre. + </para> + <para> + <example> + <title>Contr&ocirc;ler l'application des filtres</title> + <programlisting role="php"> +<![CDATA[ +<?php +/* Open a test file for reading and writting */ +$fp = fopen("test.txt","rw"); + +/* Apply the ROT13 filter to the + * write filter chain, but not the + * read filter chain */ +stream_filter_append($fp, "string.rot13", STREAM_FILTER_WRITE); + +/* Write a simple string to the file + * it will be ROT13 transformed on the + * way out */ +fwrite($fp, "This is a test\n"); + +/* Back up to the beginning of the file */ +rewind($fp); + +/* Read the contents of the file back out. + * Had the filter been applied to the + * read filter chain as well, we would see + * the text ROT13ed back to its original state */ +fpassthru($fp); + +fclose($fp); + +/* Expected Output + --------------- + +Guvf vf n grfg + + */ +?> +]]> + </programlisting> + </example> + </para> + <note> + <title>Quand utiliser des filtres personnalis&eacute;s</title> <simpara> <function>stream_register_filter</function> doit &ecirc;tre appel&eacute; avant - <function>stream_filter_append</function> pour enregistrer le filtre + <function>stream_filter_prepend</function> pour enregistrer le filtre sous le nom de <parameter>filtername</parameter>. </simpara> </note> Index: phpdoc-fr/reference/stream/functions/stream-filter-prepend.xml diff -u phpdoc-fr/reference/stream/functions/stream-filter-prepend.xml:1.1 phpdoc-fr/reference/stream/functions/stream-filter-prepend.xml:1.2 --- phpdoc-fr/reference/stream/functions/stream-filter-prepend.xml:1.1 Mon Jan 13 14:56:55 2003 +++ phpdoc-fr/reference/stream/functions/stream-filter-prepend.xml Mon Apr 28 11:49:21 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.1 $ --> +<!-- $Revision: 1.2 $ --> <refentry id="function.stream-filter-prepend"> <refnamediv> <refname>stream_filter_prepend</refname> @@ -11,6 +11,7 @@ <type>bool</type><methodname>stream_filter_prepend</methodname> <methodparam><type>resource</type><parameter>stream</parameter></methodparam> <methodparam><type>string</type><parameter>filtername</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>read_write</parameter></methodparam> <methodparam choice="opt"><type>string</type><parameter>params</parameter></methodparam> </methodsynopsis> <para> @@ -23,7 +24,23 @@ Pour ajouter un filtre &agrave; la fin de la liste, utilisez la fonction <function>stream_filter_prepend</function>. </para> + <para> + Par d&eacute;faut, <function>stream_filter_prepend</function> va ajouter + le filtre &agrave; la liste de filtre de lecture si le fichier a &eacute;t&eacute; ouvert + en mode lecture (<literal>r</literal> et/ou <literal>+</literal>). Le + filtre sera aussi attach&eacute; &agrave; la liste des filtres de lecture + si le fichier a &eacute;t&eacute; ouvert en mode lecture (<literal>w</literal>, + <literal>a</literal> et/ou <literal>+</literal>). + <constant>STREAM_FILTER_READ</constant>, + <constant>STREAM_FILTER_WRITE</constant>, et/ou + <constant>STREAM_FILTER_ALL</constant> peuvent aussi &ecirc;tre utilis&eacute;es + dans le param&egrave;tre <parameter>read_write</parameter> pour contr&ocirc;ler + ce comportement. Voyez la fonction + <function>stream_filter_append</function> pour un exemple de l'utilisation + de ce param&egrave;tre. + </para> <note> + <title>Quand utiliser des filtres personnalis&eacute;s</title> <simpara> <function>stream_register_filter</function> doit &ecirc;tre appel&eacute; avant <function>stream_filter_prepend</function> pour enregistrer le filtre Index: phpdoc-fr/reference/stream/functions/stream-get-meta-data.xml diff -u phpdoc-fr/reference/stream/functions/stream-get-meta-data.xml:1.1 phpdoc-fr/reference/stream/functions/stream-get-meta-data.xml:1.2 --- phpdoc-fr/reference/stream/functions/stream-get-meta-data.xml:1.1 Mon Jan 13 14:56:55 2003 +++ phpdoc-fr/reference/stream/functions/stream-get-meta-data.xml Mon Apr 28 11:49:21 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.1 $ --> +<!-- $Revision: 1.2 $ --> <refentry id="function.stream-get-meta-data"> <refnamediv> <refname>stream_get_meta_data</refname> @@ -8,11 +8,11 @@ <refsect1> <title>Description</title> <methodsynopsis> - <type>array</type><methodname>file_get_meta_data</methodname> + <type>array</type><methodname>stream_get_meta_data</methodname> <methodparam><type>resource</type><parameter>stream</parameter></methodparam> </methodsynopsis> <simpara> - <methodname>file_get_meta_data</methodname> retourne les informations disponibles + <methodname>stream_get_meta_data</methodname> retourne les informations disponibles sur le fl&ocirc;t <parameter>stream</parameter>. Ce fl&ocirc;t peut &ecirc;tre n'importe quel fl&ocirc;t cr&eacute;&eacute; par <function>fopen</function>, <function>fsockopen</function> et <function>pfsockopen</function>. Le tableau r&eacute;sultant peut contenir les Index: phpdoc-fr/reference/stream/functions/stream-register-filter.xml diff -u phpdoc-fr/reference/stream/functions/stream-register-filter.xml:1.1 phpdoc-fr/reference/stream/functions/stream-register-filter.xml:1.2 --- phpdoc-fr/reference/stream/functions/stream-register-filter.xml:1.1 Mon Jan 13 14:56:55 2003 +++ phpdoc-fr/reference/stream/functions/stream-register-filter.xml Mon Apr 28 11:49:21 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.1 $ --> +<!-- $Revision: 1.2 $ --> <refentry id="function.stream-register-filter"> <refnamediv> <refname>stream_register_filter</refname> @@ -8,7 +8,7 @@ <refsect1> <title>Description</title> <methodsynopsis> - <type>boolean</type><methodname>stream_register_filter</methodname> + <type>bool</type><methodname>stream_register_filter</methodname> <methodparam><type>string</type><parameter>filtername</parameter></methodparam> <methodparam><type>string</type><parameter>classname</parameter></methodparam> </methodsynopsis> @@ -34,76 +34,38 @@ </para> <methodsynopsis> - <type>int</type><methodname>write</methodname> - <methodparam><type>string</type><parameter>data</parameter></methodparam> + <type>int</type><methodname>filter</methodname> + <methodparam><type>resource</type><parameter>in</parameter></methodparam> + <methodparam><type>resource</type><parameter>out</parameter></methodparam> + <methodparam><type>int</type><parameter>&amp;consumed</parameter></methodparam> + <methodparam><type>boolean</type><parameter>closing</parameter></methodparam> </methodsynopsis> <para> - Cette m&eacute;thode est appel&eacute;e d&egrave;s que les donn&eacute;es sont &eacute;crite dans le fl&ocirc;t, - comme avec la fonction <function>fwrite</function>. Apr&egrave;s la modification - des donn&eacute;es <parameter>data</parameter>, cette m&eacute;thode doit utiliser la - ligne suivante <literal>return parent::write($data);</literal> - pour que le prochain filtre puisse s'ex&eacute;cuter. Lorsqu'il ne reste plus - de filtres, le fl&ocirc;t va &eacute;crire les donn&eacute;es <parameter>data</parameter> - dans leur forme finale. - <note> - <para> - Si votre filtre modifie la taille de la cha&icirc;ne <parameter>data</parameter>, - par exemple en supprimant le premier caract&egrave;re, il faut, avant d'utiliser - la fonction <literal>parent::write($data);</literal>, s'assurer d'inclure - le caract&egrave;re supprim&eacute; dans la valeur de retour. - </para> - </note> - <informalexample> - <programlisting role="php"> -<![CDATA[ -class myfilter extends php_user_filter { - function write($data) { - $data = substr($data,1); - $written_by_parent = parent::write($data); - return ($written_by_parent + 1); - } -} -]]> - </programlisting> - </informalexample> - </para> - - <methodsynopsis> - <type>string</type><methodname>read</methodname> - <methodparam><type>int</type><parameter>maxlength</parameter></methodparam> - </methodsynopsis> - <para> - Cette m&eacute;thode est appel&eacute;e d&egrave;s que des donn&eacute;es sont lues dans le fl&ocirc;t - (comme avec la fonction <function>fread</function>). Un filtre doit commencer - par utiliser la ligne <literal>parent::read($maxlength);</literal> pour - lire les donn&eacute;es issue du filtre pr&eacute;c&eacute;dent. Ultimement, ce sera le - fl&ocirc;t qui lira les donn&eacute;es. Votre filtre peut alors modifier cette - valeur et retourner la valeur finale. Votre filtre ne doit jamais - retourner plus de <parameter>maxlength</parameter> octets. - Comme <literal>parent::read($maxlength);</literal> ne retournera - aussi pas plus de <parameter>maxlength</parameter>, ce ne sera pas - un probl&egrave;me en r&egrave;gle g&eacute;n&eacute;ral. Cependant, si votre filtre accroit la - taille des donn&eacute;es retourn&eacute;es, il faut alors appeler cette ligne avec - <literal>parent::read($maxlength-$x);</literal> o&ugrave; <parameter>x</parameter> - est l'accroissement maximal de vos donn&eacute;es. Alternativement, vous pouvez - b&acirc;tir un buffer de lecture dans votre classe. - </para> - - <methodsynopsis> - <type>int</type><methodname>flush</methodname> - <methodparam><type>bool</type><parameter>closing</parameter></methodparam> - </methodsynopsis> - <para> - Cette m&eacute;thode est appel&eacute;e en r&eacute;ponse &agrave; une requ&ecirc;te de vidage des - buffers du fl&ocirc;t (comme avec la fonction <function>fflush</function> ou - <function>fclose</function>). Le param&egrave;tre <parameter>closing</parameter> - vous indique si le fl&ocirc;t est, en r&eacute;alit&eacute;, dans un processus de fermeture. - L'action par d&eacute;faut est d'appeler simplement - <literal>return parent::flush($closing);</literal>, mais votre filtre - peut souhaiter ex&eacute;cuter des &eacute;critures suppl&eacute;mentaires, ou bien - nettoyer des ressources avant de r&eacute;aliser le vidage en r&egrave;gle. - </para> - + Cette m&eacute;thode est appel&eacute; &agrave; chaque fois que des donn&eacute;es sont lues ou &eacute;crites + dans le fl&ocirc;t attach&eacute; (avec des fonctions comme <function>fread</function> ou + <function>fwrite</function>). Le param&egrave;tre <parameter>in</parameter> est une ressource + qui pointe sur une <literal>bucket brigade</literal> qui contient un ou plusieurs + objet <literal>bucket</literal> contenant les donn&eacute;es &agrave; filtrer. + <parameter>out</parameter> est une autre ressource + qui pointe sur une <literal>bucket brigade</literal> + dans laquelle les donn&eacute;e seront plac&eacute;es. + <parameter>consumed</parameter>, qui doit <emphasis>toujours</emphasis> + &ecirc;tre d&eacute;clar&eacute; par r&eacute;f&eacute;rence, doit &ecirc;tre incr&eacute;ment&eacute; de la taille de donn&eacute;es que + votre filtre lit et modifie. Dans la plupart des cas, cela signifie que vous + devrez incr&eacute;menter <parameter>consumed</parameter> avec <literal>$bucket->datalen</literal> + pour chaque <literal>$bucket</literal>. + Si le fl&ocirc;t est en cours de fermeture (et par cons&eacute;quent, cela sera le dernier + passage dans la cha&icirc;ne de filtres), le param&egrave;tre <parameter>closing</parameter> + vaudra &true; La m&eacute;thode <methodname>filter</methodname> doit retourner l'une + des trois valeurs suivantes : <constant>PSFS_PASS_ON</constant> indique la r&eacute;ussite, + et les donn&eacute;es sont dans le param&egrave;tre <parameter>out</parameter>, une <literal>bucket brigade</literal>. + <constant>PSFS_FEED_ME</constant> indique que le filtre n'a aucune donn&eacute;es &agrave; retourner, et + requiert d'autres donn&eacute;es du fl&ocirc;t. + <constant>PSFS_ERR_FATAL</constant> indique que le fl&ocirc;t a rencontr&eacute; une erreur + fatale, et ne peut continuer. Si aucune valeur n'est retourn&eacute;e par cette m&eacute;thode, + <constant>PSFS_ERR_FATAL</constant> est utilis&eacute;. + </para> + <methodsynopsis> <type>void</type><methodname>oncreate</methodname> <void/> Index: phpdoc-fr/reference/stream/functions/stream-register-wrapper.xml diff -u phpdoc-fr/reference/stream/functions/stream-register-wrapper.xml:1.2 phpdoc-fr/reference/stream/functions/stream-register-wrapper.xml:1.3 --- phpdoc-fr/reference/stream/functions/stream-register-wrapper.xml:1.2 Mon Feb 3 07:48:42 2003 +++ phpdoc-fr/reference/stream/functions/stream-register-wrapper.xml Mon Apr 28 11:49:21 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.2 $ --> +<!-- $Revision: 1.3 $ --> <!-- splitted from ./en/functions/filesystem.xml, last change in rev 1.141 --> <refentry id="function.stream-register-wrapper"> <refnamediv> @@ -9,7 +9,7 @@ <refsect1> <title>Description</title> <methodsynopsis> - <type>boolean</type><methodname>stream_register_wrapper</methodname> + <type>bool</type><methodname>stream_register_wrapper</methodname> <methodparam><type>string</type><parameter>protocol</parameter></methodparam> <methodparam><type>string</type><parameter>classname</parameter></methodparam> </methodsynopsis> @@ -35,7 +35,7 @@ </para> <methodsynopsis> - <type>boolean</type><methodname>stream_open</methodname> + <type>bool</type><methodname>stream_open</methodname> <methodparam><type>string</type><parameter>path</parameter></methodparam> <methodparam><type>string</type><parameter>mode</parameter></methodparam> <methodparam><type>int</type><parameter>options</parameter></methodparam> @@ -140,7 +140,7 @@ </para> <methodsynopsis> - <type>boolean</type><methodname>stream_eof</methodname> + <type>bool</type><methodname>stream_eof</methodname> <methodparam><type>void</type><parameter></parameter></methodparam> </methodsynopsis> <para> @@ -161,7 +161,7 @@ </para> <methodsynopsis> - <type>boolean</type><methodname>stream_seek</methodname> + <type>bool</type><methodname>stream_seek</methodname> <methodparam><type>int</type><parameter>offset</parameter></methodparam> <methodparam><type>int</type><parameter>whence</parameter></methodparam> </methodsynopsis> @@ -176,7 +176,7 @@ </para> <methodsynopsis> - <type>boolean</type><methodname>stream_flush</methodname> + <type>bool</type><methodname>stream_flush</methodname> <methodparam><type>void</type><parameter></parameter></methodparam> </methodsynopsis> <para> Index: phpdoc-fr/reference/stream/functions/stream-copy-to-stream.xml +++ phpdoc-fr/reference/stream/functions/stream-copy-to-stream.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <refentry id="function.stream-copy-to-stream"> <refnamediv> <refname>stream_copy_to_stream</refname> <refpurpose>Copie des donn&eacute;es depuis un fl&ocirc;t vers un autre</refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> <type>int</type><methodname>stream_copy_to_stream</methodname> <methodparam><type>resource</type><parameter>source</parameter></methodparam> <methodparam><type>resource</type><parameter>dest</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>maxlength</parameter></methodparam> </methodsynopsis> <para> <function>stream_copy_to_stream</function> copie jusqu'&agrave; <parameter>maxlength</parameter> octets de donn&eacute;es depuis la position courante du pointeur dans le fl&ocirc;t <parameter>source</parameter> vers le param&egrave;tre <parameter>dest</parameter>. Si <parameter>maxlength</parameter> n'est pas sp&eacute;cifi&eacute;, tout le reste du fl&ocirc;t <parameter>source</parameter> sera copi&eacute;. will be copied. <function>stream_copy_to_stream</function> retourne le total d'octets copi&eacute;. <example> <title>Exemple avec <function>stream_copy_to_stream</function></title> <programlisting role="php"> <![CDATA[ <?php $src = fopen('http://www.exemple.com','r'); $dest1 = fopen('first1k.txt','w'); $dest2 = fopen('remainder.txt','w'); print stream_copy_to_stream($src, $dest1, 1024) . " octets copi&eacute;s vers first1k.txt\n"; print stream_copy_to_stream($src, $dest2) . " octets copi&eacute;s vers remainder.txt\n"; ?> ]]> </programlisting> </example> </para> <para> Voir aussi <function>copy</function>. </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 --> Index: phpdoc-fr/reference/stream/functions/stream-get-line.xml +++ phpdoc-fr/reference/stream/functions/stream-get-line.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <refentry id="function.stream-get-line"> <refnamediv> <refname>stream_get_line</refname> <refpurpose>Lit une ligne dans un fl&ocirc;t</refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> <type>string</type><methodname>stream_get_line</methodname> <methodparam><type>resource</type><parameter>handle</parameter></methodparam> <methodparam><type>int</type><parameter>length</parameter></methodparam> <methodparam><type>string</type><parameter>ending</parameter></methodparam> </methodsynopsis> <para> <function>stream_get_line</function> lit une ligne de taille maximale <parameter>length</parameter> dans le fl&ocirc;t <parameter>handle</parameter>. La lecture se termine lorsque <parameter>length</parameter> ont &eacute;t&eacute; lus, ou que la cha&icirc;ne <parameter>ending</parameter> est trouv&eacute;e dans le fl&ocirc;t (et qui <emphasis>n'est pas</emphasis> inclue dans la valeur retourn&eacute;e), ou la fin du fichier (le premier des trois). </para> <para> Si une erreur survient, <function>stream_get_line</function> retourne &false;. </para> <simpara> <function>stream_get_line</function> est presque identique &agrave; <function>fgets</function> hormis le fait qu'elle autorise d'autres d&eacute;limiteur de fin de ligne que <literal>\n</literal>, <literal>\r</literal> et <literal>\r\n</literal>, et <emphasis>ne retourne pas</emphasis> le d&eacute;limiteur lui-m&ecirc;me. </simpara> <para> Voir aussi <function>fread</function>, <function>fgets</function> et <function>fgetc</function>, </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 --> Index: phpdoc-fr/reference/stream/functions/stream-get-transports.xml +++ phpdoc-fr/reference/stream/functions/stream-get-transports.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <refentry id="function.stream-get-transports"> <refnamediv> <refname>stream_get_transports</refname> <refpurpose>Liste les gestionnaires de transports de sockets disponibles</refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> <type>array</type><methodname>stream_get_transports</methodname> <void/> </methodsynopsis> <simpara> <function>stream_get_transports</function> retourne un tableau index&eacute; contenant les noms des transports de sockets disponibles pour le syst&egrave;me. </simpara> <para> <example> <title>Exemple avec <function>stream_get_transports</function></title> <programlisting role="php"> <![CDATA[ <?php $xportlist = stream_get_transports(); print_r($xportlist); /* L'affichage ne sera jamais identique au suivant Note: Il peut y avoir plus ou moins de transports dans votre version de PHP --------------------------------------- Array ( [0] => tcp [1] => udp [2] => unix [3] => udg ) */ ?> ]]> </programlisting> </example> </para> <para> Voir aussi <function>stream_get_filters</function>, et <function>stream_get_wrappers</function> </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 --> Index: phpdoc-fr/reference/stream/functions/stream-socket-accept.xml +++ phpdoc-fr/reference/stream/functions/stream-socket-accept.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <refentry id="function.stream-socket-accept"> <refnamediv> <refname>stream_socket_accept</refname> <refpurpose> Accepte une connexion sur une socket cr&eacute;&eacute;e par <function>stream_socket_server</function> </refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> <type>resource</type><methodname>stream_socket_accept</methodname> <methodparam><type>resource</type><parameter>server_socket</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>timeout</parameter></methodparam> <methodparam choice="opt"><type>string</type><parameter>&amp;peername</parameter></methodparam> </methodsynopsis> <para> <function>stream_socket_accept</function> accepte une connexion sur une socket cr&eacute;&eacute;e pr&eacute;c&eacute;demment avec <function>stream_socket_server</function>. Si <parameter>timeout</parameter> est sp&eacute;cifi&eacute;, le d&eacute;lai d'expiration de la socket sera remplac&eacute; par cette valeur, exprim&eacute;e en secondes. L'adresse du client qui est connect&eacute; est retourn&eacute; dans <parameter>peername</parameter>, si cette valeur est accessible pour ce type de transport. </para> <simpara> <parameter>peername</parameter> peut aussi &ecirc;tre d&eacute;termin&eacute; plus tard avec <function>stream_socket_get_name</function>. </simpara> <simpara> Si <function>stream_socket_accept</function> &eacute;choue, elle retournera &false;. </simpara> <para> Voir aussi <function>stream_socket_server</function>, <function>stream_socket_get_name</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 --> Index: phpdoc-fr/reference/stream/functions/stream-socket-client.xml +++ phpdoc-fr/reference/stream/functions/stream-socket-client.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <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 fl&ocirc;t ou une connexion datagramme avec la destination <parameter>remote_socket</parameter>. Le type de socket cr&eacute;&eacute; est d&eacute;termin&eacute; par le transport sp&eacute;cifi&eacute; avec le formattage 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&ocirc;te. Pour une socket Unix,la <literal>cible</literal> doit &ecirc;tre un fichier de socket du syst&egrave;me. </para> <para> Le param&egrave;tre optionnel <parameter>timeout</parameter> sert &agrave; imposer un d&eacute;lai d'expiration, en secondes, &agrave; l'appel syst&egrave;me. </para> <para> <parameter>flags</parameter> est un champs de bits qui peut &ecirc;tre la combinaison de n'importe quelle option de connexion. Actuellement, les valeurs possibles pour ces options sont <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&eacute;lai d'expiration pour les op&eacute;rations via la socket, utilisez la fonction <function>stream_set_timeout</function>, car <parameter>timeout</parameter> de <function>stream_socket_client</function> ne s'appliqu que lors de la connexion &agrave; la socket. </simpara> </note> <para> <function>stream_socket_client</function> retourne une ressource de fl&ocirc;t, qui peut &ecirc;tre utilis&eacute;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 &eacute;choue, <function>stream_socket_client</function> va retourner &false; et si les param&egrave;tres optionnels <parameter>errno</parameter> et <parameter>errstr</parameter> sont fournis, ils recevront l'erreur exacte qui est survenue dans le syst&egrave;me lors de l'appel &agrave; <literal>connect()</literal>. Si la valeur retourn&eacute;e dans <parameter>errno</parameter> est <literal>0</literal> et que la fonction a retourn&eacute;e &false;, c'est une indication que l'erreur est survenue avant l'appel &agrave; <literal>connect()</literal>. Cela est probablement du &agrave; un probl&egrave;me d'initialisation de la socket. Notez que <parameter>errno</parameter> et<parameter>errstr</parameter> doivent &ecirc;tre pass&eacute; par r&eacute;f&eacute;rence. </para> <para> Suivant votre environnement, les sockets Unix ou le d&eacute;lai d'expiration peuvent ne pas &ecirc;tre disponibles. Une liste des transports disponibles qui sont disponibles sur le syst&egrave;me est accessible via <function>stream_get_transports</function>. </para> <para> Le fl&ocirc;t sera par d&eacute;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.exemple.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 "daytime" (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 "ERREIR : $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&ecirc;me si l'h&ocirc;te distant n'est pas accessible. Cette erreur ne deviendra apparente que lorsque vous essaierez de lire ou &eacute;crire des donn&eacute;es avec cette socket. La raison &agrave; cela est que UDP est un protocole sans connexion, ce qui signifie que le syst&egrave;me d'exploitaiton n'a pas &agrave; &eacute;tablir de lien pour la socket, jusqu'&agrave; ce qu'il commence &agrave; &eacute;changer des donn&eacute;es. </simpara> </warning> &ipv6.brackets; 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 --> Index: phpdoc-fr/reference/stream/functions/stream-socket-get-name.xml +++ phpdoc-fr/reference/stream/functions/stream-socket-get-name.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <refentry id="function.stream-socket-get-name"> <refnamediv> <refname>stream_socket_get_name</refname> <refpurpose>Lit le nom des sockets locale ou distante</refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> <type>string</type><methodname>stream_socket_get_name</methodname> <methodparam><type>resource</type><parameter>handle</parameter></methodparam> <methodparam><type>boolean</type><parameter>want_peer</parameter></methodparam> </methodsynopsis> <para> <function>stream_socket_get_name</function> retourne le nom de la socket locale ou distante pour la connexion <parameter>handle</parameter>. Si <parameter>want_peer</parameter> vaut &true;, le nom de la socket distante est retourn&eacute;. Si il vaut &false;, c'est le nom de la socket locale. </para> <para> Voir aussi <function>stream_socket_accept</function>. </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 --> Index: phpdoc-fr/reference/stream/functions/stream-socket-server.xml +++ phpdoc-fr/reference/stream/functions/stream-socket-server.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <refentry id="function.stream-socket-server"> <refnamediv> <refname>stream_socket_server</refname> <refpurpose> Cr&eacute;e une socket serveur Unix ou Internet </refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> <type>resource</type><methodname>stream_socket_server</methodname> <methodparam><type>string</type><parameter>local_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>int</type><parameter>flags</parameter></methodparam> <methodparam choice="opt"><type>resource</type><parameter>context</parameter></methodparam> </methodsynopsis> <para> <function>stream_socket_server</function> cr&eacute;e un fl&ocirc;t ou un datagramme sur la socket sp&eacute;cifi&eacute;e <parameter>local_socket</parameter>. Le type de socket cr&eacute;&eacute; est d&eacute;termin&eacute; par le transport sp&eacute;cifi&eacute; avec le formattage 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&ocirc;te. Pour une socket Unix,la <literal>cible</literal> doit &ecirc;tre un fichier de socket du syst&egrave;me. </para> <para> <parameter>flags</parameter> est un champs de bits qui peut &ecirc;tre la combinaison de n'importe quelle option de connexion. Actuellement, les valeurs possibles pour ces options sont <constant>STREAM_CLIENT_ASYNC_CONNECT</constant> et <constant>STREAM_CLIENT_PERSISTENT</constant>. La valeur par d&eacute;faut est <constant>STREAM_SERVER_BIND</constant> | <constant>STREAM_SERVER_LISTEN</constant>. <para> <function>stream_socket_server</function> ne fait que cr&eacute;er une socket, et pour accepter des connexions, vous devez utiliser <function>stream_socket_accept</function>. </para> <para> Si l'appel &eacute;choue, <function>stream_socket_server</function> va retourner &false; et si les param&egrave;tres optionnels <parameter>errno</parameter> et <parameter>errstr</parameter> sont fournis, ils recevront l'erreur exacte qui est survenue dans le syst&egrave;me lors de l'appel &agrave; <literal>connect()</literal>. Si la valeur retourn&eacute;e dans <parameter>errno</parameter> est <literal>0</literal> et que la fonction a retourn&eacute;e &false;, c'est une indication que l'erreur est survenue avant l'appel &agrave; <literal>connect()</literal>. Cela est probablement du &agrave; un probl&egrave;me d'initialisation de la socket. Notez que <parameter>errno</parameter> et<parameter>errstr</parameter> doivent &ecirc;tre pass&eacute; par r&eacute;f&eacute;rence. </para> <para> Suivant votre environnement, les sockets Unix ou le d&eacute;lai d'expiration peuvent ne pas &ecirc;tre disponibles. Une liste des transports disponibles qui sont disponibles sur le syst&egrave;me est accessible via <function>stream_get_transports</function>. </para> <para> <example> <title>Exemple avec <function>stream_socket_server</function></title> <programlisting role="php"> <![CDATA[ <?php $socket = stream_socket_server("tcp://0.0.0.0:8000", $errno, $errstr); if (!$socket) { echo "$errstr ($errno)<br>\n"; } else { while ($conn = stream_socket_accept($socket)) { fputs ($conn, 'Merci de vous connecter &agrave; mon serveur. L\'heure locale est ' . date('n/j/Y g:i a') . "\n"); fclose ($conn); } fclose($socket); } ?> ]]> </programlisting> </example> L'exemple ci-dessous vous montre comment lire la date et l'heure sur un service UDP de type "daytime" (port 13) sur votre propre machine, tel que pr&eacute;sent&eacute; avec la fonction <function>stream_socket_client</function> : <note> <simpara>La plupart des syst&egrave;mes ont besoin d'un acc&egrave;s administrateur pour ouvrir une socket au dela des ports 1024. </simpara> </note> <example> <title>Utiliser un serveur de socket UDP</title> <programlisting role="php"> <![CDATA[ <?php $socket = stream_socket_server("udp://0.0.0.0:13", $errno, $errstr); if (!$socket) { echo "ERROR: $errno - $errstr<br>\n"; } else { while ($conn = stream_socket_accept($socket)) { fwrite($conn, date("D M j H:i:s Y\r\n")); fclose($conn); } fclose($socket); } ?> ]]> </programlisting> </example> &ipv6.brackets; Voir aussi <function>stream_socket_client</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 -->
« previous php.doc.fr (#313) next »