# 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 (méthode):

public RarArchive::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 RarArchive `foreach` 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

Version | Description
--- | ---
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

- RarArchive::getEntry() - Récupère une entrée depuis une archive RAR
- Le gestionnaire `rar://`