Files
smarty/docs/pt_BR/designers/language-custom-functions/language-function-fetch.xml
2004-04-13 08:46:28 +00:00

107 lines
3.7 KiB
XML

<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision$ -->
<sect1 id="language.function.fetch">
<title>fetch</title>
<informaltable frame="all">
<tgroup cols="5">
<colspec colname="param" align="center" />
<colspec colname="type" align="center" />
<colspec colname="required" align="center" />
<colspec colname="default" align="center" />
<colspec colname="desc" />
<thead>
<row>
<entry>Nome do Atributo</entry>
<entry>Tipo</entry>
<entry>Requerido</entry>
<entry>Padrão</entry>
<entry>Descrição</entry>
</row>
</thead>
<tbody>
<row>
<entry>file</entry>
<entry>string</entry>
<entry>Sim</entry>
<entry><emphasis>n/a</emphasis></entry>
<entry>O arquivo, site http ou ftp para obter</entry>
</row>
<row>
<entry>assign</entry>
<entry>string</entry>
<entry>Não</entry>
<entry><emphasis>n/a</emphasis></entry>
<entry>A variável de template
que vai receber a saída</entry>
</row>
</tbody>
</tgroup>
</informaltable>
<para>
fetch é usado para obter arquivos do sistema de arquivos local,
http ou ftp, e mostrar o seu conteúdo. Se o nome do arquivo começar
com "http://", a página do web site será obtidae mostrada. Se o
nome do arquivo começar com "ftp://", o arquivo será obtido do servidor
ftp e mostrado. Para arquivos locais, o caminho completo do sistema de
arquivos deve ser dado, ou um caminho relativo ao script php executado.
</para>
<para>
Se você indicar o atributo especial "assign", a saída da função
fetch irá para uma variável de template ao ivés de
ser mostrado no template. (novo no Smarty 1.5.0)
</para>
<note>
<title>Nota Técnica</title>
<para>
Isto não suporta redirecionamento http, tenha
certesa de incluir a barra no final aonde necessário.
</para>
</note>
<note>
<title>Nota Técnica</title>
<para>
Se a segurança do template esta ativada e você
estiver obtendo um arquivo do sistema de arquivos local, isto
irá permitir apenas arquivos de um dos diretórios
definidos como seguros. ($secure_dir)
</para>
</note>
<example>
<title>fetch</title>
<programlisting>
{* inclui algum javascript no seu template *}
{fetch file="/export/httpd/www.domain.com/docs/navbar.js"}
{* embute algum texto sobre o tempo de outro web site *}
{fetch file="http://www.myweather.com/68502/"}
{* obtém um arquivo de notícias via ftp *}
{fetch file="ftp://user:password@ftp.domain.com/path/to/currentheadlines.txt"}
{* coloca o conteúdo obtido para uma varável de template *}
{fetch file="http://www.myweather.com/68502/" assign="weather"}
{if $weather ne ""}
&lt;b&gt;{$weather}&lt;/b&gt;
{/if}</programlisting>
</example>
</sect1>
<!-- 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
-->