PHP HOWTO - Forms Framework: ffTemplate - Cronologia

Nuitari il 10:42, 29 gen 2009

2009-01-29T10:42:11Z

Nuitari il 10:39, 29 gen 2009

2009-01-29T10:39:59Z

Nuitari: PHP HOWTO - Forms Framework: cFormsTemplate moved to PHP HOWTO - Forms Framework: ffTemplate: rinomeclatura della classe

2009-01-29T10:38:33Z

PHP HOWTO - Forms Framework: cFormsTemplate moved to PHP HOWTO - Forms Framework: ffTemplate: rinomeclatura della classe

Nuitari il 10:37, 29 gen 2009

2009-01-29T10:37:56Z

Nuitari: /* Sinossi */

2008-01-20T01:17:34Z

‎Sinossi

Nuitari il 01:12, 20 gen 2008

2008-01-20T01:12:05Z

Nuova pagina

=Introduzione=

Questo articolo fa parte di una serie di HOW-TO sui componenti di Forms, un framework Open Source sviluppato da Samuele "Nuitari" Diella, un programmatore con esperienza decennale nel ramo dello sviluppo web.

Nella fattispecie, cFormsTemplate è la classe preposta alla gestione dei template, largamente utilizzata in tutto il framework ma utilizzabile separatamente in qualsiasi progetto.

Si tratta di una classe che l'autore ha trovato parecchi anni fa ( almeno 8 ) su web e che nel tempo ha modificato/riadattato/espanso/migliorato. Se qualcuno dovesse riconoscerla, può segnalarlo all'autore in modo che i dovuti credits siano inclusi nel codice.

=Come Ottenerla=

E' possibile scaricare la classe da questo indirizzo: http://www.formsframework.org/cFormsTemplate.php.gz. Per utilizzarla è sufficiente scompattare il file e posizionarlo in un qualsiasi punto del sito, a patto che sia raggiungibile con una direttiva di php "require" od "include"

=Sinossi=

