array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'fr', ), 'this' => array ( 0 => 'rarexception.setusingexceptions.php', 1 => 'RarException::setUsingExceptions', 2 => 'Active ou désactive les exceptions dans le gestionnaire d\'erreurs', ), 'up' => array ( 0 => 'class.rarexception.php', 1 => 'RarException', ), 'prev' => array ( 0 => 'rarexception.isusingexceptions.php', 1 => 'RarException::isUsingExceptions', ), 'next' => array ( 0 => 'book.zip.php', 1 => 'Zip', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'fr', 'path' => 'reference/rar/rarexception/setusingexceptions.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

RarException::setUsingExceptions

(PECL rar >= 2.0.0)

RarException::setUsingExceptions — Active ou désactive les exceptions dans le gestionnaire d'erreurs

Description

public static RarException::setUsingExceptions(bool $using_exceptions): void

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 lorsque 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) :

Liste de paramètres

using_exceptions
Doit valoir true pour activer l'émission d'exceptions, false pour 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