smarty/docs/pt_BR/designers/language-builtin-functions/language-function-include-php.xml

<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision$ -->
		<sect1 id="language.function.include.php">
			<title>include_php</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<EFBFBD>o</entry>
                        <entry>Descri<EFBFBD><EFBFBD>o</entry>
                    </row>
                </thead>
                <tbody>
                    <row>
                        <entry>file</entry>
                        <entry>string</entry>
                        <entry>Sim</entry>
                        <entry><emphasis>n/a</emphasis></entry>
                        <entry>O nome do arquivo php a incluir</entry>
                    </row>
                    <row>
                        <entry>once</entry>
                        <entry>boolean</entry>
                        <entry>N<EFBFBD>o</entry>
                        <entry><emphasis>true</emphasis></entry>
                        <entry>Quando incluir ou n<>o o arquivo php mais de uma vez se
                        inclu<6C>do v<>rias vezes</entry>
                    </row>
                    <row>
                        <entry>assign</entry>
                        <entry>string</entry>
                        <entry>N<EFBFBD>o</entry>
                        <entry><emphasis>n/a</emphasis></entry>
                        <entry>O nome da vari<72>vel
                        que receber<65> a sa<73>da do arquivo php</entry>
                    </row>
                </tbody>
                </tgroup>
            </informaltable>
			<para>
			Tags include_php s<>o usadas para incluir um script php no seu template.
			Se a seguran<61>a estiver ativada, ent<6E>o o script php deve estar localizado
			no caminho $trusted_dir. A tag include_php deve ter o atributo
			"file", o qual cont<6E>m o caminho para o arquivo php a ser inclu<6C>do,
			ou relativo a $trusted_dir, ou um caminho absoluto.
			</para>
			<para>
			include_php <20> um bom meio de manipular templates com componentes,
			e mante o c<>digo PHP separado dos arquivos de template. Vamos dizer
			que voc<6F> tenha um template que mostre a navega<67><61>o do seu site, o qual
			<09> prenchido automaticamente a partir de um banco de dados. Voc<6F> pode 
			manter a sua l<>gica PHP que obt<62>m os dados em um diret<65>rio separado,
			e inclui-la no topo do template. Agora voc<6F> pode incluir este template
			em qualquer lugar sem se preocupar se a informa<6D><61>o do banco de dados foi
			obtida antes de usar.
			</para>
			<para>
			 Por padr<64>o, os arquivos php s<>o inclu<6C>dos apenas uma vez mesmo 
			 se inclu<6C>dos v<>rias vezes no template. Voc<6F> pode especificar que ele 
			 seja inclu<6C>do todas as vezes com o atributo <emphasis>once</emphasis>.
			 Definindo once para false ir<69> incluir o script php a cada vez que
			 ele seja inclu<6C>do no template.
			</para>
			<para>
			 Voc<6F> pode opcionalmente passar o atributo <emphasis>assign</emphasis>,
			 o qual ir<69> especificar uma vari<72>vel de template a qual ir<69> conter
			 toda a sa<73>da de 
			 <emphasis>include_php</emphasis> em vez de mostra-la.
			</para>
			<para>
			 O objeto smarty esta dispon<6F>vel como $this dentro do 
			 script php que voc<6F> incluiu.
			</para>
<example>
<title>Fun<EFBFBD><EFBFBD>o include_php</title>
<programlisting>
load_nav.php
-------------

&lt;?php

	// carrega vari<72>veis de um banco de dados mysql e define ela para o template
	require_once("MySQL.class.php");
	$sql = new MySQL;
	$sql->query("select * from site_nav_sections order by name",SQL_ALL);
	$this->assign('sections',$sql->record);

?&gt;


index.tpl
---------

{* caminho absoluto ou relativo a $trusted_dir *}
{include_php file="/path/to/load_nav.php"}

{foreach item="curr_section" from=$sections}
	&lt;a href="{$curr_section.url}"&gt;{$curr_section.name}&lt;/a&gt;&lt;br&gt;
{/foreach}</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
-->