Smarty: Grundlagen und typische Muster

Smarty war über viele Jahre die verbreitetste PHP-Template-Engine und steckt bis heute in zahllosen Shop- und CMS-Installationen. Wer ein solches Projekt übernimmt, kommt an ihr nicht vorbei.

Aufbau

<?php
require_once 'smarty/Smarty.class.php';

$smarty = new Smarty();
$smarty->setTemplateDir('templates/');
$smarty->setCompileDir('templates_c/');
$smarty->setCacheDir('cache/');

$smarty->assign('titel', 'Unsere Produkte');
$smarty->assign('produkte', $produkte);

$smarty->display('produkte.tpl');

Vier Verzeichnisse, von denen zwei beschreibbar sein müssen: templates_c für das Kompilat und cache für die zwischengespeicherte Ausgabe. Sie gehören ausserhalb des Dokumentwurzelverzeichnisses oder hinter eine Zugriffssperre – im Kompilat steht dein PHP-Code.

Templatesyntax

<h1>{$titel|escape}</h1>

{foreach $produkte as $p}
  <div class="produkt">
    <h2>{$p.name|escape}</h2>
    <p>{$p.preis|string_format:"%.2f"} Euro</p>
    {if $p.rabatt}
      <span class="badge">Reduziert</span>
    {/if}
  </div>
{foreachelse}
  <p>Keine Produkte gefunden.</p>
{/foreach}

{foreachelse} greift, wenn das Array leer ist – praktisch, weil sonst eine zusätzliche Prüfung im PHP nötig wäre.

Modifier

Modifier hängen mit | an einen Wert an und lassen sich verketten:

{$p.beschreibung|escape|truncate:120:"…"|nl2br}

Die Reihenfolge ist wichtig: erst escapen, dann kürzen. Umgekehrt könnte das Kürzen eine HTML-Entity in der Mitte durchtrennen.

Escaping global einschalten

Smarty escapet standardmässig nicht. Das lässt sich global ändern:

$smarty->escape_html = true;

Bei einem Bestandsprojekt ist das kein Einzeiler. Zwei Effekte treten sofort auf:

1. Templates mit vorhandenem |escape escapen doppelt – aus & wird &.
2. Werte, die bewusst HTML enthalten (Redaktionstexte, generierte Tabellen), erscheinen als sichtbarer Quelltext.

Der Weg dorthin führt über einen Durchgang durch alle Templates: |escape entfernen, wo es überflüssig wird, und bewusst ungeschützte Ausgaben mit |smarty:nodefaults oder {$var nofilter} markieren. Aufwand ja – aber danach ist der sichere Weg der Standardweg.

Caching richtig verstehen

Zwei Ebenen, die oft verwechselt werden:

Kompilieren passiert immer. Smarty übersetzt das Template beim ersten Aufruf in PHP-Code und legt ihn in templates_c ab. Das lässt sich nicht abschalten und ist kein Caching der Ausgabe.

Caching der fertigen Ausgabe muss man einschalten:

$smarty->caching = Smarty::CACHING_LIFETIME_CURRENT;
$smarty->cache_lifetime = 3600;

// personalisierte Seiten brauchen eine eigene Cache-ID
$smarty->display('produkte.tpl', $kategorieId);

Die Cache-ID ist der Punkt, an dem in der Praxis Fehler passieren. Ohne sie bekommt jede Kategorie denselben zwischengespeicherten Inhalt. Bei personalisierten Seiten gehört die Nutzerkennung mit hinein – oder das Caching bleibt für diese Seiten aus.

Für Teile, die nie gecacht werden dürfen:

{nocache}
  <p>Angemeldet als {$user.name|escape}</p>
{/nocache}

Wo Smarty heute steht

Fair eingeordnet:

• Für Bestandsprojekte: völlig in Ordnung. Aktuelle Versionen laufen auf aktuellem PHP, die Engine wird gepflegt, und eine Migration nach Twig kostet Wochen ohne fachlichen Gewinn.
• Für Neuprojekte: Twig ist die naheliegendere Wahl. Automatisches Escaping ab Werk, ausgereifte Template-Vererbung, deutlich mehr Editor- und Werkzeugunterstützung, und in Symfony wie Drupal ohnehin vorhanden.

Der eine Fall, in dem Smarty auch heute noch von sich aus überzeugt: ein Team, das die Syntax seit Jahren kennt und Templates täglich anfasst. Vertrautheit ist ein echter Produktivitätsfaktor und wird in Technologievergleichen regelmässig unterschlagen.