Расширение Zip для PHP: создание, извлечение и управление архивами

Расширенные примеры работы с ZipArchive

1. Создание архива с разными уровнями сжатия

$zip = new ZipArchive();
$zip->open('compress.zip', ZipArchive::CREATE);
$zip->setCompressionName('image.png', ZipArchive::CM_STORE);   // без сжатия
$zip->setCompressionName('text.txt', ZipArchive::CM_DEFLATE, 9); // максимальное сжатие
$zip->addFile('image.png');
$zip->addFile('text.txt');
$zip->close();

Файл image.png будет сохранён без сжатия (быстро, но архив больше),
text.txt - с deflate уровнем 9 (медленнее, но компактнее).

2. Извлечение только определённых файлов по маске

$zip = new ZipArchive();
$zip->open('backup.zip');
$files = [];
for ($i = 0; $i < $zip->numFiles; $i++) {
    $name = $zip->getNameIndex($i);
    if (strpos($name, 'logs/') === 0) {
        $files[] = $name;
    }
}
$zip->extractTo('./extr/', $files);
$zip->close();

Будут извлечены только файлы из папки logs/ (например, logs/error.log, logs/access.log).

3. Удаление файла из существующего архива

$zip = new ZipArchive();
if ($zip->open('archive.zip') === true) {
    $zip->deleteName('old.txt');
    $zip->close();
    echo 'Файл удалён';
} else {
    echo 'Не удалось открыть архив';
}

Метод deleteName() удаляет запись по имени. Если файл не найден, возвращает false, но ошибка не генерируется. После удаления архив необходимо пересобрать - изменения применяются при close().

4. Работа с комментариями архива и файлов

$zip = new ZipArchive();
$zip->open('comm.zip', ZipArchive::CREATE);
$zip->setArchiveComment('Архив проекта v2.1');
$zip->addFromString('readme.txt', 'Содержимое');
$zip->setCommentName('readme.txt', 'Этот файл описывает проект');
$zip->close();

// Чтение комментариев
$zip->open('comm.zip');
echo 'Архив: ' . $zip->getArchiveComment() . "
";
echo 'Файл: ' . $zip->getCommentName('readme.txt');
$zip->close();

Архив: Архив проекта v2.1
Файл: Этот файл описывает проект

5. Создание архива в памяти и потоковая отправка

ob_start();
$zip = new ZipArchive();
$tmp = tempnam(sys_get_temp_dir(), 'zip');
$zip->open($tmp, ZipArchive::CREATE | ZipArchive::OVERWRITE);
$zip->addFromString('data.json', '{"key":"value"}');
$zip->addFromString('readme.txt', 'Streaming example');
$zip->close();

header('Content-Type: application/zip');
header('Content-Disposition: attachment; filename="download.zip"');
header('Content-Length: ' . filesize($tmp));
readfile($tmp);
unlink($tmp);
ob_end_flush();

Браузер получит zip-файл для скачивания без сохранения на сервере (временный файл удаляется после отправки).

6. Рекурсивное добавление с исключением определённых расширений

function addDirFiltered($zip, $dir, $localPath, $exclude = ['.git', '.log']) {
    $dirIterator = new RecursiveDirectoryIterator($dir, RecursiveDirectoryIterator::SKIP_DOTS);
    $iterator = new RecursiveIteratorIterator($dirIterator, RecursiveIteratorIterator::SELF_FIRST);
    foreach ($iterator as $file) {
        $ext = $file->getExtension();
        if (in_array($ext, $exclude)) continue;
        $localName = $localPath . $iterator->getSubPathname();
        if ($file->isDir()) {
            $zip->addEmptyDir($localName);
        } else {
            $zip->addFile($file->getPathname(), $localName);
        }
    }
}
$zip = new ZipArchive();
$zip->open('project.zip', ZipArchive::CREATE);
addDirFiltered($zip, '/var/www/project', 'project/', ['.git', 'log', 'tmp']);
$zip->close();

Архив будет содержать все файлы и папки, кроме тех, чьё расширение или имя входит в массив $exclude. Обратите внимание: для директорий вызывается addEmptyDir(), чтобы сохранить структуру папок даже если они пусты.

7. Извлечение с переименованием файлов

$zip = new ZipArchive();
$zip->open('archive.zip');
for ($i = 0; $i < $zip->numFiles; $i++) {
    $name = $zip->getNameIndex($i);
    $newName = 'prefix_' . $name;
    // Извлекаем во временную строку и сохраняем под новым именем
    $content = $zip->getFromIndex($i);
    file_put_contents('./output/' . $newName, $content);
}
$zip->close();

Каждый файл из архива будет сохранён с префиксом 'prefix_' в указанной папке. Результат: файл 'doc.txt' станет 'prefix_doc.txt'.

8. Обработка ошибок с использованием исключений

$zip = new ZipArchive();
$result = $zip->open('missing.zip');
if ($result !== true) {
    throw new RuntimeException("Не удалось открыть архив. Код ошибки: $result");
}
try {
    $zip->addFile('nonexistent.txt');
    $zip->close();
} catch (Throwable $e) {
    echo 'Ошибка при добавлении: ' . $e->getMessage();
    $zip->close();
}

Коды ошибок open(): 1 (нет ошибки), 2 (файл не найден), 3 (повреждён), 4 (ошибка ввода/вывода), 5 (недостаточно памяти), 6 (иное).