Создание архива изображений в PHP с помощью ZipArchive
Архив изображений удобен, когда пользователю нужно скачать сразу несколько файлов. Вместо десятков отдельных запросов сайт формирует один ZIP-файл, который можно сохранить на компьютере, передать по электронной почте или использовать для резервного копирования медиаданных. Подробнее о Msi Afterburnerでゲーム中にcpu使用率をosdに表示してボトルネック診断.
В PHP для такой задачи предусмотрен класс ZipArchive. Он умеет создавать новый архив, добавлять в него файлы и каталоги, переименовывать элементы, проверять результат записи и удалять временный ZIP после отправки пользователю.
На практике важно учитывать не только сам вызов методов класса, но и проверку путей, права доступа, фильтрацию расширений, обработку ошибок и корректную выдачу заголовков HTTP. Иначе архив может оказаться пустым, повреждённым или превратиться в инструмент для чтения файлов за пределами нужной папки.
Ниже показан универсальный подход, который подходит для обычного PHP-сайта и может быть адаптирован для WordPress. Примеры рассчитаны на сервер, где доступно расширение zip.
Что нужно для работы ZipArchive
Класс ZipArchive входит в расширение PHP Zip. На большинстве хостингов оно уже включено, однако на локальном сервере или VPS его иногда требуется установить отдельно. Проверить наличие поддержки можно небольшим скриптом:
<?php
if (class_exists('ZipArchive')) {
echo 'ZipArchive доступен';
} else {
echo 'Расширение Zip не подключено';
}
В Linux-системах расширение обычно устанавливают через пакет, соответствующий версии PHP, например php8.2-zip, после чего перезапускают веб-сервер или PHP-FPM. На Windows необходимо активировать строку extension=zip в файле php.ini и перезапустить окружение.
Для создания архива PHP-процессу понадобятся права на запись в каталог, где будет размещён временный ZIP. Лучше использовать отдельную папку вне публичного доступа или временный каталог операционной системы.
Простейшее создание ZIP-архива
Базовый сценарий состоит из четырёх действий: создать объект, открыть файл архива, добавить изображения и закрыть ZIP. Метод addFile() принимает физический путь к файлу и необязательное имя, под которым объект появится внутри архива.
<?php
$archivePath = __DIR__ . '/files/images.zip';
$imageDir = __DIR__ . '/images';
$zip = new ZipArchive();
if ($zip->open($archivePath, ZipArchive::CREATE | ZipArchive::OVERWRITE) === true) {
$zip->addFile($imageDir . '/photo-01.jpg', 'photo-01.jpg');
$zip->addFile($imageDir . '/photo-02.png', 'photo-02.png');
$zip->addFile($imageDir . '/photo-03.webp', 'photo-03.webp');
$zip->close();
echo 'Архив создан';
} else {
echo 'Не удалось открыть архив для записи';
}
Флаг ZipArchive::CREATE разрешает создать ZIP, если его ещё нет. ZipArchive::OVERWRITE очищает старое содержимое при повторном формировании. Если требуется дополнять уже существующий архив, флаг перезаписи использовать не следует.
Второй аргумент addFile() позволяет отделить реальный путь на сервере от имени внутри ZIP. Это удобно, когда изображения лежат в сложной структуре каталогов, а пользователю нужен аккуратный список файлов без внутренних путей сайта.
Добавление изображений из каталога
Чаще всего имена файлов заранее неизвестны, поэтому изображения получают через glob() или DirectoryIterator. Важно заранее ограничить список допустимыми расширениями и не добавлять в архив служебные файлы вроде PHP-скриптов, конфигураций и резервных копий.
<?php
$sourceDir = __DIR__ . '/uploads/photos';
$archivePath = __DIR__ . '/downloads/photos.zip';
$allowedExtensions = ['jpg', 'jpeg', 'png', 'gif', 'webp'];
$zip = new ZipArchive();
if ($zip->open($archivePath, ZipArchive::CREATE | ZipArchive::OVERWRITE) !== true) {
exit('Ошибка создания архива');
}
$iterator = new DirectoryIterator($sourceDir);
foreach ($iterator as $fileInfo) {
if ($fileInfo->isDot() || !$fileInfo->isFile()) {
continue;
}
$extension = strtolower($fileInfo->getExtension());
if (!in_array($extension, $allowedExtensions, true)) {
continue;
}
$zip->addFile(
$fileInfo->getPathname(),
$fileInfo->getFilename()
);
}
$zip->close();
echo 'Изображения добавлены в архив';
DirectoryIterator удобнее простого перебора строк, поскольку сразу предоставляет сведения о типе объекта, имени и физическом пути. Проверка isFile() исключает каталоги, а getExtension() помогает отфильтровать содержимое по формату.
Если требуется сохранять вложенные папки, можно использовать рекурсивный итератор. Внутреннее имя элемента при этом формируют относительно исходного каталога, чтобы в ZIP не попали абсолютные пути вроде /var/www/example.com/....
Выдача архива пользователю
После формирования ZIP его можно отдать браузеру через readfile(). До отправки содержимого нужно установить заголовки, очистить буфер вывода и проверить, что файл действительно существует. Любой случайный текст или предупреждение PHP перед заголовками может повредить загрузку.
<?php
$archivePath = __DIR__ . '/downloads/photos.zip';
if (!is_file($archivePath)) {
http_response_code(404);
exit('Архив не найден');
}
if (ob_get_level()) {
ob_end_clean();
}
header('Content-Type: application/zip');
header('Content-Disposition: attachment; filename="photos.zip"');
header('Content-Length: ' . filesize($archivePath));
header('X-Content-Type-Options: nosniff');
readfile($archivePath);
exit;
Имя в Content-Disposition лучше задавать вручную, особенно если оно содержит пробелы или символы национальных алфавитов. Для сложных имён можно добавить параметр filename* с кодировкой UTF-8.
Если ZIP создаётся специально для одного запроса, после отправки его можно удалить:
if (is_file($archivePath)) {
unlink($archivePath);
}
Удаление выполняют после readfile(). Для больших архивов полезнее хранить временные файлы с уникальными именами и запускать периодическую очистку, поскольку принудительное удаление сразу после отправки может быть неудобным при ошибке соединения.
Безопасность путей и пользовательских файлов
Нельзя без проверки подставлять имя изображения из GET- или POST-параметра в addFile(). Значения вроде ../../config.php могут привести к чтению файлов за пределами каталога изображений. Для выбора объектов лучше использовать заранее подготовленный список идентификаторов или сопоставление короткого имени с разрешённым физическим путём.
Пример безопасной проверки выглядит так:
<?php
$baseDir = realpath(__DIR__ . '/uploads/photos');
$requested = realpath($baseDir . '/' . ($_GET['file'] ?? ''));
if (
$requested === false ||
strpos($requested, $baseDir . DIRECTORY_SEPARATOR) !== 0 ||
!is_file($requested)
) {
http_response_code(400);
exit('Недопустимый файл');
}
Одной проверки расширения недостаточно: файл с именем picture.jpg может содержать PHP-код. Загрузки следует проверять по MIME-типу, размеру и содержимому, а каталог пользовательских файлов настроить так, чтобы сервер не исполнял в нём скрипты.
В WordPress источником изображений часто служит медиатека. При создании ZIP нужно проверять права пользователя через current_user_can(), использовать nonce для формы и получать реальные пути средствами WordPress, например через get_attached_file(). Сценарии с подборкой изображений можно связать с визуальной галереей; полезный пример такой реализации описан в материале про галерею с лайтбоксом.
Ошибки, нагрузка и качество архива
Метод close() возвращает результат завершения записи, поэтому его желательно проверять. Также стоит учитывать свободное место на диске: временный ZIP может занимать столько же места, сколько исходные изображения, а иногда и больше из-за особенностей сжатия.
Фотографии JPEG и PNG уже обычно сжаты, поэтому ZIP уменьшает их размер незначительно. При большом количестве изображений основная польза архива заключается в объединении файлов и удобстве передачи. Если сервер испытывает нагрузку, можно отключить дополнительное сжатие для уже сжатых форматов, применяя setCompressionName() с методом CM_STORE.
Во время тестирования генерации архива полезно наблюдать за потреблением ресурсов PHP и веб-сервера. Для проверки поведения компьютера при параллельной нагрузке пригодится диагностика CPU в MSI Afterburner, хотя при серверной обработке нужно отдельно учитывать загрузку процессора, оперативной памяти и диска.
Для больших коллекций лучше не собирать весь список изображений в память. Итераторы обрабатывают файлы последовательно, а временный файл создаётся на диске. Если архив формируется несколько минут, желательно запускать задачу через очередь или планировщик, а пользователю показывать статус готовности.
Сравнение основных методов добавления
Выбор способа зависит от структуры каталога и требований к именам объектов внутри ZIP. Небольшой фиксированный набор проще добавить вручную, а для медиатеки с вложенными папками удобнее рекурсивный обход.
| Способ | Когда использовать | Особенность |
|---|---|---|
addFile() |
Известны конкретные изображения | Полный контроль над каждым файлом |
glob() |
Нужны файлы по простому шаблону | Удобен для одного каталога |
DirectoryIterator |
Требуется фильтрация и проверка объектов | Понятный последовательный обход |
RecursiveIteratorIterator |
Есть вложенные папки | Сохраняет сложную структуру каталогов |
addFromString() |
Данные уже находятся в памяти | Подходит для небольших динамических файлов |
Перед публикацией функциональности стоит протестировать пустой каталог, отсутствующий файл, повреждённое изображение, повторное создание ZIP и попытку передать недопустимый путь. Отдельно проверьте работу с кириллическими именами, пробелами и файлами большого размера.
Хорошая реализация архива изображений в PHP должна ясно разделять поиск файлов, проверку доступа, формирование ZIP и его скачивание. Такой подход облегчает поддержку кода и снижает риск случайно открыть пользователям внутренние файлы сайта.
Используйте ZipArchive для пакетной загрузки фотографий, резервного копирования медиаданных и подготовки коллекций к переносу. Сначала реализуйте простой вариант на тестовой папке, затем добавьте авторизацию, фильтрацию, журналирование ошибок и автоматическую очистку временных архивов.