Files
doc-fr/reference/stream/constants.xml
Damien Seguy 9818edb384 synch with en
git-svn-id: https://svn.php.net/repository/phpdoc/fr/trunk@277587 c90b9560-bf6c-de11-be94-00142212c4b1
2009-03-22 17:05:51 +00:00

365 lines
12 KiB
XML

<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.24 $ -->
<!-- EN-Revision: 1.18 Maintainer: yannick Status: ready -->
<!-- Reviewed: yes -->
<appendix xml:id="stream.constants" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> &reftitle.constants;
&extension.constants;
<para>
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>Constante</entry>
<entry>Description</entry>
</row>
</thead>
<tbody>
<row>
<entry><constant>STREAM_FILTER_READ</constant></entry>
<entry>
Utilisée avec <function>stream_filter_append</function> et
<function>stream_filter_prepend</function> pour indiquer
que le filtre spécifié ne doit être appliqué qu'après la
<emphasis>lecture</emphasis>.
</entry>
</row>
<row>
<entry><constant>STREAM_FILTER_WRITE</constant></entry>
<entry>
Utilisée avec <function>stream_filter_append</function> et
<function>stream_filter_prepend</function> pour indiquer
que le filtre spécifié ne doit être appliqué qu'après l'
<emphasis>écriture</emphasis>.
</entry>
</row>
<row>
<entry><constant>STREAM_FILTER_ALL</constant></entry>
<entry>
Cette constante est équivalente à
<code>STREAM_FILTER_READ |
STREAM_FILTER_WRITE</code>
</entry>
</row>
<row>
<entry><constant>PSFS_PASS_ON</constant> *</entry>
<entry>Le <literal>code retourné</literal> indique que le
filtre utilisateur retourne
des données dans <parameter>$out</parameter>.
</entry>
</row>
<row>
<entry><constant>PSFS_FEED_ME</constant> *</entry>
<entry>Le <literal>code retourné</literal> indique que le
filtre utilisateur ne retourne
pas de données dans <parameter>$out</parameter>
(i.e. aucune donnée disponible).
</entry>
</row>
<row>
<entry><constant>PSFS_ERR_FATAL</constant> *</entry>
<entry>Le <literal>code retourné</literal> indique que le
filtre utilisateur a produit une erreur fatale.
(i.e. données invalides reçues).
</entry>
</row>
<row>
<entry><constant>PSFS_FLAG_NORMAL</constant></entry>
<entry>Opérations normales de lecture et écriture.</entry>
</row>
<row>
<entry><constant>PSFS_FLAG_FLUSH_INC</constant></entry>
<entry>Écriture incrémentale.</entry>
</row>
<row>
<entry><constant>PSFS_FLAG_FLUSH_CLOSE</constant></entry>
<entry>Écriture en bloc, à la fermeture.</entry>
</row>
<row>
<entry><constant>STREAM_USE_PATH</constant></entry>
<entry>
Option indiquant si <literal>stream</literal>
a utilisé l'<option>include_path</option>.
</entry>
</row>
<row>
<entry><constant>STREAM_REPORT_ERRORS</constant></entry>
<entry>
Option indiquant si le gestionnaire est responsable
pour la levée des erreurs avec <function>trigger_error</function>
durant l'ouverture du flux. Si cette constante n'existe pas,
vous ne devez pas émettre d'erreurs.
</entry>
</row>
<row>
<entry><constant>STREAM_CLIENT_ASYNC_CONNECT</constant> *</entry>
<entry>
Ouvre un socket client en mode asynchrone. Cette option doit être utilisée
avec l'option <constant>STREAM_CLIENT_CONNECT</constant>.
À utiliser avec la fonction <function>stream_socket_client</function>.
</entry>
</row>
<row>
<entry><constant>STREAM_CLIENT_CONNECT</constant> *</entry>
<entry>
Ouvre un socket client. Les sockets clients doivent toujours inclure ce flag.
À utiliser avec la fonction <function>stream_socket_client</function>.
</entry>
</row>
<row>
<entry><constant>STREAM_CLIENT_PERSISTENT</constant> *</entry>
<entry>Le socket client ouvert avec <function>stream_socket_client</function>
doit rester persistant entre chaque page chargée.
</entry>
</row>
<row>
<entry><constant>STREAM_SERVER_BIND</constant> *</entry>
<entry>Appel un flux créé avec la fonction <function>stream_socket_server</function>
pour s'identifier sur la cible définie. Les sockets serveur doivent toujours utiliser
cette constante.
</entry>
</row>
<row>
<entry><constant>STREAM_SERVER_LISTEN</constant> *</entry>
<entry>Appel un flux créé avec <function>stream_socket_server</function>
et utilise la constante <constant>STREAM_SERVER_BIND</constant> pour commencer
à écouter la socket. Les connexions orientées transports (comme TCP) doivent utiliser
cet option sinon la socket serveur ne sera pas activée.
Utiliser cette option pour les connexions basses de transports, comme UDP,
est une erreur.
</entry>
</row>
<row>
<entry><constant>STREAM_NOTIFY_RESOLVE</constant> *</entry>
<entry>
Une adresse distante requise pour ce flux a été résolue, ou bien la résolution a échoué.
Voir le paramètre <parameter>severity</parameter> pour avoir une indication
sur l'événement survenu.
</entry>
</row>
<row>
<entry><constant>STREAM_NOTIFY_CONNECT</constant></entry>
<entry>
Une connexion avec une ressource externe a été établie.
</entry>
</row>
<row>
<entry><constant>STREAM_NOTIFY_AUTH_REQUIRED</constant></entry>
<entry>
Une autorisation supplémentaire est demandée pour accéder à la ressource spécifiée.
Typiquement utilisé avec le niveau d'alerte <parameter>severity</parameter> de la constante
<constant>STREAM_NOTIFY_SEVERITY_ERR</constant>.
</entry>
</row>
<row>
<entry><constant>STREAM_NOTIFY_MIME_TYPE_IS</constant></entry>
<entry>
Le <literal>type mime</literal> de la ressource a été identifié : voir
le paramètre <parameter>message</parameter> pour une description
du type découvert.
</entry>
</row>
<row>
<entry><constant>STREAM_NOTIFY_FILE_SIZE_IS</constant></entry>
<entry>
La <literal>taille</literal> de la ressource a été découverte.
</entry>
</row>
<row>
<entry><constant>STREAM_NOTIFY_REDIRECTED</constant></entry>
<entry>
La ressource externe a redirigé le flux vers un endroit différent.
Voir le paramètre <parameter>message</parameter>.
</entry>
</row>
<row>
<entry><constant>STREAM_NOTIFY_PROGRESS</constant></entry>
<entry>
Indique l'actuelle progression du transfert du flux dans
<parameter>bytes_transferred</parameter> et peut-être
<parameter>bytes_max</parameter> également.
</entry>
</row>
<row>
<entry><constant>STREAM_NOTIFY_COMPLETED</constant> *</entry>
<entry>
Il n'y a plus de données disponibles sur le flux.
</entry>
</row>
<row>
<entry><constant>STREAM_NOTIFY_FAILURE</constant></entry>
<entry>
Une erreur générique est intervenue sur le flux, consultez les paramètres
<parameter>message</parameter> et <parameter>message_code</parameter>
pour plus de détails.
</entry>
</row>
<row>
<entry><constant>STREAM_NOTIFY_AUTH_RESULT</constant></entry>
<entry>
L'autorisation est terminée (avec succès ou pas).
</entry>
</row>
<row>
<entry><constant>STREAM_NOTIFY_SEVERITY_INFO</constant></entry>
<entry>
Notification normale, aucune erreur signalée.
</entry>
</row>
<row>
<entry><constant>STREAM_NOTIFY_SEVERITY_WARN</constant></entry>
<entry>
Erreur non critique. Le traitement continue.
</entry>
</row>
<row>
<entry><constant>STREAM_NOTIFY_SEVERITY_ERR</constant></entry>
<entry>
Une erreur critique est survenu. Le traitement ne peut continuer.
</entry>
</row>
<row>
<entry><constant>STREAM_IPPROTO_ICMP</constant> +</entry>
<entry>
Fournit un socket ICMP.
</entry>
</row>
<row>
<entry><constant>STREAM_IPPROTO_IP</constant> +</entry>
<entry>
Fournit un socket IP.
</entry>
</row>
<row>
<entry><constant>STREAM_IPPROTO_RAW</constant> +</entry>
<entry>
Fournit un socket RAW.
</entry>
</row>
<row>
<entry><constant>STREAM_IPPROTO_TCP</constant> +</entry>
<entry>
Fournit un socket TCP.
</entry>
</row>
<row>
<entry><constant>STREAM_IPPROTO_UDP</constant> +</entry>
<entry>
Fournit un socket UDP.
</entry>
</row>
<row>
<entry><constant>STREAM_PF_INET</constant> +</entry>
<entry>
Protocole Internet version 4 (IPv4).
</entry>
</row>
<row>
<entry><constant>STREAM_PF_INET6</constant> +</entry>
<entry>
Protocole internet version 6(IPv6).
</entry>
</row>
<row>
<entry><constant>STREAM_PF_UNIX</constant> +</entry>
<entry>
Protocoles internes des systèmes Unix.
</entry>
</row>
<row>
<entry><constant>STREAM_SOCK_DGRAM</constant> +</entry>
<entry>
Fournit des datagrammes, qui sont des messages de connexion (UDP, par
exemple).
</entry>
</row>
<row>
<entry><constant>STREAM_SOCK_RAW</constant> +</entry>
<entry>
Fournit un socket raw, qui fournit un accès aux protocoles et interfaces internes
du réseau. Habituellement, ce type de socket n'est disponible qu'à l'utilisateur root.
</entry>
</row>
<row>
<entry><constant>STREAM_SOCK_RDM</constant> +</entry>
<entry>
Fournit un socket RDM (Reliably-delivered messages).
</entry>
</row>
<row>
<entry><constant>STREAM_SOCK_SEQPACKET</constant> +</entry>
<entry>
Fournit un socket de flux de paquets en séquence.
</entry>
</row>
<row>
<entry><constant>STREAM_SOCK_STREAM</constant> +</entry>
<entry>
Fournit un flux en séquence, deux chemins avec un mécanisme de transmission
pour les données "out-of-band" (TCP par exemple).
</entry>
</row>
<row>
<entry><constant>STREAM_SHUT_RD</constant></entry>
<entry>
Utilisé avec <function>stream_socket_shutdown</function> pour désactiver
les réceptions futures. Ajouté en PHP 5.2.1.
</entry>
</row>
<row>
<entry><constant>STREAM_SHUT_WR</constant></entry>
<entry>
Utilisé avec <function>stream_socket_shutdown</function> pour désactiver
les transmissions futures. Ajouté en PHP 5.2.1.
</entry>
</row>
<row>
<entry><constant>STREAM_SHUT_RDWR</constant></entry>
<entry>
Utilisé avec <function>stream_socket_shutdown</function> pour désactiver
les réceptions et transmissions futures. Ajouté en PHP 5.2.1.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</para>
<note>
<simpara>
Les constantes marquées avec une <literal>*</literal>
sont uniquement disponibles depuis PHP 5.0.0.
</simpara>
</note>
<note>
<simpara>
Les constantes marquées avec une <literal>+</literal> sont disponibles
depuis PHP 5.1.0 et sont faites pour être utilisées avec la fonction
<function>stream_socket_pair</function>. Notez que quelques-unes de ces constantes
peuvent ne pas être disponibles sur votre système.
</simpara>
</note>
</appendix>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../../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
-->