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 extraction
<?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 essayer de verrouiller ce fichier et il ne sera relaché que lorsque l'opération ZIP sera terminée. En gros, vous ne pouvez supprimer un fichier ajouté à l'archive que lorsque l'archive est fermée.