(PHP 5 >= 5.2.0, PHP 7, PECL zip >= 1.1.0)
ZipArchive::addFile — Ajoute un fichier à l'archive ZIP depuis le chemin fourni
$filename
[, string $localname
= NULL
[, int $start
= 0
[, int $length
= 0
]]] )Ajoute un fichier à une archive ZIP depuis le chemin fourni.
Note: For maximum portability, it is recommended to always use forward slashes (/) as directory separator in ZIP filenames.
filename
Le chemin vers le fichier à ajouter
localname
Si fourni, ce sera le nom local dans l'archive ZIP qui écrasera
le contenu du paramètre filename
.
start
Ce paramètre n'est pas utilisé mais est nécessaire pour étendre la classe ZipArchive.
length
Ce paramètre n'est pas utilisé mais est nécessaire pour étendre la classe ZipArchive.
Cette fonction retourne TRUE
en cas de
succès ou FALSE
si une erreur survient.
Cet exemple ouvre l'archive ZIP test.zip et ajoute le fichier /path/to/index.txt, en tant que newname.txt.
Exemple #1 Ouverture et ajout
<?php
$zip = new ZipArchive;
if ($zip->open('test.zip') === TRUE) {
$zip->addFile('/chemin/vers/index.txt', 'newname.txt');
$zip->close();
echo 'ok';
} else {
echo 'échec';
}
?>
Note:
Lorsqu'un fichier est marqué comme étant à ajouter à l'archive, PHP va verrouiller ce fichier. Le verrou sera relaché uniquement lorsque l'objet ZipArchive sera fermé, soit via ZipArchive::close() soit via destruction de l'objet ZipArchive. Ceci peut vous empêcher de supprimer le fichier en cours d'ajout même après que le verrou soit relaché.