RarArchive::isBroken
PHP function
Edit on GitHub ✎
(PECL rar >= 3.0.0)
Test whether an archive is broken (incomplete)
Description
Oop (method):
RarArchive::isBroken(): bool
Procedural:
rar_broken_is(RarArchive $rarfile): bool
This function determines whether an archive is incomplete, i.e., if a volume is missing or a volume is truncated.
Parameters
rarfileA
RarArchiveobject, opened withrar_open().
Return Values
Returns true if the archive is broken, false otherwise. This function may also return false if the passed file has already been closed. The only way to tell the two cases apart is to enable exceptions with RarException::setUsingExceptions; however, this should be unnecessary as a program should not operate on closed files.
Examples
Oop
php
<?php
function retnull() { return null; }
$file = dirname(__FILE__) . "/multi_broken.part1.rar";
/* Third argument is used to omit notice */
$arch = RarArchive::open($file, null, 'retnull');
var_dump($arch->isBroken());
?>The above example will output something similar to:
output
bool(true)Procedural
php
<?php
function retnull() { return null; }
$file = dirname(__FILE__) . "/multi_broken.part1.rar";
/* Third argument is used to omit notice */
$arch = rar_open($file, null, 'retnull');
var_dump(rar_broken_is($arch));
?>See Also
RarArchive::setAllowBroken