Archive_Tar::extractList()

Archive_Tar::extractList() – Extrait la liste des fichiers

Synopsis

require_once 'Archive/Tar.php';

boolean extractList ( array $filelist , string $path = '' , string $remove_path = '' )

Description

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 .

Parameter

  • 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.

Return value

boolean - Returns TRUE on success, FALSE on failure.

Throws

Possible PEAR_Error values
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.

Note

This function can not be called statically.

Example

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
?>
Extrait les fichiers (Previous) Extrait les fichiers dans un nouveau dossier (Next)
Last updated: Sun, 29 Aug 2010 — Download Documentation
Do you think that something on this page is wrong? Please file a bug report or add a note.
View this page in:

User Notes:

There are no user contributed notes for this page.