Poređenje paradigmi PHPTemplate i Twig

O Twig-u

Twig je kompajlirani šablonski jezik zasnovan na PHP-u. Kada se vaša web stranica prikazuje, Twig engine uzima šablon i pretvara ga u "kompajlirani" PHP šablon koji se čuva u zaštićenom direktorijumu na putanji sites/default/files/php/twig. Kompajliranje se obavlja jednom, fajlovi šablona se keširaju za ponovnu upotrebu i rekompajliraju prilikom čišćenja Twig keša.

Drupal Twig inicijativa ima istu motivaciju kao i Symfony inicijativa: implementirati moderan, moćan, objektno-orijentisani engine koji programerima omogućava da se pravilno fokusiraju na Drupal.

1. Docblock

PHPTemplate:

<?php 
/** 
 * @file
 * Opis fajla
 */
?>

Twig:

{# 
/** 
 * @file
 * Opis fajla
 */
#}

2. Imena fajlova i funkcija

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

PHPTemplate funkcija: THEME_node_links()
Twig fajl: node-links.html.twig

3. Promenljive

Štampanje promenljive:

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

Štampanje elementa heš-ključa [1]

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

Postavljanje promenljive:

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

Postavljanje niza:

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

4. Uslovi

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. Kontrolne strukture

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

6. Filteri

Escapovani specijalni HTML karakteri:

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

Nerođeni (raw) izlaz:

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

Prevod:

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

Prevod sa zamenama:

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

Drupal 8 Twig (sa trans tag ekstenzijom):

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

Spajanje liste:

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

Spajanje liste sa markupom:

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

Primer PHPTemplate zahteva da je $usernames niz stringova. Isto važi i za originalni Twig primer, gde je "usernames" niz stringova. Sa druge strane, Drupal 8 Twig primer zahteva niz renderovanih objekata. Ovo je suštinska razlika između Drupal 8 Twig i originalnog Twig-a. Drupal 8 Twig može "štampati" i običan tekst i renderovane nizove.

Drugi aspekt ovog primera je da se očekuje da sva tri primera daju isti izlaz, ali to nije tako (podrazumevano). Uzmite primer:

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

Ovo bi trebalo da ispiše elemente razdvojene zarezom. Ali izlaz je: OneTwoThree

7. Kontrola razmaka

Twig ima kontrolu nad razmacima, što omogućava uklanjanje razmaka korišćenih za formatiranje šablona.

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

Ovo je isto kao:

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

Pažnja

• Primer elementa heš ključa može se promeniti u budućnosti
• U drugom primeru pokazujemo kako Twig sada upravlja sanitacijom podataka. Ranije je to rađeno u šablonu ili preprocess funkciji. Ova promena je važna za one koji žele da naprave PHPTemplate temu za Drupal 8 – morate sami sanitizovati svoje podatke. ↩︎︎

Za dodatne informacije pogledajte:

• Probleme sa Twig-om u glavnoj bazi problema
• Uputstvo za konverziju Twig-a na drupal.org
• Twig dokumentacija
• Skript za konverziju PHPTemplate u Twig
• Twigify modul za konverziju PHPTemplate u Twig