RarArchive::open
RarArchive::__toString
RarArchive
PHP Manual

# RarArchive::setAllowBroken

(PECL rar >= 3.0.0)

RarArchive::setAllowBroken — Whether opening broken archives is allowed

### Description

Object oriented style (method):

public bool RarArchive::setAllowBroken ( bool `$allow_broken` )

Procedural style:

bool rar_allow_broken_set ( RarArchive `$rarfile` , bool `$allow_broken` )

This method defines whether broken archives can be read or all the operations that attempt to extract the archive entries will fail. Broken archives are archives for which no error is detected when the file is opened but an error occurs when reading the entries.

### Parameters

`rarfile`

  A RarArchive object, opened with rar_open().

`allow_broken`

  Whether to allow reading broken files (`TRUE`) or not (`FALSE`).

### Return Values

Returns `TRUE` or `FALSE` on failure. It will only fail if the file has already been closed.

### Examples

Example #1 Object oriented style

`<?php
function retnull() { return null; }
$file = dirname(__FILE__) . "/multi_broken.part1.rar";
/* Third argument omits "volume not found" message */
$a = RarArchive::open($file, null, 'retnull');
$a->setAllowBroken(true);
foreach ($a->getEntries() as $e) {
echo "$e\n";
}
var_dump(count($a));
?>`

The above example will output something similar to:

    RarEntry for file "file1.txt" (52b28202)
    int(1)

Example #2 Procedural style

`<?php
function retnull() { return null; }
$file = dirname(__FILE__) . "/multi_broken.part1.rar";
/* Third argument omits "volume not found" message */
$a = rar_open($file, null, 'retnull');
rar_allow_broken_set($a, true);
foreach (rar_list($a) as $e) {
echo "$e\n";
}
var_dump(count($a));
?>`

### See Also

- RarArchive::isBroken() - Test whether an archive is broken (incomplete)

RarArchive::open
RarArchive::__toString
RarArchive
PHP Manual