********************************************************
Classe de crйation d'archives ZIP
=================================
Cette classe permet de crйer des archives ZIP а la
volйe, avec des fichiers ou des contenus dynamiques.
Les extensions ZLIB sont facultatives, ce script est
donc compatible avec la plupart des hйbergeurs !
********************************************************
Notes importantes
=================
Pensez toujours aux CHMOD des fichiers sous Linux,
c'est souvent des bкtises dans ce genre !!
On peut utiliser cette librairie sans les extensions
ZLIB, mais pas de miracle, les archives ne peuvent pas
кtre comprйssйes, les fichiers sont seulement groupйs !
(ce qui est dйjа pas mal).
Pour crйer des archives lisibles sans ZLIB, il faut
choisir le mode de compression le plus faible (Stocker
sous WinRAR) quand on crйe l'archive.
Sous Linux, il faut choisir une compression 0
Une bonne idйe serait de regarder l'exemple pratique,
trиs simple (exemple.php) avec une archive bidon !
*********************************************************
Fonctions de la classe
======================
Voici les fonctions de cette classe et les arguments :
Zip->get_List( [Archive ZIP])
-----------------------------
Retourne un tableau de tableaux :
+ [filename] => Nom du fichier une fois extrait
+ [stored_filename] => Nom du fichier archivй
+ [size] => taille une fois extrait
+ [compressed_file] => Taille du fichier archivй
+ [crc] => CRC32 du fichier (HEX)
+ [mtime] => Date en temps UNIX
+ [comment] => Commentaire, si prйsent
+ [folder] => 0 pour un fichier, 1 pour un dossier
+ [index] => Index dans l'archive, utile pour extraire
+ [status] => ok si le fichier n'est pas corrompu
### EXEMPLE :
> <?
> // Affiche le contenu de l'archive dossier/archive.zip
> include("zip.lib.php");
> $zip = new Zip;
> print_r( $zip->get_List("dossier/archive.zip") );
> ?>
Zip->Add( [ARR{ ARR{ $(dossier/)(Nom)$, $Contenu$}, ... }] , [Compression] )
----------------------------------------------------------------------------
Attention, ca se complique !
Cette fonction a comme premier paramиtre une liste.
Chaque йlйment de cette liste est lui-mкme une liste qui contient
en premier йlйment le (Dossier/)Nom du fichier, et en second йlйment
le contenu de ce fichier.
Si le nom du fichier est juste un nom de dossier, et pas de contenu,
le dossier sera crйй dans l'archive, mais vide. Simple, non ?
Les sous dossiers dans les noms des fichiers sont crййs automatiquement.
Le second argument de cette fonction prйcise si les fichiers doivent
кtre comprйssйs.
Retourne un tableau d'йlйments avec pour index les noms des fichiers et
comme valeurs l'йtat de l'ajout (1/0)
Pour exploiter les fichiers archivйs, il faut utiliser get_file()
### EXEMPLE :
> <?
> // Crйe l'archive test.zip non comprйssйe avec <t.txt> et <dossier/>
> include("zip.lib.php");
> $zip = new Zip;
> $zip->Add(Array(Array("t.txt","Texte"),Array("dossier/")),0);
> fputs(fopen("test.zip","wb"), $zip->get_file() ); // voir get_file()
> ?>
Zip->get_file()
---------------
Tout simple : renvoie une chaоne contenant les fichiers et dossiers
comprйssйs avec Add() exploitable dans un fichier, ou pour l'envoyer
au client avec header("Content-Type:application/zip"); (...)
Consulter l'exemple prйcйdent.
Zip->extract( [Archive ZIP], [Dossier], { Index } )
---------------------------------------------------
Fonction importante pour extraire tout ou partie d'une
archive.
[Archive ZIP] est le (dossier/)nom de l'archive qu'il
faut extraire
[Dossier] est le dossier ou les fichiers sont extraits.
Attention, les permissions doivent кtre accessibles par PHP !!
{ Index } est une liste des index des fichiers qu'il faut
extraire. Les index sont indiquйs dans get_list().
Si un des index est -1, ou si l'argument {Index} est absent,
toute l'archive est extraite.
Les sous dossiers sont crййs automatiquement.
### EXEMPLE :
> <?
> // Extait les fichiers d'index 1 et 3 dans /fichiers
> // et l'archive entiиre dans /archive
> include("zip.lib.php");
> $zip = new Zip;
> $zip->Extract("test.zip","fichiers",{1,3});
> $zip->Extract("test.zip","archive",{-1});
> ?>
*********************************************************
Aide et support
===============
Vous ne comprenez pas une de ces fonctions ou
vous avez une question а poser ?
Rendez vous sur le forum de maxg.info :
http://forum.maxg.info
********************************************************
Crйй par bouchon, http://maxg.info