boolean extractList (
array $filelist
, string
$path = ''
, string
$remove_path = ''
)
Cette méthode extrait uniquement les fichiers de l'archive qui sont indiqués dans le paramètre $filelist . Ces fichiers sont extraits dans le dossier courant ou dans le dossier indiqué par le paramètre optionnel $path .
string $filelist - un tableau de noms de fichiers et de noms de dossiers, ou une chaîne simple avec les noms séparés par un seul espace.
string $path - le chemin vers le dossier où les fichiers et/ou les dossiers doivent être extraits.
string $remove_path - partie du chemin qui peut être enlevée s'il est présent au début des chemins des fichiers ou des dossiers.
boolean - Returns TRUE on success, FALSE on failure.
| Code erreur | Message d'erreur | Raison | Solution |
|---|---|---|---|
| NULL | " Impossible d'ouvrir l'archive en mode lecture. " | Le fichier est verrouillé de façon exclusive par une autre application. | Vérifie si d'autres applications travaillent sur le fichier. Ce peut être à cause d'un processus compétitif de la classe Archive_Tar. |
| NULL | " Impossible d'ouvrir l'archive en mode écriture. " | Le fichier est verrouilé par une autre application. | Vérifie si d'autres applications travaillent sur le fichier. Ce peut être à cause d'un processus compétitif de la classe Archive_Tar. |
| NULL | " Le mode d'extraction mode est invalide. " | Erreur d'implémentation | Ne doit pas arriver. Si tel est le cas, veuillez faire un rapport de bogue. |
| NULL | " Le dossier name existe déjà en tant que fichier " | Un fichier est marqué comme étant un dossier dans l'archive. | Peut être une archive corrompue. |
| NULL | " Le fichier portant le nom name existe déjà en tant que dossier. " | Un dossier est marqué comme étant un fichier dans l'archive. | Peut être une archive corrompue. |
| NULL | " Le fichier portant le nom name existe déjà et est protégé en écriture. " | L'archive contient un fichier qui existe déjà dans le dossier de destination et ne peut pas être écrasé. | Extraire l'archive dans un dossier vide. |
| NULL | " Impossible de créer le chemin pour name . " | Un ou plusieurs dossiers qui doivent être créés ne le peuvent pas dans le dossier de destination. | Assurez-vous que le dossier de destination et tous les dossiers à créer ont les permissions suffisantes. |
| NULL | " Impossible de créer le dossier name . " | Un dossier ne peut pas être créé dans le dossier de destination. | Assurez-vous que le dossier de destination a les permissions suffisantes. |
| NULL | " Erreur lors de l'ouverture de name en mode écriture binaire. " | Le fichier ne peut pas être créé. | Le fichier est peut être verrouillé. |
| NULL | " Le fichier filename extrait n'a pas la taille valide filesize (size attendue). L'archive est peut être corrompue. " | Lisez le message. | Lisez le message. |
This function can not be called statically.
Extraction d'une archive compressée
<?php
// tarname.tar avec les fichiers :
// dev/data/file.txt
// dev/data/log.txt
// readme.txt
$tar_object = new Archive_Tar("tarname.tar");
$tar_object->extractList("dev/data/file.txt readme.txt", "install",
"dev");
// Les fichiers seront extraits ici :
// install/data/file.txt
// install/readme.txt
?>