Accueil > Documentation > Les balises XPX > DIR

DIR

La balise <dir> (disponible à partir de la version 4.0) permet la manipulation des dossiers :

  • list : listage du contenu d'un dossier,

  • create : création d'un dossier (remplacera à terme la balise <create dir...>).

<dir list="dirpath" name="array" [pattern="..."]>

L'attribut list permet de lister le contenu du répertoire défini par dirtpath.

L'attribut pattern (valable à partir de v4.0a8) permet de filtrer la liste :

  • sur Linux, les caractères * ou ? (wilrdcard) peuvent être utilisés ainsi que des expressions entre [] (cf doc POSIX de fnmatch),

  • sur Windows, seuls les caractères * et ? sont opérationnels (cf doc de FindFirstFileA).

Le résultat est retourné via l'attribut name, sous forme d'un tableau à 4 colonnes nommées :

  • name : nom de l'élément du dossier
  • type : type ("dir" ou "file")
  • size : taille en octet si type "file", 0 si dossier
  • moddate : date de dernière modification de l'élément

 

<dir list="/files" name="retour" pattern="*.pdf">

<dir list="/files" name="retour" pattern="A???x.txt">

<dir create="path">

L'attribut create permet de créer un nouveau répertoire dans votre site. Pour cela, il faut préciser le chemin d'accès du nouveau dossier, terminé par le nom que vous voulez lui donner.

Si le chemin de "dir" commence par /, le dossier sera créé à partir de DOCUMENT_ROOT, sinon, il sera créé en relatif par rapport au dossier courant.

À partir de la version 4.0a21-13, tous les dossiers n'existant pas dans le chemin encore sont crées même s'il y a plusieurs niveaux (les versions précédentes ne pouvaient créer que le dernier niveau).

<dir create="/documents/images">

Télécharger

Téléchargez rapidement la dernière version du XPX: Version 3.8-rc16 - 05/02/2019

Le saviez vous ?

Le chemin du fichier à inclure est précisé dans l'attribut "file".

FAQ

Venez nous poser vos questions et voir les problèmes courants que vous pouvez rencontrer

Don

Aidez-nous à faire vivre ce site en faisant un don

Condition d'utilisation