La classe non fa altro che caricare un template html da una locazione, quindi lo elabora e costruisce al suo interno una serie di buffer con le parti che lo compongono. Attraverso alcune funzioni è possibile alterarne il contenuto in parte o completamente, per poi effettuare il "parsing" (ossia l'elaborazione). Il risultato del parsing (totale o parziale) può essere immediatamente stampato su stdout oppure restituito come variabile.

I template sono in tutto e per tutto dei file html con l'aggiunta di alcuni costrutti speciali, le "variabili" e le "sezioni".

Le variabili sono elementi di testo racchiusi fra parentesi graffe, ad esempio {data_corrente}.
Le sezioni sono blocchi html racchiusi da commenti html che cominciano con  e finiscono con 

La differenza fra i due è che le variabili possono solo essere sostituite con un contenuto, le sezioni invece possono essere ripetute N volte (un esempio comune è il record di una tabella). Le sezioni a loro volta possono essere usate allo stesso modo delle variabili.

=Il primo approccio=

Per comprenderne bene il funzionamento, è sufficiente fare un esempio molto banale. Supponiamo ad esempio di voler fetchare gli elementi di un array (magari il risultato di una query) e di voler visualizzare l'output in una tabella.

Innanzitutto realizziamo un semplice template, in un file che chiameremo "grid.html":

<pre>
<p>Tot Record: {totrec}</p>
<table>
<tr>
<td>Campo 1</td>
<td>Campo 2</td>
</tr>


<tr>
<td>{field1}</td>
<td>{field2}</td>
</tr>



<tr>
<td colspan="2">No Records.</td>
</tr>


</table>
<p>Tot Record: {totrec}</p>
</pre>

Quindi procediamo alla creazione del codice necessario a gestirlo.
Innanzitutto includiamo la classe ed istanziamo l'oggetto template. Come parametro l'oggetto richiede la dir che userà come partenza per la ricerca dei template.

<pre>
require("cFormsTemplate.php");
$tpl = new cFormsTemplate(dirname(__FILE__));
</pre>

A questo punto, carichiamo il file. Come parametro è necessario passare, oltre al nome del file, il nome di una sezione *fittizia* che l'oggetto usa per includere il template nella sua interezza

<pre>
$tpl->load_file("grid.html", "main");
</pre>

Ora non ci resta che creare/valorizzare il nostro array ed eseguire un ciclo sugli elementi.

<pre>
$records = array(
array("1", "pippo")
, array("2", "pluto")
);

if (count($records))
{
foreach($records as $key => $value)
{
</pre>

Per ogni elemento di record, andremo a mettere il primo valore nella variabile {field1}, il secondo nella variabile {field2} del template. A tal scopo useremo il metodo "set_var", il quale accetta come parametri il nome della variabile ed il contenuto da assegnare.

<pre>
$tpl->set_var("field1", htmlentities($value[0]));
$tpl->set_var("field2", htmlentities($value[1]));
</pre>

Quindi, una volta valorizzate le variabili, diremo al template di processare la sezione *come appare in quel preciso momento* e di accodarla al buffer. A tal scopo useremo il metodo "parse", il quale accetta come parametri il nome della sezione ed uno switch di gestione del buffer.

<pre>
$tpl->parse("Record", true);
}
</pre>

se invece di true avremmo usato false, il risultato non sarebbe stato accodato al buffer ma l'avrebbe sostituito.
A questo punto eliminamo la sezione "NoRecords", da visualizzare solo se non sono presenti elementi. Per far questo utilizzeremo il metodo set_var, in quanto come detto precedentemente è possibile utilizzare le sezioni come se fossero variabili.

<pre>
$tpl->set_var("NoRecords", "");
</pre>

Nel caso in cui non ci fossero stati record, invece, procediamo al contrario, eliminando la sezione "Record" e visualizzando la sezione "NoRecords"

<pre>
}
else
{
$tpl->set_var("Record", "");
$tpl->parse("NoRecords", false);
}
</pre>

Infine, impostiamo il valore di {totrec} con il numero totale di record disponibili, anche se 0.

<pre>
$tpl->set_var("totrec", count($records));
</pre>

e procediamo a visualizzare il template, usando il metodo pparse (print parse) dando come nome di sezione la sezione fittizia "main" utilizzata all'inizio per indicare il template nella sua interezza. Anche pparse accetta lo switch di gestione del buffer, esattamente come parse.

<pre>
$tpl->pparse("main", false);
</pre>

Se avessimo voluto il risultato dell'elaborazione del template in una variabile, invece che in output, avremmo potuto usare il metodo "rpparse"

<pre>
$out = $tpl->rpparse("main", false);
</pre>

Vediamo il nostro file php, che chiameremo grid.php, nella sua interezza:

<pre>
<?php
require("cFormsTemplate.php");
$tpl = new cFormsTemplate(dirname(__FILE__));
$tpl->load_file("grid.html", "main");
$records = array(
array("1", "pippo")
, array("2", "pluto")
);

if (count($records))
{
foreach($records as $key => $value)
{
$tpl->set_var("field1", htmlentities($value[0]));
$tpl->set_var("field2", htmlentities($value[1]));
$tpl->parse("Record", true);
}
$tpl->set_var("NoRecords", "");
}
else
{
$tpl->set_var("Record", "");
$tpl->parse("NoRecords", false);
}
$tpl->set_var("totrec", count($records));
$tpl->pparse("main", false);
?>
</pre>

Questo è quanto. Si tratta delle basi per poter utilizzare un template engine semplice come questo, ma la potenza e la comodità di un simile strumento dovrebbero apparire evidenti. Come si dovrebbe notare, l'html risulta comunque pulito e leggibile (la struttura non è alterata minimamente e non è presente codice html non standard) e lo stesso vale per il php (la logica di scrittura del codice rispetta la logica funzionale e non quella di visualizzazione).

=Conclusioni=

Ovviamente la classe contiene altre funzioni ed è possibile fare esempi più complicati d'utilizzo dei template (ad esempio l'utlizzo di sezioni nidificate). In base al gradimento, in seguito è possibile che l'articolo verrà approfondito ulteriormente.

=Credits=

Tutto il codice presente nell'articolo e nei file collegati è coperto dal licenza GPL v3.

L'autore dell'articolo, di Forms, il framework php e di tutti i file correlati al progetto è Samuele "Nuitari" Diella, mailto: samuele.diella@gmail.com

=Ringraziamenti=

Conraid, per la simpatia ed il costante supporto/bug-tracking

La comunità di Slacky.eu, la migliore del mondo

