ZipArchive::locateName()
在 zip 存档中查找指定文件的索引
函数名：ZipArchive::locateName()
适用版本：PHP 5 >= 5.2.0, PHP 7
用法：ZipArchive::locateName() 方法用于在 zip 存档中查找指定文件的索引。它返回一个整数值，表示文件在存档中的索引位置。如果未找到该文件，则返回 false。
语法：int|false ZipArchive::locateName ( string $filename [, int $flags = 0 ] )
参数：
$filename：要查找的文件名，可以是文件的相对路径或绝对路径。
$flags（可选）：用于指定搜索的方式。可以是以下常量之一：
ZipArchive::FL_NOCASE：不区分大小写的搜索。
ZipArchive::FL_NODIR：仅搜索文件，不搜索文件夹。
返回值：
成功时返回文件在存档中的索引位置（从0开始的整数值）。
如果未找到文件，则返回 false。
示例：
$zip = new ZipArchive;
$zip->open('archive.zip');
$fileIndex = $zip->locateName('path/to/file.txt');
if ($fileIndex !== false) {
echo "文件 'path/to/file.txt' 在存档中的索引位置为：$fileIndex";
} else {
echo "未找到文件 'path/to/file.txt' 在存档中";
}
$zip->close();
在上面的示例中，我们首先创建了一个 ZipArchive 实例，并打开了一个名为 'archive.zip' 的 zip 存档。然后，我们使用 locateName() 方法来查找存档中的文件 'path/to/file.txt'。如果找到该文件，我们输出其索引位置；否则，输出未找到的提示信息。最后，我们关闭了 zip 存档。
请注意，此函数返回的索引位置是基于 0 的，即第一个文件的索引位置为 0，第二个文件为 1，以此类推。如果存档中有多个同名文件，该函数仅返回找到的第一个文件的索引位置。