RarException::setUsingExceptions
(PECL rar >= 2.0.0)
RarException::setUsingExceptions — Activar y desactivar el manejador de errores con excepciones
Descripción
Si y sólo si el argumento es true, entonces, en lugar de emitir advertencias y devolver un valor especial indicando error cuando la biblioteca UnRAR encuentre un error, una excepción de tipo RarException será lanzada.
Las excepciones también será lanzado para los siguientes errores, que se producen fuera de la biblioteca (su código de error será -1):
- intentar algunas operaciones en un objeto RarArchive cerrado o un objeto RarEntry relativo al primero;
- intentar obtener una entrada que no existe con RarArchive::getEntry().
Parámetros
-
using_exceptions -
Debe ser
truepara activar lanzamiento de excepciones,falsepara descativarlo (el valor por defecto).
Valores devueltos
No devuelve ningún valor.
Ejemplos
Ejemplo #1 Ejemplo de 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); //not reached
?>El resultado del ejemplo sería algo similar a:
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
Ver también
- RarException::isUsingExceptions() - Comprobar si el manejador de errores con excepciones está en uso
add a note
User Contributed Notes
There are no user contributed notes for this page.
