PHPCon Poland 2024

ZipArchive::addGlob

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

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

Описание

public ZipArchive::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

add a note

User Contributed Notes 6 notes

up
6
johnsmith at na dot com
9 years ago
Neither 'remove_all_path' or 'remove_path' options seem to be workng
up
2
Francesc Pineda Segarra
7 years ago
For me the better way seems to be:

$options = array('add_path' => DIRECTORY_SEPARATOR, 'remove_all_path' => TRUE);

On Windows uses \, on others /
up
1
sunbinzzzzz at gmail dot com
7 years ago
Yes!! neither 'remove_all_path' or 'remove_path' be working,if you want the right result,you should like this, $option = array( 'add_path' => '/', 'remove_all_path' => 'your path' ); 'add_path' just give a '/', then you will (; 。
up
0
hkn06tr at gmail dot com
4 months ago
The following all works:
---------
Ex-1:
Nearly all files for 5 level recursively are zipped:
$zip->addGlob("*.*");
$zip->addGlob("*/*.*");
$zip->addGlob("*/*/*.*");
$zip->addGlob("*/*/*/*.*");
$zip->addGlob("*/*/*/*/*.*");
$zip->addGlob("*/*/*/*/*/*.*"); // 5th
---------
Ex-2:
$zip->addGlob("library/*.*");
all files under library
---------
Ex-3:
$zip->addGlob("*/*.[cpj]*");
Means all files starting with cpj
So they all included
css
php
js
---------
Ex-4:
$zip->addGlob("*/*.[cpj][sh]*");
Take guarantee:
css
php
js
---------
Ex-5 Bonus:
More complicated:
$zip->addGlob("[ab]*/c*/*.[cpjth][shxt]*");
All folder starting with a or b and then in subfolder must start with c but only those files:
css php txt js html
up
0
zckernel at gmail dot com
9 years ago
Doesn't work with the following options:
$options = array('remove_all_path' => TRUE);
$zipArchive->addGlob($path."/*", GLOB_BRACE, $options);

The full path to file is adding to the archive.

Works well if:
$options = array('add_path' => './','remove_all_path' => TRUE);
up
-1
sumariva at gmail dot com
9 years ago
As others suggested, to remove all paths, use the space as basepath.
Zip opened with builtin utility on a Windows XP and WinRAR.

$options = array('add_path' => ' ','remove_all_path' => TRUE);

Thanks for all contributers.
To Top