Lektion 3.5: Caches für Template-Entwickler
Exponential ist schnell, weil es auf mehreren Ebenen zwischenspeichert, und Template-Entwickler begegnen jeder davon:
Eine Änderung, die „nicht funktioniert“, ist oft ein Cache, der noch das alte Ergebnis enthält. Diese Lektion erklärt
die drei Caches, durch die ein Template läuft, wie man genau den leert, den eine Änderung braucht, und wie man
{cache-block} in eigenen Templates verwendet.
Auf einen Blick
| Kurs | Entwickler |
| Modul | Modul 3: Designs, Overrides und Fehlersuche |
| Dauer | 45 Minuten (20 Präsentation, 25 Übung) |
| Niveau | Fortgeschrittene |
| Zielgruppe | Entwickler und Template-Bauer |
| Voraussetzungen | Lektion 3.4 |
Lernziele
Nach dieser Lektion können die Teilnehmenden:
- den Cache der kompilierten Templates, den View-Cache der Inhalte und Cache-Blöcke beschreiben;
- Caches mit
php bin/php/ezcache.phpnach Tag und nach ID leeren; - den zu leerenden Cache für eine Template-Bearbeitung, einen neuen Override, eine Änderung der Einstellungen und eine Änderung eines Stylesheets wählen;
- einen
{cache-block}mitkeysundexpiryschreiben und wissen, wannsubtree_expiryundignore_content_expiryhelfen.
Hinweise für Trainer
So präsentieren Sie es
Quellen: Caches, settings/site.ini ([TemplateSettings], [ContentSettings])
und lib/eztemplate/classes/eztemplatecachefunction.php.
Drei Ebenen (6 Minuten).
Cache Einstellung (Standard) Enthält Leeren mit Kompilierte Templates [TemplateSettings] TemplateCompile=enabledJede .tpl, zu PHP kompiliert--clear-tag=templateView-Cache der Inhalte [ContentSettings] ViewCaching=enabled,CachedViewModes=full;sitemap;pdfDas gerenderte Ergebnis einer Knotenansicht --clear-tag=contentoder pro Knoten mitezcontentcache.phpCache-Blöcke [TemplateSettings] TemplateCache=enabledTeile eines Templates, die in {cache-block}eingeschlossen sind--clear-id=template-blockLeeren nach Tag und ID (4 Minuten).
php bin/php/ezcache.php --list-tagsund--list-idszeigen, was es gibt. Tags fassen IDs zusammen (content,template,ini...); IDs sind einzelne Caches (template-override,template-block,design_base,ezjscore-packer...). Gewöhnen Sie sich--clear-allnicht an: Es kostet die nächsten Besucher jeweils eine langsame Seite.Welcher Cache für welche Änderung (4 Minuten).
Sie haben geändert Leeren Eine vorhandene .tpltemplate(nichts, solangeTemplateCompile=disabled), danncontentfür zwischengespeicherte SeitenEine neue Override-Regel oder einen neuen Template-Pfad ini,template-override,template,contentEine Einstellung iniEin Stylesheet oder Skript, das der Packer lädt ezjscore-packerundtemplate-blockcache-block(6 Minuten).{cache-block keys=array( $uri_string ) expiry=3600}...{/cache-block}speichert die Ausgabe einmal pro Schlüsselkombination. Ohneexpirygelten standardmäßig zwei Stunden. Standardmäßig verfällt ein Cache-Block, sobald irgendein Inhalt veröffentlicht wird;ignore_content_expiryschaltet das ab,subtree_expirybeschränkt es auf einen Teilbaum.
Häufige Fragen
Sollte ich das Kompilieren auf meinem Entwicklungsrechner abschalten? Viele Entwickler setzen beim Bearbeiten von
Templates TemplateCompile=disabled, damit jede Änderung frisch gelesen wird. Niemals auf einer Live-Website.
Was tut eztc.php? Es kompiliert alle Templates eines Siteaccess im Voraus (php bin/php/eztc.php -s<sa>),
damit die ersten Besucher nach einem Deployment nicht für das Kompilieren bezahlen.
Kann die Administration Caches leeren? Ja: Setup > Cache-Verwaltung oder der Kasten Cache leeren mit Gesamter Cache, Inhalt, Template, Template und Inhalt, INI-Einstellungen und Statisch.
Stolperfallen
- Ein Cache-Block ohne Schlüssel um benutzerbezogene Inhalte. Alle sehen dann die Fassung des ersten Besuchers, zum Beispiel dessen Namen. Halten Sie benutzerbezogene Teile außerhalb von Cache-Blöcken oder versehen Sie sie mit den richtigen Schlüsseln.
- Leeren vor dem Neuladen der PHP-Worker. Auf einem Server, der PHP-Code im Speicher hält (Velocity, PHP-FPM), leeren Sie die Caches erst, wenn die Worker den neuen Code haben, sonst werden alte Seiten erneut zwischengespeichert (Lektion 13.2).
- Stylesheet-Änderungen, die nicht erscheinen. Der Name der gepackten Datei ist in einem Cache-Block des
Pagelayouts zwischengespeichert: Leeren Sie auch
template-block.
Praktische Übung
Auf der Entwicklungsinstallation, mit TemplateCompile=enabled (der Standard).
Listen Sie die Cache-Tags und -IDs auf:
php bin/php/ezcache.php --list-tagsundphp bin/php/ezcache.php --list-ids.Ändern Sie den Text der Kurszeile in
mysite_article.tplaus Lektion 3.2 und laden Sie einen Artikel neu. Notieren Sie, ob die Änderung erscheint.Leeren Sie nur den Template-Cache und laden Sie neu; leeren Sie dann den Tag content und laden Sie neu. Notieren Sie, welcher Schritt die Änderung sichtbar gemacht hat.
Leeren Sie den Cache nur eines Knotens:
php bin/php/ezcontentcache.php --clear-node=<node ID>und sehen Sie sich die Hilfe mit--helpan.Fügen Sie
mysite_article.tpleinen Cache-Block hinzu:cache-block keys=array( $node.node_id ) expiry=60 <p>Cached at currentdate()|l10n( 'shortdatetime' )</p> /cache-blockLeeren Sie die Tags
templateundcontentund laden Sie den Artikel zweimal neu: Die Uhrzeit bleibt gleich.Veröffentlichen Sie in der Administration eine Änderung an einem beliebigen Element und laden Sie neu: Der Block wurde erneuert, weil Cache-Blöcke standardmäßig beim Veröffentlichen verfallen.
Fügen Sie den Parametern des Blocks
ignore_content_expiryhinzu, leeren Sie die Template- und Inhalts-Caches und wiederholen Sie Schritt 7: Jetzt bleibt die Uhrzeit, bis die 60 Sekunden vorbei sind.Kompilieren Sie die Templates Ihres Siteaccess im Voraus:
php bin/php/eztc.php -s<sa>.Entfernen Sie den Cache-Block wieder, leeren Sie die Caches und committen Sie.
Erwartetes Ergebnis
- Schritt 3: Das Leeren des Template-Caches allein genügt nicht immer, wenn die Seite selbst im View-Cache liegt; nach dem Leeren des Inhalts-Caches erscheint die Änderung.
- Schritt 6: Zwei Neuladevorgänge zeigen dieselbe Uhrzeit; Schritt 7 zeigt eine neue Uhrzeit; Schritt 8 behält die Uhrzeit bis zum Ablauf.
- Schritt 9 listet die kompilierten Templates auf und endet ohne Fehler.
- Der Trainer fragt alle Teilnehmenden, welche Caches ein neuer Override braucht.
Quiz
- Welche Einstellung schaltet den View-Cache der Inhalte ein oder aus?
A.
TemplateCompileB.ViewCachingC.TemplateCacheD.DesignLocationCache - Was ist der Unterschied zwischen
--clear-tagund--clear-id? - Welche Caches braucht eine neue Override-Regel mit einem neuen Template?
- Wann verfällt ein
{cache-block}ohne Parameter? - Warum darf ein Block, der den Namen des aktuellen Benutzers zeigt, nicht ohne die richtigen Schlüssel zwischengespeichert werden?
Antworten
- B.
[ContentSettings] ViewCaching. - Ein Tag fasst mehrere Caches zusammen; eine ID nennt einen einzelnen Cache.
ini,template-override,templateundcontentfür bereits zwischengespeicherte Seiten.- Nach den standardmäßigen zwei Stunden oder früher, wenn Inhalte veröffentlicht werden.
- Die Ausgabe des ersten Besuchers würde allen gezeigt.
Weiterführende Literatur
- Caches: was jeder enthält und wie man ihn leert.
- Caches vorab füllen: Seiten nach einem Deployment aufwärmen.
- Eine Website betreiben: danach leeren, was sich geändert hat.
Verwandte Seiten
- Modul 3: Designs, Overrides und Fehlersuche
- Entwickler: Kursüberblick
- Trainer: hier beginnen
- Freie Dokumentation: Diese Seite darf unter der GNU FDL 1.3 frei kopiert, übersetzt und verbessert werden.
Werden Sie Exponential-Partner
Partner teilen ihre Informationen, stellen Mittel bereit, geben Beiträge zurück und entwickeln die Produkte mit uns, und so wächst Exponential. Eine Partner-Website und ein Dashboard sind für Mitte 2027 geplant: Werden Sie noch heute Partner, damit wir schneller wachsen und neue Funktionen früher liefern.