Index: phpdoc/fr/functions/zip.xml +++ phpdoc/fr/functions/zip.xml Zip (décompression) Zip Ce module utilise les fonctions de la librairie ZZIPlib, créée par Guido Draheim pour lire de manière transparente des archives compressées Zip, et les fichiers qu'elles contiennent. Notez que ZZIPlib ne fournit qu'une partie des fonctions utilisant l'algorithme de compression ZIP : elle ne permet que de lire les fichiers Zip. Un utilitaire Zip est nécessaire pour créer ces archives, vous ne pourrez pas le faire en PHP. Le support de Zip par PHP n'est pas activé par défaut. Vous devez utiliser l'option --with-zip lorsque vous compilez PHP pour l'activer. Ce module requiert par ailleurs la librairie ZZIPlib version >= 0.10.6. Le support de Zip pour les versions antérieures à PHP 4.0.7 est expérimental. Cette section décrit l'extension Zip telle qu'elle existe en PHP 4.0.7 et plus récent. Exemple d'utilisation Cet exemple ouvre un fichier ZIP, lit chaque fichier de l'archive, et affiche son contenu. Le script test2.php utilisé dans cet exemple est un des fichiers de test de la distribution source de ZZIPlib. Exemple d'utilisation de l'extension Zip <?php $zip = zip_open("/tmp/test2.zip"); if ($zip) { while ($zip_entry = zip_read($zip)) { echo "Name: " . zip_entry_name($zip_entry) . "\n"; echo "Actual Filesize: " . zip_entry_filesize($zip_entry) . "\n"; echo "Compressed Size: " . zip_entry_compressedsize($zip_entry) . "\n"; echo "Compression Method: " . zip_entry_compressionmethod($zip_entry) . "\n"; /// if (zip_entry_open($zip, $zip_entry, "r")) { echo "File Contents:\n"; $buf = zip_entry_read($zip_entry, zip_entry_filesize($zip_entry)); echo "$buf\n"; zip_entry_close($zip_entry); } echo "\n"; } zip_close($zip); } ?> zip_close Ferme une archive Zip Description void zip_close resource zip zip_close ferme l'archive zip zip. Le paramètre zip doit être une archive zip, créée par la fonction zip_open. Cette fonction ne retourne pas de valeur. Voir aussi zip_open et zip_read. zip_entry_close Ferme un élément d'archive Description void zip_close resource zip_entry zip_close ferme l'élément d'archive zip_entry. Le paramètre zip_entry doit être un élément d'archive valide, créé par la fonction zip_entry_open. Cette fonction ne retourne pas de valeur. Voir aussi zip_entry_open et zip_entry_read. zip_entry_compressedsize Lit la taille compressée d'un dossier Description int zip_entry_compressedsize resource zip_entry zip_entry_compressedsize retourne la taille compressée de l'élément d'archive zip_entry. Le paramètre zip_entry doit être un élément d'archive valide, créé par la fonction zip_entry_open. Voir aussi zip_open et zip_read. zip_entry_compressionmethod Retourne la méthode de compression d'un dossier Description string zip_entry_compressionmethod resource zip_entry zip_entry_compressionmethod la méthode de compression de l'élément d'archive spécifié zip_entry. Le paramètre zip_entry doit être un élément d'archive valide, créé par la fonction zip_entry_open. Voir aussi zip_open et zip_read. zip_entry_filesize Retourne la taille réelle d'un fichier dans un dossier Description int zip_entry_filesize resource zip_entry zip_entry_filesize retourne la taille réelle de l'élément d'archive zip_entry. Le paramètre zip_entry doit être un élément d'archive valide, créé par la fonction zip_entry_open. Voir aussi zip_open et zip_read. zip_entry_name Retourne le nom de l'élément d'archive Description string zip_entry_name resource zip_entry zip_entry_name retourne le nom de l'élément d'archive spécifié par zip_entry. Le paramètre zip_entry doit être un élément d'archive valide, créé par la fonction zip_entry_open. Voir aussi zip_open et zip_read. zip_entry_open Ouvre un nouveau dossier dans une archive Description bool zip_entry_open resource zip resource zip_entry string mode zip_entry_open ouvre un dossier dans une archive Zip, en lecture seule. Le parmaètre zip est une ressource valide, retournée par zip_open. Le paramètre zip_entry est une ressource de dossier, retournée par zip_read. Le paramètre optinnel mode peut être l'un des mode spécifié dans la documentation de fopen. Actuellement, mode est ignoré et est vaut simplement "rb". Cela est lié au fait que l'extention zip est en lecture seule. Reportez vous à la fonction fopen pour plus de détails sur le mode "rb". zip_entry_open retourne true en cas de succès, ou false en cas d'échec. Contrairement à fopen et d'autres fonctions du même acabi, la valeur retournée par zip_entry_open indique uniquement le résultat de l'opération, et n'est pas nécessaire pour lire ou fermer le dossier. Voir aussi zip_entry_read et zip_entry_close. zip_entry_read Lit dans un fichier d'archive Description string zip_entry_read resource zip_entry int length zip_entry_read jusqu'à length octets dans un fichier d'archive. Si length n'est pas spécifié, alors zip_entry_read essaiera de lire 1024 octets. Le paramètre zip_entry est un élément d'archive valide, retourné par zip_read. Le paramètre length exprime une taille non compressée. zip_entry_read retourne les données lues, ou bien false si la fin du fichier est atteinte. Voir aussi zip_entry_open, zip_entry_close et zip_entry_filesize. zip_open Ouvre une archive Zip Description resource zip_open string filename zip_open ouvre une nouvelle archive en lecture. Le paramètre filename est le chemine jusqu'au fichier à ouvrir. zip_open retourne une ressource à utiliser plus tard avec les fonctions zip_read et zip_close. zip_open retourne FALSE si filename n'existe pas. Voir aussi zip_read et zip_close. zip_read Lit le prochain élément d'archive Description resource zip_read resource zip zip_read lit le prochain élément d'archive zip, dans l'archive zip. Le paramètre zip doit être une archive zip, ouverte précédemment par la fonction zip_open. zip_read une ressource d'élément d'archive, qui peut être utilisée ultérieurement par les fonctions zip_open, zip_close, zip_entry_open et zip_entry_read. Voir aussi zip_open, zip_close, zip_entry_open et zip_entry_read.