Возвращает индекс элемента в архиве

# ZipArchive::locateName

(PHP 5 >= 5.2.0, PHP 7, PHP 8, PECL zip >= 1.5.0)

ZipArchive::locateName — Возвращает индекс элемента в архиве

### Описание

public function ZipArchive::locateName(string `$name`, int `$flags` = 0): int|false

Находит элемент по имени.

### Список параметров

`name`
  Имя элемента для поиска.
`flags`

  Флаги — значение, которое определили следующими константами через побитовое ИЛИ, или 0 ни для одного из них.

  - `ZipArchive::FL_NOCASE`
  - `ZipArchive::FL_NODIR`

### Возвращаемые значения

Метод возвращает индекс элемента в случае успешного выполнения или `false`, если возникла ошибка.

### Примеры

Пример #1 Создать архив, а затем вызвать метод ZipArchive::locateName()

    <?php

    $file = 'testlocate.zip';

    $zip = new ZipArchive;
    if ($zip->open($file, ZipArchive::CREATE) !== TRUE) {
        exit('Ошибка');
    }

    $zip->addFromString('entry1.txt', 'entry #1');
    $zip->addFromString('entry2.txt', 'entry #2');
    $zip->addFromString('dir/entry2d.txt', 'entry #2');

    if ($zip->status !== ZipArchive::ER_OK) {
        echo "Ошибка записи в zip-файл\n";
    }
    $zip->close();

    if ($zip->open($file) !== TRUE) {
        exit('Ошибка');
    }

    echo $zip->locateName('entry1.txt') . "\n";
    echo $zip->locateName('eNtry2.txt') . "\n";
    echo $zip->locateName('eNtry2.txt', ZipArchive::FL_NOCASE) . "\n";
    echo $zip->locateName('enTRy2d.txt', ZipArchive::FL_NOCASE|ZipArchive::FL_NODIR) . "\n";
    $zip->close();

    ?>

Результат выполнения приведённого примера:

    0

    1
    2

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open