Archive_Tar::listContent()

Archive_Tar::listContent() – Liste les fichiers et les dossiers contenus dans une archive

Synopsis

require_once 'Archive/Tar.php';

array listContent ( )

Description

iste les fichiers et les dossiers contenus dans une archive.

Return value

array - chaque entrée du tableau représente un fichier ou un dossier. Le tableau n'est pas ordonné, l'index montrant la position du fichier ou du dossier dans l'archive.

Chaque entrée contient les informations suivantes :

  • $file['filename'] - Nom et chemin du fichier/dossier.

  • $file['mode'] - Permissions du fichier (résultat de la fonction PHP fileperms())

  • $file['uid'] - Identifiant de l'utilisation

  • $file['gid'] - Identifiant du groupe

  • $file['size'] - Taille du fichier

  • $file['mtime'] - Date de la dernière modification (résultat de la fonction PHP filemtime())

  • $file['typeflag'] - vide pour un fichier, "5" pour un dossier

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 n'est pas causé par un processus compétitif de la classe Archive_Tar.
NULL " Le mode permettant de lister le contenu n'est pas valide. " Erreur d'implémentation. Ne doit pas arriver. Si tel est le cas, veuillez faire un rapport de bogue.
NULL " Le dossier portant le nom 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 extré 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

Liste le contenu d'une archive

<?php
$tar_object 
= new Archive_Tar("tarname.tar");

if ((
$v_list  =  $tar_object->listContent()) != 0) {
    for (
$i=0$i<sizeof($v_list); $i++) {
          echo 
"Filename :'".$v_list[$i]['filename']."'<br>";
          echo 
" .size :'".$v_list[$i]['size']."'<br>";
          echo 
" .mtime :'".$v_list[$i]['mtime']."' (".
          
date("l dS of F Y h:i:s A"$v_list[$i]['mtime']).")<br>";
          echo 
" .mode :'".$v_list[$i]['mode']."'<br>";
          echo 
" .uid :'".$v_list[$i]['uid']."'<br>";
          echo 
" .gid :'".$v_list[$i]['gid']."'<br>";
          echo 
" .typeflag :'".$v_list[$i]['typeflag']."'<br>";
    }
}
?>
Extrait les fichiers dans un nouveau dossier (Previous) Extrait un fichier et le retourne sous la forme d'une chaîne (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.