Files
smarty/docs/pt_BR/programmers/caching/caching-multiple-caches.xml

109 lines
3.5 KiB
XML
Raw Normal View History

2004-04-13 11:47:32 +00:00
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision$ -->
<sect1 id="caching.multiple.caches">
<title>Multiple Caches Per Page</title>
<para>
Voc<6F> pode ter m<>ltiplos arquivos de cache para uma simples chamada de display()
ou fetch(). Vamos dizer que uma chamada para display('index.tpl') deve ter v<>rios
conte<74>do de sa<73>da diferentes dependendo de alguma condi<64><69>o, e voc<6F> quer separar
os caches para cada um. Voc<6F> pode fazer isso passando um cache_id como um
segundo par<61>metro para a chamada da fun<75><6E>o.
</para>
<example>
<title>Passando um cache_id para display()</title>
<programlisting>
require('Smarty.class.php');
$smarty = new Smarty;
$smarty->caching = true;
$my_cache_id = $_GET['article_id'];
$smarty->display('index.tpl',$my_cache_id);</programlisting>
</example>
<para>
Acima, n<>s estamos passando a vari<72>vel $my_cache_id para display() com o
cache_id. Para cada valor <20>nico de $my_cache_id, um cache em separado ir<69> ser
gerado para index.tpl. Nesse exemplo, "article_id" foi passado em URL e <20> usado
como o cache_id.
</para>
<note>
<title>Notas T<>cnicas</title>
<para>
Tenha muito cuidado quando passar valores do cliente (web brownser) dentro
da Smarty (ou alguma aplica<63><61>o PHP.) Embora o exemplo acima usando o article_id
vindo de uma URL pare<72>a f<>cil, isso poderia ter consequ<71>ncias ruins. O
cache_id <20> usado para criar um diret<65>rio no sistema de arquivos, ent<6E>o se o usu<73>rio
decidir passar um valor extremamente largo para article_id, ou escrever um script
que envia article_ids rand<6E>micos em um ritmo r<>pido, isso poderia possivelmente causar
problemas em n<>vel de servidor. Tenha certeza de limpar algum dado passado antes de usar isso. Nessa inst<73>ncia, talvez voc<6F>
saiba que o article_id tem um comprimento de 10 caracteres e isso <20> constitu<74>do somente
de alfa-num<75>ricos, e deve ser um
article_id v<>lido no database. Verifique isso!
</para>
</note>
<para>
Tenha certeza de passar o mesmo cache_id como o segundo
par<61>metro para <link linkend="api.is.cached">is_cached()</link> e
<link linkend="api.clear.cache">clear_cache()</link>.
</para>
<example>
<title>Passando um cache_id para is_cached()</title>
<programlisting>
require('Smarty.class.php');
$smarty = new Smarty;
$smarty->caching = true;
$my_cache_id = $_GET['article_id'];
if(!$smarty->is_cached('index.tpl',$my_cache_id)) {
// No cache available, do variable assignments here.
$contents = get_database_contents();
$smarty->assign($contents);
}
$smarty->display('index.tpl',$my_cache_id);</programlisting>
</example>
<para>
Voc<6F> pode limpar todos os caches para um cache_id em particular passando
o primeiro par<61>metro null para clear_cache().
</para>
<example>
<title>Limpando todos os caches para um cache_id em particular</title>
<programlisting>
require('Smarty.class.php');
$smarty = new Smarty;
$smarty->caching = true;
// clear all caches with "sports" as the cache_id
$smarty->clear_cache(null,"sports");
$smarty->display('index.tpl',"sports");</programlisting>
</example>
<para>
Desta maneira, voc<6F> pode "agrupar" seus
caches juntos dando-lhes o mesmo cache_id.
</para>
</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
-->