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

<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision$ -->
<!-- EN-Revision: 1.1 Maintainer: thomasgm Status: ready -->
		<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>Obrigat<EFBFBD>rio</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>
			<note>
			<title>Nota T<>cnica</title>
			<para>
			include_php est<73> quase sendo retirado do Smarty, voc<6F> pode obter a mesma funcionalidade 
			usando uma fun<75><6E>o customizada em um template. A <20>nica raz<61>o para usar o include_php <20> 
			se voc<6F> realmente precisar deixar fun<75><6E>o php fora do diret<65>rio de plugin ou c<>digo da 
			sua aplica<63><61>o. Veja a se<73><65>o 
			<link linkend="tips.componentized.templates">templates componentizados</link> 
			para mais detalhes.
			</para>
			</note>
			<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 diret<65>rio especificado na vari<72>vel $trusted_dir. A tag include_php 
			deve ter o atributo	"file", o qual cont<6E>m o caminho para o arquivo php  
			inclu<6C>do, pode ser um camiho tanto absoluto ou relativo a $trusted_dir.
			</para>
			<para>
			include_php <20> um bom meio de manipular templates componentizados,
			e manter o c<>digo PHP separado dos arquivos de template. Digamos 
			que voc<6F> tenha um template que mostre a navega<67><61>o do seu site, o qual
			<09> preenchido 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>
<![CDATA[
load_nav.php
-------------

<?php

	// carrega vari<72>veis de um banco de dados mysql e define elas 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);

?>


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

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

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