RarArchive::getEntries

    rar_list

    (PECL rar >= 2.0.0)

    RarArchive::getEntries -- rar_list — Récupère la liste complète depuis l'archive RAR

    Description

    Style orienté objet (method):

    publicRarArchive::getEntries(): array|false

    Style procédural :

    rar_list(RarArchive$rarfile): array|false

    Récupère la liste complète (fichiers et dossiers) depuis l'archive RAR.

    Note:

    Si l'archive contient des entrées portant le même nom, cette méthode, combinée avec l'itération RarArchiveforeach et un accès style tableau avec des index numériques, est la seule permettant d'accéder à toutes les entrées (i.e. RarArchive::getEntry() et le gestionnaire rar:// sont insuffisants).

    Liste de paramètres

    rarfile

    Un objet RarArchive, ouvert avec la fonction rar_open().

    Valeurs de retour

    Retourne un tableau d'objets RarEntry ou false si une erreur survient.

    Historique

    VersionDescription
    PECL rar 3.0.0 Support des archives RAR contenant des entrées portant le même nom.

    Exemples

    Exemple #1 Style orienté objet

    <?php
    $rar_arch     = RarArchive::open('solid.rar');
    if (    $rar_arch === FALSE)
    die(    "Impossible d'ouvrir l'archive RAR.");

    $rar_entries = $rar_arch->getEntries();
    if (    $rar_entries === FALSE)
    die(    "Impossible de récupérer les entrées.");

    echo     "Nombre d'entrées trouvées : " . count($rar_entries) . "\n";

    foreach (    $rar_entries as $e) {
    echo     $e;
    echo     "\n";
    }
    $rar_arch->close();
    ?>

    Résultat de l'exemple ci-dessus est similaire à :

    Nombre d'entrées trouvées : 2 RarEntry for file "tese.txt" (23b93a7a) RarEntry for file "unrardll.txt" (2ed64b6e)

    Exemple #2 Style procédural

    <?php
    $rar_arch     = rar_open('solid.rar');
    if (    $rar_arch === FALSE)
    die(    "Impossible d'ouvrir l'archive RAR.");

    $rar_entries = rar_list($rar_arch);
    if (    $rar_entries === FALSE)
    die(    "Impossible de récupérer les entrées.");

    echo     "Nombre d'entrées trouvées : " . count($rar_entries) . "\n";

    foreach (    $rar_entries as $e) {
    echo     $e;
    echo     "\n";
    }
    rar_close($rar_arch);
    ?>

    Voir aussi

    To Top