ZipArchive::addFile
(PHP 5 >= 5.2.0, PECL zip >= 1.1.0)
ZipArchive::addFile — Ajoute un fichier à l'archive ZIP depuis le chemin fourni
Description
$filename
[, string $localname = NULL
[, int $start = 0
[, int $length = 0
]]] )Ajoute un fichier à une archive ZIP depuis le chemin fourni.
Liste de paramètres
-
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.
Valeurs de retour
Cette fonction retourne TRUE en cas de
succès ou FALSE si une erreur survient.
Exemples
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';
}
?>
Notes
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é.