Files
2025-03-16 12:57:15 -03:00

92 lines
3.5 KiB
XML

<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 98d4a70aac9e7e3663282507f2f9ce014227e39d Maintainer: leonardolara Status: ready -->
<book xml:id="book.stream" xmlns="http://docbook.org/ns/docbook">
<?phpdoc extension-membership="core" ?>
<title>Fluxos</title>
<preface xml:id="intro.stream">
&reftitle.intro;
<simpara>
Fluxos são
o modo de se generalizar operações de arquivos, rede, compressão de dados e
outras que compartilham um conjunto comum de funções e usos. Em
sua definição mais simples, um <literal>fluxo</literal> é um
objeto tipo <type>resource</type> que exibe comportamento
de arquivo. Isto é, ele pode ser lido ou escrito de forma
linear, e pode ser pesquisado com <function>fseek</function> até
uma localização arbitrária dentro do fluxo.
</simpara>
<simpara>
Um <literal>empacotador</literal> é um código adicional que mostra ao fluxo como lidar
com protocolos/codificações específicas. Por exemplo, o empacotador <literal>http</literal>
sabe como traduzir uma URL em uma requisição <literal>HTTP/1.0</literal>
de um arquivo em um servidor remoto. Existem vários empacotadores
no PHP por padrão (consulte <xref linkend="wrappers"/>),
e empactotadores adicionais, customizados, que podem ser incluídos tanto em um
script PHP usando <function>stream_wrapper_register</function>,
ou diretamente de uma extensão.
Como qualquer variedade de empacotadores pode ser adicionada ao PHP,
não há limite definido do que pode ser feito com eles. Para acessar a lista
de empacotadores registrados atualmente, use a função <function>stream_get_wrappers</function>.
</simpara>
<para>
Um fluxo é referenciado como: <parameter>esquema</parameter>://<parameter>destino</parameter>
<itemizedlist>
<listitem>
<simpara>
<parameter>esquema</parameter> (string) -
O nome do empacotador a ser usado. Exemplos incluem: file,
http, https, ftp, ftps, compress.zlib, compress.bz2 e php. Consulte
<xref linkend="wrappers"/> para uma lista de empacotadores embutidos no PHP. Se
nenhum empacotador for especificado, o padrão da função é usado (tipicamente
<literal>file</literal>://).
</simpara>
</listitem>
<listitem>
<simpara>
<parameter>destino</parameter> -
Depende do empacotador em uso. Para fluxos relacionados a sistemas de arquivos é
tipicamente um caminho e nome para o arquivo desejado. Para fluxos relacionados
a rede é tipicamente um nome de host, frequentemente seguido por um caminho. Novamente, consulte
<xref linkend="wrappers"/> para uma descrição de alvos para os fluxos pré-existentes.
</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
-->