[函数]ZipArchive::getExternalAttributesName()函数—用法及示例

函数名称：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 参数，函数将只返回外部属性名称的字符串。