Files
doc-fr/reference/stream/book.xml

101 lines
3.9 KiB
XML

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 98d4a70aac9e7e3663282507f2f9ce014227e39d Maintainer: yannick Status: ready -->
<!-- Reviewed: yes -->
<book xml:id="book.stream" xmlns="http://docbook.org/ns/docbook">
<?phpdoc extension-membership="core" ?>
<title>Flux</title>
<preface xml:id="intro.stream">
&reftitle.intro;
<simpara>
Les flux ("<literal>streams</literal>" en anglais) sont une méthode de
généralisation des fichiers, sockets,
connexions réseau, données compressées et autres opérations du même type,
qui partagent des opérations communes. Dans sa définition la plus simple,
un <literal>flux</literal> est une <type>ressource</type> qui
présente des capacités de flux : c'est-à-dire que ces objets peuvent
être lus ou recevoir des écritures de manière linéaire, et dispose aussi
de moyen d'accéder à une position arbitraire dans le flux.
</simpara>
<simpara>
Un <literal>gestionnaire</literal> (littéralement,
<literal>wrapper</literal> en anglais), est une fonction qui indique comment le flux se comporte spécifiquement. C'est le cas du gestionnaire
<literal>http</literal>, qui sait comment traduire une URL en une
requête <literal>HTTP/1.0</literal> sur un serveur distant.
Il existe de nombreux gestionnaires intégrés à PHP
par défaut (voir <xref linkend="wrappers"/>),
et, de plus, des gestionnaires spécifiques peuvent être ajoutés dans
les scripts PHP avec la fonction <function>stream_register_wrapper</function>,
ou bien directement par une autre extension.
Grâce à la souplesse des gestionnaires qui peuvent être ajoutés à PHP,
il n'y a pas de limites aux possibilités offertes. Pour connaître la liste
des gestionnaires actuellement enregistrés, utilisez la fonction
<function>stream_get_wrappers</function>.
</simpara>
<para>
Un flux est référencé comme :
<parameter>scheme</parameter>://<parameter>target</parameter>
<itemizedlist>
<listitem>
<simpara>
<parameter>scheme</parameter> (string) -
Le nom du gestionnaire a utiliser. Par exemple, <literal>file</literal>,
<literal>http</literal>, <literal>https</literal>,
<literal>ftp</literal>, <literal>ftps</literal>, <literal>compress.zlib</literal>,
<literal>compress.bz</literal>. et <literal>php.</literal>.
Voir <xref linkend="wrappers"/>
pour une liste complète des gestionnaires enregistrés de PHP.
Si aucun gestionnaire n'est spécifié, la fonction par défaut est utilisée (typiquement,
<literal>file</literal>://).
</simpara>
</listitem>
<listitem>
<simpara>
<parameter>target</parameter> -
Dépend du gestionnaire utilisé. Pour les flux relatifs aux systèmes
de fichiers, c'est typiquement un chemin et un nom de fichier du
fichier désiré. Pour les flux relatifs aux réseaux, c'est
typiquement le nom d'hôte, souvent avec un chemin apposé.
Voir aussi <xref linkend="wrappers"/>
pour une description des cibles des flux intégrés.
</simpara>
</listitem>
</itemizedlist>
</para>
</preface>
&reference.stream.setup;
&reference.stream.constants;
&reference.stream.filters;
&reference.stream.contexts;
&reference.stream.errors;
&reference.stream.examples;
&reference.stream.php-user-filter;
&reference.stream.streamwrapper;
&reference.stream.reference;
</book>
<!-- 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:"~/.phpdoc/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
-->