ZipArchive::addGlob
(PHP 5 >= 5.3.0, PHP 7, PECL zip >= 1.9.0)
ZipArchive::addGlob — Добавить файлы из директории в соответствии с шаблоном
Описание
$pattern
, int $flags = 0
, array $options = array()
) : 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. Поведение констант описано на странице 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.
|
Примеры
Пример #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