©
This document uses PHP Chinese website manual Release
(PECL rar >= 2.0.0)
RarException::setUsingExceptions — Activate and deactivate error handling with exceptions
$using_exceptions
)
If and only if the argument is TRUE
, then, instead of emitting warnings and returning a special value indicating error when the UnRAR library encounters an error, an exception of type RarException will be thrown.
Exceptions will also be thrown for the following errors, which occur outside the library (their error code will be -1):
using_exceptions
Should be TRUE
to activate exception throwing, FALSE
to deactivate (the default).
Example #1 RarException::setUsingExceptions() example
<?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
?>
以上例程的输出类似于:
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