(PECL rar >= 2.0.0)
RarException::setUsingExceptions — Ativa e desativa o tratamento de erros com exceções
Se e somente se o argumento for true
, então, em vez de emitir avisos e retornar um valor especial indicando erro quando a biblioteca UnRAR encontrar um erro, uma exceção do tipo RarException será lançada.
Exceções também serão lançadas para os seguintes erros, que ocorrem fora da biblioteca (seu código de erro será -1):
Nenhum valor é retornado.
Exemplo #1 Exemplo de RarException::setUsingExceptions()
<?php
var_dump(RarException::isUsingExceptions());
$arch = RarArchive::open("nao_existe.rar");
var_dump($arch);
RarException::setUsingExceptions(true);
var_dump(RarException::isUsingExceptions());
$arch = RarArchive::open("nao_existe.rar");
var_dump($arch); // não alcançado
?>
O exemplo acima produzirá algo semelhante a:
bool(false) Warning: RarArchive::open(): Failed to open nao_existe.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 nao_existe.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('nao_existe....') #1 {main} thrown in C:\php_rar\trunk\tests\test.php on line 8