[[Category:Ufficio_e_Web]]

@@ Riga 182: / Riga 182: @@
 =Articoli Correlati=
-[[PHP HOWTO - Forms Framework: ffDb_sql]]
+[[PHP HOWTO - Forms Framework: ffDb_Sql]]
 [[Category:Ufficio_e_Web]]

@@ Riga 168: / Riga 168: @@
 Ovviamente la classe contiene altre funzioni ed è possibile fare esempi più complicati d'utilizzo dei template (ad esempio l'utlizzo di sezioni nidificate). In base al gradimento, in seguito è possibile che l'articolo verrà approfondito ulteriormente.
 =Credits=
@@ Riga 180: / Riga 183: @@
 La comunità di Slacky.eu, la migliore del mondo
 [[Category:Ufficio_e_Web]]

@@ Riga 3: / Riga 3: @@
 Questo articolo fa parte di una serie di HOW-TO sui componenti di Forms, un framework Open Source sviluppato da Samuele "Nuitari" Diella, un programmatore con esperienza decennale nel ramo dello sviluppo web.
-Nella fattispecie, cFormsTemplate è la classe preposta alla gestione dei template, largamente utilizzata in tutto il framework ma utilizzabile separatamente in qualsiasi progetto.
+Nella fattispecie, ffTemplate è la classe preposta alla gestione dei template, largamente utilizzata in tutto il framework ma utilizzabile separatamente in qualsiasi progetto.
 Si tratta di una classe che l'autore ha trovato parecchi anni fa ( almeno 8 ) su web e che nel tempo ha modificato/riadattato/espanso/migliorato. Se qualcuno dovesse riconoscerla, può segnalarlo all'autore in modo che i dovuti credits siano inclusi nel codice.
@@ Riga 9: / Riga 9: @@
 =Come Ottenerla=
-E' possibile scaricare la classe da questo indirizzo: http://www.formsframework.org/cFormsTemplate.php.gz. Per utilizzarla è sufficiente scompattare il file e posizionarlo in un qualsiasi punto del sito, a patto che sia raggiungibile con una direttiva di php "require" od "include"
+E' possibile scaricare la classe da questo indirizzo: http://www.noveanelli.com/ffTemplate.php.tar.gz. Per utilizzarla è sufficiente scompattare il file e posizionarlo in un qualsiasi punto del sito, a patto che sia raggiungibile con una direttiva di php "require" od "include"
 =Sinossi=
@@ Riga 57: / Riga 57: @@
 <pre>
-require("cFormsTemplate.php");
+require("ffTemplate.php");
-$tpl = new cFormsTemplate(dirname(__FILE__));
+$tpl = new ffTemplate(dirname(__FILE__));
 </pre>
@@ Riga 135: / Riga 135: @@
 <pre>
 <?php
-require("cFormsTemplate.php");
+require("ffTemplate.php");
-$tpl = new cFormsTemplate(dirname(__FILE__));
+$tpl = new ffTemplate(dirname(__FILE__));
 $tpl->load_file("grid.html", "main");
 $records = array(
@@ Riga 180: / Riga 180: @@
 La comunità di Slacky.eu, la migliore del mondo
 [[Category:Ufficio_e_Web]]

@@ Riga 17: / Riga 17: @@
 I template sono in tutto e per tutto dei file html con l'aggiunta di alcuni costrutti speciali, le "variabili" e le "sezioni".
-Le variabili sono elementi di testo racchiusi fra parentesi graffe, ad esempio {data_corrente}.
+Le variabili sono elementi di testo racchiusi fra parentesi graffe, ad esempio <pre>{data_corrente}</pre>
-Le sezioni sono blocchi html racchiusi da commenti html che cominciano con <!--BeginNOMESEZIONE--> e finiscono con <!--EndNOMESEZIONE-->
+Le sezioni sono blocchi html racchiusi da commenti html che cominciano con <pre><!--BeginNOMESEZIONE--></pre> e finiscono con <pre><!--EndNOMESEZIONE--></pre>
 La differenza fra i due è che le variabili possono solo essere sostituite con un contenuto, le sezioni invece possono essere ripetute N volte (un esempio comune è il record di una tabella). Le sezioni a loro volta possono essere usate allo stesso modo delle variabili.