RarException::setUsingExceptions
(PECL rar >= 2.0.0)
RarException::setUsingExceptions — Active ou désactive les exceptions dans le gestionnaire d'erreurs
Description
Si et seulement si l'argument vaut true, alors, au lieu d'émettre des alertes
et de retourner des valeurs spéciales indiquant une erreur lors que la
bibliothèque UnRAR rencontre une erreur, une exception de type
RarException est émise.
Les exceptions seront également lancées pour les erreurs suivantes, qui surviennent en dehors de la bibliothèque (leurs codes erreurs seront -1) :
- tentative d'une opération sur un objet RarArchive clos ou un objet RarEntry relatif au premier ;
- tentative de récupération d'une entrée qui n'existe pas avec la méthode RarArchive::getEntry().
Liste de paramètres
-
using_exceptions -
Doit valoir
truepour active l'émission d'exceptions,falsepour le désactiver (par défaut).
Valeurs de retour
Aucune valeur n'est retournée.
Exemples
Exemple #1 Exemple avec RarException::setUsingExceptions()
<?php
var_dump(RarException::isUsingExceptions());
$arch = RarArchive::open("does_not_exist.rar");
var_dump($arch);
RarException::setUsingExceptions(true);
var_dump(RarException::isUsingExceptions());
$arch = RarArchive::open("does_not_exist.rar");
var_dump($arch); //non atteint
?>Résultat de l'exemple ci-dessus est similaire à :
bool(false)
Warning: RarArchive::open(): Failed to open does_not_exist.rar: ERAR_EOPEN (file open error) in C:\php_rar\trunk\tests\test.php on line 3
bool(false)
bool(true)
Fatal error: Uncaught exception 'RarException' with message 'unRAR internal error: Failed to open does_not_exist.rar: ERAR_EOPEN (file open error)' in C:\php_rar\trunk\tests\test.php:8
Stack trace:
#0 C:\php_rar\trunk\tests\test.php(8): RarArchive::open('does_not_exist....')
#1 {main}
thrown in C:\php_rar\trunk\tests\test.php on line 8
Voir aussi
- RarException::isUsingExceptions() - Vérifie si le gestionnaire d'erreur utilise les exceptions ou non
add a note
