I file di configurazione sono utili ai progettisti per gestire le variabili globali del template in un unico file. Un esempio è quello dei colori. Normalmente, se volete cambiare lo schema dei colori di un'applicazione, dovreste andare in ogni template a cambiare i colori. Con un file di configurazione, i colori possono essere tenuti in un unico punto, e solo un file deve essere modificato.

# variabili globali
pageTitle = "Main Menu"
bodyBgColor = #000000
tableBgColor = #000000
rowBgColor = #00ff00

[Customer]
pageTitle = "Customer Info"

[Login]
pageTitle = "Login"
focus = "username"
Intro = """Questo è un valore che occupa più
           di una riga. Dovete racchiuderlo
           fra triple virgolette."""

# sezione nascosta
[.Database]
host=my.example.com
db=ADDRESSBOOK
user=php-user
pass=foobar

  

I valori delle variabili dei file di configurazione possono essere fra virgolette, ma non è necessario. Potete usare sia gli apici singoli ('), sia le virgolette doppie ("). Se avete un valore che occupa più di una riga, racchiudete l'intero valore fra triple virgolette ("""). Potete mettere commenti usando qualsiasi sintassi che non sia valida per il file di configurazione. Noi consigliamo l'uso di un cancelletto (#) all'inizio della riga.

Questo esempio di file di configurazione ha due sezioni. I nomi di sezione sono racchiusi fra parentesi quadre []. I nomi di sezioni possono essere stringhe dal contenuto arbitrario, purché non comprenda [ o ]. Le quattro variabili in alto sono variabili globali, non contenute in alcuna sezione. Queste variabili vengono sempre caricate dal file di configurazione. Se viene caricata una particolare sezione, allora saranno caricate le variabili globali e quelle di quella sezione. Se una variabile esiste sia come globale che in una sezione, verrà usata la variabile di sezione. Se date lo stesso nome a due variabili nella stessa sezione verrà usato l'ultimo valore.

I file di configurazione vengono caricati nel template con la funzione config_load.

Potete nascondere variabili o intere sezioni anteponendo un punto al nome della variabile o della sezione. Questo è utile se la vostra applicazione legge dai file di configurazione dati sensibili di cui il motore di template non ha bisogno. Se affidate a terzi la modifica del template, potete stare sicuri che non potranno leggere dati sensibili dal file di configurazione caricandolo nel template.