PHP8 RarArchive::isBroken
PECL rar >= 3.0.0)
RarArchive::isBroken -- rar_broken_is — 测试存档是否损坏(不完整)
说明
面向对象风格 (method):
public RarArchive::isBroken(): bool
过程化风格:
rar_broken_is(RarArchive $rarfile): bool
此函数确定存档是否不完整,即是否缺少卷或卷是否被截断。
参数
rarfile
一个 RarArchive 对象,用 rar_open() 打开。
返回值
如果存档已损坏,则返回 true,否则返回 false。此功能还可以 如果传递的文件已关闭,则返回 false。唯一的办法 区分这两种情况是为了使 RarException::setUsingExceptions() 的异常;然而 这应该是不必要的,因为程序不应该对关闭的文件进行操作。
示例
示例 #1 面向对象风格
<?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());
?>
以上示例的输出类似于:
bool(true)
示例 #2 过程化风格
<?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));
?>
参见
- RarArchive::setAllowBroken() - 是否允许打开损坏的存档