Il offre les fonctions suivantes:

• readfile : renvoie le contenu d'un fichier
• writefile : écriture d'un fichier
• appendfile : écriture en fin de fichier
• sendfile : envoi d'un fichier
• unlink : effacement d'un fichier
• delete_files : effacer un fichier ou un répertoire récursivement
• copy : copie un fichier ou un répertoire récursivement
• getwebfile : chargement d'un fichier distant

readfile

La fonction prend un seul argument :

• le nom du fichier texte à lire

Elle retourne le contenu du fichier.

Code d'erreur renvoyé par la fonction :

• -1 : impossible d'ouvrir le fichier

Exemple d'utilisation de la fonction :

~readfile("liste.dat")

writefile

La fonction prend 2 arguments :

• Le nom du fichier (chemin complet)
• Le contenu à écrire dans le fichier

NOTE: si le fichier existe déjà, il est écrasé et ~writefile() y insère le nouveau contenu.

Code d'erreur renvoyé par la fonction :

• -1 : impossible d'ouvrir le fichier en écriture
• -2 : un problème est survenu pendant l'écriture du fichier

Exemple d'utilisation de la fonction :

~writefile("liste.dat", "foobar")

appendfile

La fonction prend 2 arguments :

• Le nom du fichier (chemin complet)
• Le contenu à écrire à la fin du fichier

Code d'erreur renvoyé par la fonction :

• -1 : impossible d'ouvrir le fichier en écriture en fin de fichier
• -2 : un problème est survenu pendant l'écriture du fichier

Exemple d'utilisation de la fonction :

~appendfile("liste.dat", "foobar")

sendfile

La fonction prend un argument :

• Le nom du fichier

Cette fonction permet d'envoyer le contenu d'un fichier sans que celui-ci soit interpreté par Templeet.
La fonction sendfile est donc plus rapide et surtout elle permet de ne pas charger l'intégralité du fichier en mémoire, ce qui peut se révéler impossible si le fichier est très volumineux.

Code d'erreur renvoyé par la fonction :

• -1 : impossible d'ouvrir le fichier en lecture
• -2 : la fonction sendfile a déjà été appelée dans ce template. Elle ne peut être appelée qu'une seule fois

Exemple d'utilisation de la fonction :

~rem('
 ~dont_cache()

 ~set('fichier','test.avi')
 ~set('chemin','le/chemin/du/fichier/')

 ~set("HTTP-Content-type","application/octetstream")
 ~set("HTTP-filename",~get("fichier"))
 ~sendfile("~get('chemin')~get('fichier')")
')

unlink

La fonction prend un argument :

• Le nom du fichier

Cette fonction est équivalente à la fonction php du même nom. Elle permet d'effacer un fichier.

delete_files

La fonction prend 1 argument

• le fichier ou le répertoire à effacer récursivement

Le format PCRE peut-être utilisé. Il peut aussi prendre en argument un tableau, il effacera tous les fichiers décrits dans le tableau.

Exemple d'utilisation de la fonction :

~delete_files("tmp/.*/.*\.html")

copy

La fonction ~copy peut prendre deux ou trois arguments :

• from : le fichier ou le répertoire source
• to : le répertoire destination
• safe : si la valeur est 1 alors la fonction sauvegarde les fichiers existants lors de la copie des fichiers. Si la valeur est -1 alors la fonction écrasera les fichiers existants lors de la copie des fichiers. (argument optionel)

La fonction copie récursivement.

Lorsque le paramètre safe est activé, la fonction renvoie la liste des fichiers qui ont été sauvegardés.

La fonction ne renvoie aucun code d'erreur

Exemple d'utilisation de la fonction :

~copy("template/", "backup/", 1)

getwebfile

Cette fonction permet le chargement d'un fichier distant ("http://").

• directory : nom du répertoire où enregistrer le fichier téléchargé
• url : url du fichier à télécharger

Si le paramètre directory est vide (""), alors le contenu du fichier téléchargé est directement renvoyé par la fonction. Si le paramètre directory n'est pas vide, la fonction renvoie le nom du fichier chargé.

Code d'erreur renvoyé par la fonction :

• -1 : impossible de charger le fichier
• -2 : erreur lors de l'écriture du fichier téléchargé

Exemple d'utilisation de la fonction ~getwebfile :

~getwebfile('', 'http://www.templeet.org/')