La scelta di come gestire i template su Symfony è a discrezione dell'utente. Non siamo obbligati quindi ad avere un template engine ma volendo potremmo anche gestire le nostre pagine manualmente.
È chiaro però che quando si ha a che fare con molte pagine diventa piuttosto macchinoso non avere un template engine che ci supporti. Gli stessi creatori di Symfony hanno risolto il problema alla radice rilasciando Twig che viene rilasciato come libreria a sé stante, il che vuol dire che può essere integrata all'interno di qualsiasi applicazione indipendentemente dall'utilizzo del framework PHP.
Vediamo alcune caratteristiche che rendono Twig uno strumento molto potente:
- la sintassi è semplicissima e si riesce a essere operativi in pochissimo tempo.
- Template oriented
- Ereditarietà
- Estendibile: se gli strumenti messi a disposizione non dovrebbero essere sufficienti è possibile estendere la libreria in maniera del tutto immediata.
- Variabili o espressioni
{{ name }} - Tags
{% if name = 'Simone' %}ciao Simone{% endif %}
Lo scopo di questa lezione non è quello di trattare la libreria in maniera esauriente ma solo di introdurne le caratteristiche principali. Durante la guida esporremo altri concetti appena ne avremo la necessità.
La sintassi
Twig racchiude la sua sintassi all'interno di due tipologie principali di costrutto:
Qualsiasi cosa contenuta all'interno di due parentesi graffe viene prima elaborata e poi stampata a schermo, possiamo considerarlo l'equivalente di <?php echo $name ?>.
Se un'espressione si trova all'interno di una parentesi graffa e di un simbolo di percentuale è considerata invece un tag e viene utilizzata per gestire la logica della vista. L'equivalente, ad esempio, di <?php if ($name == 'Simone) { echo "ciao Simone"; }.
Variabili
L'accesso alle variabili del template è molto semplice e con la medesima sintassi riusciamo a gestire diversi casi d'uso. Per passare delle variabili a un template dobbiamo innanzitutto valorizzarle all'interno del controller. Se riprendiamo il controller creato nella precedente lezione all'interno del metodo render() possiamo passare un secondo parametro con un array di variabili che verranno “iniettate” nel template:
return $this->render('home/index.html.twig', [
'greeting' => 'Good morning',
'user' => [
'firstName' => 'Simone',
'lastName' => 'D\'Amico',
]
]);In questo modo, all'interno del template app/templates/home/index.html.twig possiamo accedere alle variabili in questo modo:
{{ greeting }}, {{ user.firstName}} {{ user.lastName}}Aprendo la pagina otterremo:
Good morning, Simone D'AmicoCome abbiamo notato, attraverso il . possiamo accedere alle chiavi di un array. In realtà nello stesso modo possiamo anche accedere alle proprietà di un oggetto. Twig infatti è capace di determinare il tipo della variabile e in caso di oggetto cerca all'interno di esso nell'ordine:
$user->firstName$user->firstName()$user->getFirstName()$user->isFirstName()is
Questa è sicuramente una delle scorciatoie più comode che permettono di risparmiare codice durante lo sviluppo.
Le doppie parentesi graffe oltre a stampare il contenuto di una variabile possono anche valutare un'espressione prima di stamparne il risultato:
{{ user.firstName == 'Simone' ? 'admin' : 'user' }}Le variabili possono anche essere dichiarate direttamente all'interno del template:
{% set fullName = user.firstName ~ ' ' ~ user.lastName %}L'operatore ~
fullName
Logiche di controllo
È abbastanza comune all'interno di un template dover verificare delle condizioni oppure ciclare degli elementi. Vediamo insieme come Twig ci consente di effettuare queste operazioni:
IF
{% if role = 'admin' %}
<h1>Sei un amministratore</h1>
{% elseif role = 'editor' %}
<h1>Sei un editor</h1>
{% else %}
<h1>Sei un utente normale</h1>
{% endif %}FOR
Supponiamo di avere un array di utenti $users che vengono passati alla vista, possiamo ciclarli attraverso il costrutto for in questo modo:
{% for user in users %}
{{ loop.index }} - {{ user.firstName }}
{% else %}
Nessun utente trovato
{% endfor %}Possiamo notare che ci sono due elementi di semplificazione rispetto al gestire i template nativamente con PHP:
-
il ciclo
forelse -
Il ciclo
forlooploop.indexloop.index0loop.revindexloop.revindex0loop.firsttrueloop.lasttrueloop.lengthloop.parent
Ci sono altre caratteristiche importanti del for che approfondiremo più avanti, per adesso vediamone un'ultima molto utile per iterare all'interno di sequenze:
{% for index in 0..100 %}
{% for index in 'a'..'z' %}Automaticamente il template engine creerà una sequenza dall'indice di partenza a quello di arrivo senza dover definire ulteriori variabili.