<?xml version="1.0" encoding="utf-8"?>

<!-- $Revision$ -->

<!-- EN-Revision: 98d4a70aac9e7e3663282507f2f9ce014227e39d Maintainer: PhilDaiguille Status: ready -->

<!-- Reviewed: yes -->

<book xml:id="book.stream" xmlns="http://docbook.org/ns/docbook">

<?phpdoc extension-membership="core" ?>

<title>Flujos</title>

<preface xml:id="intro.stream">

&reftitle.intro;

<simpara>

Los flujos ("<literal>streams</literal>" en inglés) son un método de

generalización de los ficheros, sockets,

conexiones de red, datos comprimidos y otras operaciones similares,

que comparten operaciones comunes. En su definición más simple,

un <literal>flujo</literal> es un <type>recurso</type> que

presenta capacidades de flujo: es decir, que estos objetos pueden

ser leídos o recibir escrituras de manera lineal, y disponen también

de medios para acceder a una posición arbitraria en el flujo.

</simpara>

<simpara>

Un <literal>gestor</literal> (literalmente,

<literal>wrapper</literal> en inglés), es una función que indica cómo se comporta el flujo específicamente. Es el caso del gestor

<literal>http</literal>, que sabe cómo traducir una URL en una

petición <literal>HTTP/1.0</literal> a un servidor remoto.

Existen numerosos gestores integrados en PHP

por defecto (ver <xref linkend="wrappers"/>),

y, además, gestores específicos pueden ser añadidos en

los scripts PHP con la función <function>stream_register_wrapper</function>,

o bien directamente por otra extensión.

Gracias a la flexibilidad de los gestores que pueden ser añadidos a PHP,

no hay límites a las posibilidades ofrecidas. Para conocer la lista

de los gestores actualmente registrados, se puede utilizar la función

<function>stream_get_wrappers</function>.

</simpara>

<para>

Un flujo se referencia como:

<parameter>scheme</parameter>://<parameter>target</parameter>

<itemizedlist>

<listitem>

<simpara>

<parameter>scheme</parameter> (string) -

El nombre del gestor a utilizar. Por ejemplo, <literal>file</literal>,

<literal>http</literal>, <literal>https</literal>,

<literal>ftp</literal>, <literal>ftps</literal>, <literal>compress.zlib</literal>,

<literal>compress.bz</literal> y <literal>php</literal>.

Ver <xref linkend="wrappers"/>

para una lista completa de los gestores registrados de PHP.

Si ningún gestor es especificado, se utiliza la función por defecto (típicamente,

<literal>file</literal>://).

</simpara>

</listitem>

<listitem>

<simpara>

<parameter>target</parameter> -

Depende del gestor utilizado. Para los flujos relativos a los sistemas

de ficheros, es típicamente una ruta y un nombre de fichero del

fichero deseado. Para los flujos relativos a las redes, es

típicamente el nombre de host, a menudo con una ruta añadida.

Ver también <xref linkend="wrappers"/>

para una descripción de los objetivos de los flujos integrados.

</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

-->