mirror of
https://github.com/macintoshplus/doc-fr.git
synced 2026-03-29 12:22:19 +02:00
be1115f586
git-svn-id: https://svn.php.net/repository/phpdoc/fr/trunk@278186 c90b9560-bf6c-de11-be94-00142212c4b1
110 lines
4.2 KiB
XML
110 lines
4.2 KiB
XML
<?xml version="1.0" encoding="utf-8"?>
|
|
<!-- $Revision: 1.6 $ -->
|
|
<!-- EN-Revision: 1.5 Maintainer: yannick Status: ready -->
|
|
<!-- Reviewed: yes -->
|
|
<!-- Purpose: remote.other -->
|
|
<!-- Membership: core -->
|
|
|
|
<book xml:id="book.stream" xmlns="http://docbook.org/ns/docbook">
|
|
<title>Flux</title>
|
|
|
|
<preface xml:id="intro.stream">
|
|
&reftitle.intro;
|
|
<simpara>
|
|
Les flux ("<literal>streams</literal>" en anglais) ont été introduits
|
|
en PHP 4.3.0 comme 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 <literal>ressource</literal> 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 à des positions arbitraires 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, en utilisant l'API C de
|
|
<xref linkend="internals2.streams"/>.
|
|
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>
|
|
<para>
|
|
<note>
|
|
<para>
|
|
Des informations sur l'utilisation des flux dans le code source de PHP
|
|
peuvent être trouvées dans
|
|
<link linkend="internals2.ze1.streams">l'API des flux pour les auteurs d'extensions PHP</link>.
|
|
</para>
|
|
</note>
|
|
</para>
|
|
</preface>
|
|
|
|
&reference.stream.setup;
|
|
&reference.stream.constants;
|
|
&reference.stream.filters;
|
|
&reference.stream.contexts;
|
|
&reference.stream.errors;
|
|
&reference.stream.examples;
|
|
&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:"../../../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
|
|
--> |