smarty/docs/de/programmers/caching/caching-setting-up.xml

<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision$ -->
<!-- EN-Revision: 1.6 Maintainer: andreas Status: ready -->
  <sect1 id="caching.setting.up">
   <title>Caching einrichten</title>
   <para>
    Als erstes muss das Caching eingeschaltet werden. Dies erreicht man, indem
    <link linkend="variable.caching">$caching</link> = 1 (oder 2) gesetzt wird.
   </para>
   <example>
    <title>Caching einschalten</title>
    <programlisting>
<![CDATA[
<?php
require('Smarty.class.php');
$smarty = new Smarty;

$smarty->caching = true;

$smarty->display('index.tpl');
?>
]]>
     </programlisting>
   </example>
   <para>
    Wenn Caching eingeschaltet ist, wird der Funktionsaufruf display('index.tpl')
    das Template normal rendern, zur selben Zeit jedoch auch eine Datei mit
    dem Inhalt in das <link linkend="variable.cache.dir">$cache_dir</link> schreiben
    (als gecachte Kopie). Beim n<>chsten Aufruf von display('index.tpl') wird die
    gecachte Kopie verwendet.
   </para>
   <note>
    <title>Technische Bemerkung</title>
    <para>
     Die im <link linkend="variable.cache.dir">$cache_dir</link>
     abgelegen Dateien haben einen <20>hnlichen Namen wie das Template,
     mit dem sie erzeugt wurden. Obwohl sie eine '.php'-Endung
     aufweisen, sind sie keine ausf<73>hrbaren PHP-Skripte.
     Editieren Sie diese Dateien NICHT!
    </para>
   </note>
   <para>
    Jede gecachte Seite hat eine Lebensdauer, die von <link
    linkend="variable.cache.lifetime">$cache_lifetime</link> bestimmt
    wird. Normalerweise betr<74>gt der Wert 3600 Sekunden (= 1
    Stunde). Nach Ablauf dieser Lebensdauer wird der Cache neu
    generiert. Sie k<>nnen die Lebensdauer pro Cache bestimmen indem
    Sie <link linkend="variable.caching">$caching</link> auf 2
    setzen. Konsultieren Sie den Abschnitt <20>ber <link
    linkend="variable.cache.lifetime">$cache_lifetime</link> f<>r
    weitere Informationen.
   </para>
   <example>
    <title>'$cache_lifetime' pro Cache einstellen</title>
    <programlisting>
<![CDATA[
<?php
require('Smarty.class.php');
$smarty = new Smarty;

$smarty->caching = 2; // Lebensdauer ist pro Cache

// Standardwert f<>r '$cache_lifetime' auf 5 Minuten setzen
$smarty->cache_lifetime = 300;
$smarty->display('index.tpl');

// '$cache_lifetime' f<>r 'home.tpl' auf 1 Stunde setzen
$smarty->cache_lifetime = 3600;
$smarty->display('home.tpl');

// ACHTUNG: die folgende Zuweisung an '$cache_lifetime' wird nicht funktionieren,
// wenn '$caching' auf 2 gestellt ist. Wenn die '$cache_lifetime' f<>r 'home.tpl' bereits
// auf 1 Stunde gesetzt wurde, werden neue Werte ignoriert.
// 'home.tpl' wird nach dieser Zuweisung immer noch eine '$cache_lifetime' von 1 Stunde haben
$smarty->cache_lifetime = 30; // 30 seconds
$smarty->display('home.tpl');
?>
]]>
</programlisting>
   </example>
   <para>
    Wenn <link linkend="variable.compile.check">$compile_check</link>
    eingeschaltet ist, werden alle in den Cache eingeflossenen
    Templates und Konfigurationsdateien hinsichtlich ihrer letzten
    <20>nderung <20>berpr<70>ft.  Falls eine der Dateien seit der Erzeugung des
    Cache ge<67>ndert wurde, wird der Cache unverz<72>glich neu
    generiert. Dadurch ergibt sich ein geringer Mehraufwand. F<>r
    optimale Performance sollte <link
    linkend="variable.compile.check">$compile_check</link> deshalb auf
    'false' gesetzt werden.
   </para>
   <example>
    <title>'$compile_check' einschalten</title>
    <programlisting>
<![CDATA[
<?php
require('Smarty.class.php');
$smarty = new Smarty;

$smarty->caching = true;
$smarty->compile_check = true;

$smarty->display('index.tpl');
?>
]]>
     </programlisting>
   </example>
   <para>
    Wenn <link linkend="variable.force.compile">$force_compile</link> eingeschaltet ist,
    werden die Cache-Dateien immer neu generiert und das Caching damit wirkungslos gemacht.
    <link linkend="variable.force.compile">$force_compile</link> wird normalerweise nur f<>r die Fehlersuche verwendet. 
    Ein effizienterer Weg das Caching auszuschalten w<>re, 
    <link linkend="variable.caching">$caching</link> auf 'false' (oder 0) zu setzen.
   </para>
   <para>
    Mit der Funktion <link linkend="api.is.cached">is_cached()</link> kann <20>berpr<70>ft
    werden, ob von einem Template eine gecachte Version vorliegt.
    In einem Template, das zum Beispiel Daten aus einer Datenbank bezieht,
    k<>nnen Sie diese Funktion verwenden, um den Prozess zu <20>berspringen.
   </para>
   <example>
    <title>is_cached() verwenden</title>
    <programlisting>
<![CDATA[
<?php
require('Smarty.class.php');
$smarty = new Smarty;

$smarty->caching = true;

if(!$smarty->is_cached('index.tpl')) {
    // kein Cache gefunden, also Variablen zuweisen
    $contents = get_database_contents();
    $smarty->assign($contents);
}

$smarty->display('index.tpl');
?>
]]>
     </programlisting>
   </example>
   <para>
    Mit der <link linkend="language.function.insert">{insert}</link> Funktion k<>nnen Sie
    Teile einer Seite dynamisch halten. Wenn zum Beispiel ein Banner in einer gecachten Seite
    nicht gecached werden soll, kann dessen Aufruf mit <link linkend="language.function.insert">{insert}</link> dynamisch gehalten werden.
    Konsultieren Sie den Abschnitt <20>ber <link linkend="language.function.insert">insert</link>
    f<>r weitere Informationen und Beispiele.
   </para>
   <para>
    Mit der Funktion <link linkend="api.clear.all.cache">clear_all_cache()</link> k<>nnen
    Sie den gesamten Template-Cache l<>schen. Mit <link linkend="api.clear.cache">clear_cache()</link>
    einzelne Templates oder <link linkend="caching.groups">Cache-Gruppen</link>.
   </para>
   <example>
    <title>Cache leeren</title>
    <programlisting>
<![CDATA[
<?php
require('Smarty.class.php');
$smarty = new Smarty;

$smarty->caching = true;

// alle Cache-Dateien l<>schen
$smarty->clear_all_cache();

// nur Cache von 'index.tpl' l<>schen
$smarty->clear_cache('index.tpl');

$smarty->display('index.tpl');
?>
]]>
     </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
-->