Создание и управление архивными файлами в PHP

Расширенные примеры работы с архивами в PHP

Пример 1: Рекурсивное архивирование директории в ZIP

Как упаковать целую папку со всеми вложенными файлами и каталогами?

function archiveDirectory($sourceDir, $zip, $basePath = '') {
    $files = new RecursiveIteratorIterator(
        new RecursiveDirectoryIterator($sourceDir, RecursiveDirectoryIterator::SKIP_DOTS),
        RecursiveIteratorIterator::LEAVES_ONLY
    );
    foreach ($files as $file) {
        $filePath = $file->getRealPath();
        $relativePath = $basePath . $file->getSubPathName();
        if ($file->isDir()) {
            $zip->addEmptyDir($relativePath);
        } else {
            $zip->addFile($filePath, $relativePath);
        }
    }
}

$zip = new ZipArchive();
if ($zip->open('archive.zip', ZipArchive::CREATE) === TRUE) {
    archiveDirectory('/path/to/folder', $zip);
    $zip->close();
    echo 'Архив создан';
} else {
    echo 'Ошибка';
}

Результат: файл archive.zip содержит иерархию исходной директории.

Пример 2: Создание ZIP архива в памяти (без записи на диск)

Как отправить архив пользователю непосредственно в ответе HTTP, не сохраняя временный файл?

$zip = new ZipArchive();
$tmpFile = tempnam(sys_get_temp_dir(), 'zip');
if ($zip->open($tmpFile, ZipArchive::CREATE) === TRUE) {
    $zip->addFromString('readme.txt', 'Этот архив создан в памяти');
    $zip->addFile('image.png', 'images/image.png');
    $zip->close();

    header('Content-Type: application/zip');
    header('Content-Disposition: attachment; filename="memory.zip"');
    header('Content-Length: ' . filesize($tmpFile));
    readfile($tmpFile);
    unlink($tmpFile);
    exit;
}

Результат: браузер предложит скачать файл memory.zip.

Пример 3: Установка пароля на ZIP архив (PHP 7.2+)

Как защитить архив паролем (шифрование AES-256)?

$zip = new ZipArchive();
if ($zip->open('protected.zip', ZipArchive::CREATE) === TRUE) {
    $zip->addFromString('secret.txt', 'Конфиденциальные данные');
    $zip->setPassword('my_strong_password');
    // Шифрование всех файлов
    for ($i = 0; $i < $zip->numFiles; $i++) {
        $zip->setEncryptionName($zip->getNameIndex($i), ZipArchive::EM_AES_256);
    }
    $zip->close();
    echo 'Архив защищён паролем';
}

Обратите внимание: для работы шифрования требуется PHP собранный с libzip >= 1.2.0.

Пример 4: Чтение и извлечение файлов из TAR с помощью PharData

Как программно получить содержимое TAR архива и извлечь определённые файлы?

$tar = new PharData('example.tar');
// Вывести список файлов
foreach ($tar as $file) {
    echo $file->getPathname() . "\n";
}
// Извлечь все файлы в директорию
$tar->extractTo('/destination');
// Извлечь только один файл
$tar->extractTo('/destination', 'path/inside/archive/myfile.txt');

Вывод списка: перечисляются все пути внутри архива.

Пример 5: Создание tar.gz с прогрессом (комбинация внешней утилиты)

Как отображать прогресс создания большого архива через командную строку?

$source = '/var/www/html';
$target = '/backup/site.tar.gz';
$command = "tar -czf " . escapeshellarg($target) . " -C " . escapeshellarg(dirname($source)) . " " . escapeshellarg(basename($source));
$descriptorspec = [
    0 => ["pipe", "r"],
    1 => ["pipe", "w"],
    2 => ["pipe", "w"]
];
$process = proc_open($command, $descriptorspec, $pipes);
if (is_resource($process)) {
    // Закрываем stdin
    fclose($pipes[0]);
    // Читаем stderr (tar выдаёт предупреждения туда)
    $errorOutput = stream_get_contents($pipes[2]);
    fclose($pipes[2]);
    // stdout может быть пустым
    $stdout = stream_get_contents($pipes[1]);
    fclose($pipes[1]);
    $return_value = proc_close($process);
    if ($return_value === 0) {
        echo "Архив создан успешно.\n";
    } else {
        echo "Ошибка: $errorOutput\n";
    }
}

Результат: в директории /backup появится файл site.tar.gz.

Пример 6: Фильтрация файлов при архивации (исключение временных файлов)

Как добавить в ZIP только определённые типы файлов, исключая, например, .log и .tmp?

$zip = new ZipArchive();
$zip->open('filtered.zip', ZipArchive::CREATE);
$files = new RecursiveIteratorIterator(
    new RecursiveDirectoryIterator('/var/log', RecursiveDirectoryIterator::SKIP_DOTS)
);
$allowedExtensions = ['log', 'txt']; // измените на нужные
foreach ($files as $file) {
    if ($file->isFile()) {
        $ext = strtolower($file->getExtension());
        if (in_array($ext, $allowedExtensions)) {
            $zip->addFile($file->getRealPath(), 'logs/' . $file->getFilename());
        }
    }
}
$zip->close();
echo 'Архив с отфильтрованными файлами создан';

Пример 7: Работа с архивами через потоковую библиотеку zipstream-php

Как организовать потоковую передачу очень большого ZIP без загрузки в память?

require 'vendor/autoload.php';
use ZipStream\ZipStream;
use ZipStream\Option\Archive;
use ZipStream\Option\File;

$opt = new Archive();
$opt->setSendHttpHeaders(true);
$zip = new ZipStream('large.zip', $opt);

// Добавление большого файла из потока
$fileOpt = new File();
$fileOpt->setMethod(File::METHOD_DEFLATE);
$zip->addFileFromStream('bigfile.dat', fopen('/tmp/bigfile.dat', 'rb'), $fileOpt);

// Добавление из строки
$zip->addFile('notes.txt', 'Some notes');

$zip->finish();

Результат: браузер получит поток с архивом без временных файлов на сервере.

Все перечисленные примеры предоставляют гибкие возможности для работы с архивами. Выбор конкретного подхода зависит от нагрузки, требований к безопасности и доступных расширений PHP.