ZipArchive::addGlob

    (PHP 5 >= 5.3.0, PHP 7, PHP 8, PECL zip >= 1.9.0)

    ZipArchive::addGlob — Добавить файлы из директории в соответствии с шаблоном

    Описание

    publicZipArchive::addGlob(string$pattern, int$flags = 0, array$options = []): array|false

    Добавить файлы из директории в соответствии с шаблоном pattern.

    Замечание: Для максимальной переносимости, рекомендуется всегда пользоваться прямыми слешами / как разделителями директорий в именах файлов.

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

    pattern

    Шаблон функции glob(), по которому будут выбираться файлы.

    flags

    Битовая маска флагов glob().

    options

    Ассоциативный массив опций. Доступные значения:

    • "add_path"

      Префикс, который будет добавляться в начало локального пути в архиве. Накладывается после применения операций, заданных в "remove_path" или "remove_all_path".

    • "remove_path"

      Префикс, который будет удалён из пути перед добавлением к архиву.

    • "remove_all_path"

      Установите как true для использования только имени файлов и складывания их в корень архива.

    • "flags"

      Битовая маска, состоящая из ZipArchive::FL_OVERWRITE, ZipArchive::FL_ENC_GUESS, ZipArchive::FL_ENC_UTF_8, ZipArchive::FL_ENC_CP437, ZipArchive::FL_OPEN_FILE_NOW. Поведение констант описано на странице ZIP-константы.

    • "comp_method"

      Метод сжатия, одна из констант ZipArchive::CM_*, смотрите страницу константы ZIP.

    • "comp_flags"

      Уровень сжатия.

    • "enc_method"

      Метод шифрования, одна из констант ZipArchive::EM_*, смотрите страницу константы ZIP.

    • "enc_password"

      Пароль, используемый для шифрования.

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

    Массив (array) добавленных файлов в случае успешного выполнения или false, если возникла ошибка Возвращает true в случае успешного выполнения или false, если возникла ошибка.

    Список изменений

    ВерсияОписание
    8.0.0 / 1.18.0 Добавлен параметр "flags" в options.
    8.0.0 / 1.18.1 Добавлены параметры "comp_method", "comp_flags", "enc_method" и "enc_password" в options.
    8.3.0 / 1.22.1 Добавлена константа ZipArchive::FL_OPEN_FILE_NOW.

    Примеры

    Пример #1 Пример использования ZipArchive::addGlob()

    Добавить к архиву все текстовые файлы и файлы скриптов PHP из текущей директории

    <?php
    $zip     = new ZipArchive();
    $ret = $zip->open('application.zip', ZipArchive::CREATE | ZipArchive::OVERWRITE);
    if (    $ret !== TRUE) {
    printf('Ошибка с кодом %d', $ret);
    } else {
    $options = array('add_path' => 'sources/', 'remove_all_path' => TRUE);
    $zip->addGlob('*.{php,txt}', GLOB_BRACE, $options);
    $zip->close();
    }
    ?>

    Смотрите также

    • ZipArchive::addFile() - Добавляет в ZIP-архив файл по указанному пути
    • ZipArchive::addPattern() - Добавить файлы из директории в соответствии с шаблоном регулярного выражения PCRE
    To Top