函数名称:ZipArchive::getExternalAttributesName()
适用版本:PHP 5 >= 5.6.0, PHP 7, PHP 8
函数描述:获取指定文件的外部属性名称。
用法:
public ZipArchive::getExternalAttributesName ( int $index [, int &$opsys [, int &$attr ]] ) : string|false
参数:
$index
:要获取外部属性的文件索引。$opsys
(可选):一个引用变量,用于存储操作系统标识符。$attr
(可选):一个引用变量,用于存储文件的外部属性。
返回值:
- 成功时返回外部属性名称的字符串。
- 失败时返回 false。
示例:
$zip = new ZipArchive;
$zip->open('example.zip');
// 获取第一个文件的外部属性名称
$index = 0;
$opsys = null;
$attr = null;
$externalAttrName = $zip->getExternalAttributesName($index, $opsys, $attr);
if ($externalAttrName !== false) {
echo "第一个文件的外部属性名称是:$externalAttrName\n";
} else {
echo "获取外部属性名称失败\n";
}
$zip->close();
注意事项:
- 该函数仅适用于已打开的 ZipArchive 对象。
- 外部属性名称是指文件在 ZIP 存档中的属性名称,如操作系统标识符、文件权限等。
- 如果未指定
$opsys
和$attr
参数,函数将只返回外部属性名称的字符串。