RarArchive::getEntries

rar_list

(PECL rar >= 2.0.0)

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

Description

Style orienté objet (method):

public RarArchive::getEntries ( void ) : array

Style procédural :

rar_list ( RarArchive $rarfile ) : array

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 RarArchive foreach et un accès style tableau avec des indexes 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

Version Description
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();
?>

L'exemple ci-dessus va afficher quelque chose de 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