PHP Conference Nagoya 2025

    RarException::setUsingExceptions

    (PECL rar >= 2.0.0)

    RarException::setUsingExceptions — Ativa e desativa o tratamento de erros com exceções

    Descrição

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

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

    Parâmetros

    using_exceptions

    Deve ser true para ativar o lançamento de exceções, false para desativar (o padrão).

    Valor Retornado

    Nenhum valor é retornado.

    Exemplos

    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

    Veja Também

    Melhore Esta Página

    Aprenda Como Melhorar Esta Página • Envie uma Solicitação de Modificação • Reporte um Problema
    ＋adicione uma nota

    Notas Enviadas por Usuários (em inglês)

    Não há notas de usuários para esta página.
    To Top