RarArchive
PHP Manual

RarArchive::open

rar_open

(PECL rar >= 2.0.0)

RarArchive::open -- rar_openOuvre une archive RAR

Description

Style orienté objet (méthode) :

public static RarArchive RarArchive::open ( string $filename [, string $password ] )

Style procédural :

RarArchive rar_open ( string $filename [, string $password ] )

Ouvre une archive RAR et retourne une instance RarArchive la représentant.

Note: Si on tente d'ouvrir une archive multi-volume, le chemin du premier volume doit être passé comme premier paramètre. Sinon, l'ensemble des fichiers ne sera pas affiché.

Liste de paramètres

filename

Path to the Rar archive.

password

Un mot de passe en text plein, si nécessaire pour décrypter l'en-tête. Il sera également utilisé par défaut si des fichiers cryptés sont trouvés. Noter que les fichiers peuvent avoir un mot de passe différent, et ce, en respectant les en-têtes.

Avertissement

Avant la version 2.0.0, cette fonction ne gérait pas correctement les chemins relatifs. Utilisez la fonction realpath() pour corriger ce bogue.

Valeurs de retour

Retourne l'instance RarArchive requise ou FALSE si une erreur survient.

Exemples

Exemple #1 Style orienté objet

<?php
$rar_arch 
RarArchive::open('encrypted_headers.rar''samplepassword');
if (
$rar_arch === FALSE)
    die(
"Échec lors de l'ouverture du fichier");
    
$entries $rar_arch->getEntries();
if (
$entries === FALSE)
    die(
"Échec lors de la récupération des entrées");

echo 
count($entries) . " fichier(s) trouvé(s).\n";

if (empty(
$entries))
    die(
"Aucune entrée valide n'a été trouvée.");
    
$stream reset($entries)->getStream();
if (
$stream === FALSE)
    die(
"Échec lors de l'ouverture du premier fichier");

$rar_arch->close();

echo 
"Contenu du premier fichier :\n";
echo 
stream_get_contents($stream);

fclose($stream);
?>

L'exemple ci-dessus va afficher quelque chose de similaire à :

2 fichier(s) trouvé(s).
Contenu du premier fichier :
Encrypted file 1 contents.

Exemple #2 Style procédural

<?php
$rar_arch 
rar_open('encrypted_headers.rar''samplepassword');
if (
$rar_arch === FALSE)
    die(
"Échec lors de l'ouverture du fichier");
    
$entries rar_list($rar_arch);
if (
$entries === FALSE)
    die(
"Échec lors de la récupération des entrées");

echo 
count($entries) . " fichier(s) trouvé(s).\n";

if (empty(
$entries))
    die(
"Aucune entrée valide n'a été trouvée.");
    
$stream reset($entries)->getStream();
if (
$stream === FALSE)
    die(
"Échec lors de l'ouverture du premier fichier");

rar_close($rar_arch);

echo 
"Contenu du premier fichier :\n";
echo 
stream_get_contents($stream);

fclose($stream);
?>


RarArchive
PHP Manual