RarArchive::getEntries

rar_list

(PECL rar >= 2.0.0)

RarArchive::getEntries -- rar_list — Get full list of entries from the RAR archive

Beschreibung

Objektorientierter Stil (method):

public RarArchive::getEntries(): array|false

Prozeduraler Stil:

rar_list(RarArchive $rarfile): array|false

Get entries list (files and directories) from the RAR archive.

Hinweis:
If the archive has entries with the same name, this method, together with RarArchive foreach iteration and array-like access with numeric indexes, are the only ones to access all the entries (i.e., RarArchive::getEntry() and the rar:// wrapper are insufficient).

Parameter-Liste

rarfile: A RarArchive object, opened with rar_open().

Rückgabewerte

rar_list() returns array of RarEntry objects Bei einem Fehler wird false zurückgegeben..

Changelog

Version	Beschreibung
PECL rar 3.0.0	Support for RAR archives with repeated entry names is no longer defective.

Beispiele

Beispiel #1 Objektorientierter Stil

<?php
$rar_arch = RarArchive::open('solid.rar');
if ($rar_arch === FALSE)
    die("Could not open RAR archive.");

$rar_entries = $rar_arch->getEntries();
if ($rar_entries === FALSE)
    die("Could not retrieve entries.");

echo "Found " . count($rar_entries) . " entries.\n";

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

Das oben gezeigte Beispiel erzeugt eine ähnliche Ausgabe wie:

Found 2 entries.
RarEntry for file "tese.txt" (23b93a7a)
RarEntry for file "unrardll.txt" (2ed64b6e)

Beispiel #2 Prozeduraler Stil

<?php
$rar_arch = rar_open('solid.rar');
if ($rar_arch === FALSE)
    die("Could not open RAR archive.");

$rar_entries = rar_list($rar_arch);
if ($rar_entries === FALSE)
    die("Could retrieve entries.");

echo "Found " . count($rar_entries) . " entries.\n";

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

Siehe auch

RarArchive::getEntry() - Get entry object from the RAR archive
rar:// wrapper

Improve This Page

Learn How To Improve This Page • Submit a Pull Request • Report a Bug

＋add a note

User Contributed Notes 2 notes

down

Anonymous ¶

10 years ago

at the examples line 7 should be:
    die("Could NOT retrieve entries.");

down

grap at hot dot ee ¶

11 years ago

Can be usefult for many, probably:

<?php

$path  = 'path/to/archive';



$archive = RarArchive::open($path);

$list       = $archive ->getEntries();

foreach ($list as $entity) {

    //print just title of file from archive(use getters to access other fields, etc)

    echo $value->getName();

}

?>

＋add a note