Vergleich der Paradigmen PHPTemplate und Twig

Über Twig

Twig ist eine kompilierte Template-Sprache auf PHP-Basis. Wenn Ihre Webseite gerendert wird, nimmt die Twig-Engine das Template und wandelt es in ein „kompiliertes“ PHP-Template um, das in einem geschützten Verzeichnis unter sites/default/files/php/twig gespeichert wird. Die Kompilierung erfolgt einmalig, Template-Dateien werden für die Wiederverwendung zwischengespeichert und bei Leerung des Twig-Caches neu kompiliert.

Die Drupal-Twig-Initiative hat dieselbe Motivation wie die Symfony-Initiative: eine moderne, leistungsfähige und objektorientierte Engine zu implementieren, die es Entwicklern erlaubt, sich besser auf Drupal zu konzentrieren.

1. Docblock

PHPTemplate:

<?php 
/** 
 * @file
 * Dateibeschreibung
 */
?>

Twig:

{# 
/** 
 * @file
 * Dateibeschreibung
 */
#}

2. Dateinamen und Funktionen

PHPTemplate-Datei: node--article.tpl.php
Twig-Datei: node--article.html.twig

PHPTemplate-Funktion: THEME_node_links()
Twig-Datei: node-links.html.twig

3. Variablen

Variable ausgeben:

PHPTemplate: <div class="content"><?php print $content; ?></div>
Twig: <div class="content">{{ content }}</div>

Element eines Hash-Key ausgeben [1]

PHPTemplate: <?php print $item['#item']['alt']; ?>
Twig: {{ item['#item'].alt }} 

Variable zuweisen:

PHPTemplate: <?php $custom_var = $content->comments; ?>
Twig: {% set custom_var = content.comments %}

Array zuweisen:

PHPTemplate: <?php $args = array('@author' => $author, '@date' => $created); ?>
Twig: {% set args = {'@author': author, '@date': created} %}

4. Bedingungen

PHPTemplate: <?php if ($content->comments): endif; ?>
Twig: {% if content.comments %} {% endif %}

PHPTemplate: <?php if (!empty($content->comments)): endif; ?>
Twig: {% if content.comments is not empty %} {% endif %}

PHPTemplate: <?php if (isset($content->comments)): endif; ?>
Twig: {% if content.comments is defined %} {% endif %}

PHPTemplate: <?php if ($count > 0): endif; ?>
Twig: {% if count > 0 %} {% endif %}

5. Kontrollstrukturen

PHPTemplate: <?php foreach ($users as $user) {} ?>
Twig: {% for user in users %} {% endfor %}

6. Filter

Escape von HTML-Sonderzeichen:

PHPTemplate: <?php print check_plain($title); ?>
Twig[2]: {{ title }}

Unverarbeitete Werte:

PHPTemplate: <?php print $title; ?>
Twig: {{ title|raw }}

Übersetzen:

PHPTemplate: <?php print t('Home'); ?>
Twig: {{ 'Home' | t }}

Übersetzen mit Platzhaltern:

PHPTemplate: <?php print t('Welcome, @username', array('@username' => $user->name)); ?>
Twig: {{ 'Welcome, @username'|t({ '@username': user.name }) }}

Drupal 8 Twig (mit trans tag extension):

{% set username = user.name %}
{% trans %}
  Welcome, {{ username }}
{% endtrans %}

Liste ausgeben:

PHPTemplate: <?php echo implode(',', $usernames); ?>
Twig: {{ usernames | join(', ') }}

Liste mit Markup ausgeben:

Twig: {{ usernames | safe_join(', ') }}

Im PHPTemplate-Beispiel muss $usernames ein Array von Strings sein. Gleiches gilt für das ursprüngliche Twig-Beispiel, bei dem „usernames“ ein Array von Strings ist. Im Drupal 8 Twig-Beispiel wird hingegen ein Array von Render-Arrays erwartet. Das ist ein wesentlicher Unterschied zwischen Drupal 8 Twig und dem Original Twig: Drupal 8 Twig „druckt“ sowohl einfachen Text als auch gerenderte Arrays.

Ein weiterer Punkt dieses Beispiels ist, dass alle drei Beispiele denselben Output liefern sollen, dies aber standardmäßig nicht tun. Beispiel:

{% set numbers = [{'#markup': 'One'}, {'#markup':'Two'}, {'#markup':'Three'}] %}
{{ numbers }}

Der obige Code würde erwarten, dass die Elemente mit Komma getrennt ausgegeben werden. Das Ergebnis ist jedoch: OneTwoThree

7. Steuerung von Leerzeichen

Twig bietet eine Leerzeichen-Kontrolle, mit der Leerzeichen, die zur Strukturierung des Templates dienen, entfernt werden können.

<div class="body">
  {{- block.content -}}
</div>

Das entspricht:

<div class="body">{{ block.content }}</div>

Achtung

• Das Beispiel zum Zugriff auf Hash-Key-Elemente kann sich zukünftig ändern
• Im zweiten Beispiel zeigen wir, wie Twig für das Escaping verantwortlich ist. Früher wurde dies in der Template-Datei oder im Preprocess erledigt. Diese Änderung ist besonders wichtig für diejenigen, die ein PHPTemplate-Theme für Drupal 8 erstellen wollen – Sie müssen Ihre eigenen Daten selbst escapen. ↩︎︎

Weitere Informationen:

• Twig-Issues im Drupal Core Issue Queue
• Twig-Konvertierungsanleitung auf drupal.org
• Twig-Dokumentation
• Script zum Konvertieren von PHPTemplate zu Twig
• Twigify-Modul zum Konvertieren von PHPTemplate zu Twig