mirror of
https://github.com/macintoshplus/doc-fr.git
synced 2026-03-31 21:32:17 +02:00
e21d575fd0
git-svn-id: https://svn.php.net/repository/phpdoc/fr/trunk@258457 c90b9560-bf6c-de11-be94-00142212c4b1
110 lines
4.2 KiB
XML
110 lines
4.2 KiB
XML
<?xml version="1.0" encoding="iso-8859-1"?>
|
|
<!-- $Revision: 1.2 $ -->
|
|
<!-- EN-Revision: 1.3 Maintainer: yannick Status: ready -->
|
|
<!-- Reviewed: yes -->
|
|
<!-- Purpose: remote.other -->
|
|
<!-- Membership: core -->
|
|
|
|
<book xml:id="book.stream" xmlns="http://docbook.org/ns/docbook">
|
|
<title>&Functions; sur les flux</title>
|
|
<titleabbrev>Flux</titleabbrev>
|
|
|
|
<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> (dit <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.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
|
|
--> |