`$zip.append`¶

Description¶

Ajoute un ou plusieurs fichiers à une archive zip existante.

Note d'implémentation

L'implémentation de cette méthode dans Ewt charge l'archive en tant que file system et lui ajoute le ou les fichiers indiqués. Cela
évite d'avoir à recréer une archive complète à chaque ajout d'élément.

Syntaxe¶

$zip.create( zip , files [ , options ] )

Paramètres¶

zip file / string

Fichier zip à créer ou compléter

files file / string / array

Fichier(s) à ajouter dans l'archive. Le ou les fichiers peuvent être un path donné sous forme de string, une référence de file, un tableau de file ou de string représentant des paths.

Il est possible de référencer un dossier, auquel cas tout le contenu du dossier est repris dans l'archive.

options map

Map d'options. Les options reconnues sont:

basePath file / string

Dossier de référence. Les paths de fichiers et de dossiers au sein de l'archive zip seront construits relativement au basePath si celui-ci est spécifié.

En l'absence de basePath, les fichiers sont systématiquement ajoutés à la racine du zip. La construction du zip générera une erreur si dans ce cas on cherche à ajouter deux fichiers de même nom.

L'option attend un path de dossier. Toutefois il est autorisé de passer un path de fichier, auquel cas la méthode s'appuiera sur le dossier parent du fichier en question.

replace boolean

Flag true/false indiquant si la méthode peut écraser un fichier déjà existant. Vaut false par défaut. Cela signifie que par défaut la méthode cherchera à créer un fichier ou un répertoire qui n'existe pas déjà.

Remarque: pour ajouter des fichiers à une archive pré-existante, veuillez utiliser la méthode $zip.append.

Retour¶

Retourne le fichier zip généré sous forme de file ou null en cas d'erreur.

Exemple¶

$zip.append(zip,
  [ "C:/Temp/pdfs",                 // ajout de dossier contenant plusieurs fichiers
    "C:/Temp/searchResult.xml" ],   // ajout de fichier unique
  { basePath: "C:/Temp" });

$zip.append¶