ZIP архивы в PHP: от новичка до профи

Подробные расширенные примеры

Пример 1: Создание архива с рекурсивным обходом и проверкой ошибок

function addDirToZipRecursive($dir, $zip, $relativeDir = '') {
    $handle = opendir($dir);
    if (!$handle) {
        throw new RuntimeException("Не удалось открыть директорию: $dir");
    }
    while (($entry = readdir($handle)) !== false) {
        if ($entry == '.' || $entry == '..') continue;
        $fullPath = $dir . DIRECTORY_SEPARATOR . $entry;
        $archPath = $relativeDir ? $relativeDir . '/' . $entry : $entry;
        if (is_dir($fullPath)) {
            addDirToZipRecursive($fullPath, $zip, $archPath);
        } else {
            if (!$zip->addFile($fullPath, $archPath)) {
                throw new RuntimeException("Не удалось добавить файл: $fullPath");
            }
        }
    }
    closedir($handle);
}

try {
    $zip = new ZipArchive();
    $zipName = 'backup_' . date('Ymd_His') . '.zip';
    if ($zip->open($zipName, ZipArchive::CREATE) !== true) {
        throw new RuntimeException("Не удалось создать архив: $zipName");
    }
    addDirToZipRecursive('/path/to/source', $zip);
    $zip->close();
    echo "Архив создан: $zipName";
} catch (Exception $e) {
    echo 'Ошибка: ' . $e->getMessage();
}

Архив создан: backup_20250331_120000.zip

В этом примере используется рекурсивная функция с проверкой каждого шага. Ошибки выбрасываются как исключения для централизованной обработки.

Пример 2: Извлечение только файлов определённого расширения

$zip = new ZipArchive();
$zip->open('images.zip');
$extractDir = './images';
if (!is_dir($extractDir)) mkdir($extractDir, 0755, true);

for ($i = 0; $i < $zip->numFiles; $i++) {
    $name = $zip->getNameIndex($i);
    if (preg_match('/\.(jpg|jpeg|png|gif)$/i', $name)) {
        $zip->extractTo($extractDir, $name);
    }
}
$zip->close();
echo 'Извлечено ' . $i . ' изображений';

Извлечено 5 изображений

Важно: extractTo() со вторым параметром принимает как строку, так и массив имён файлов.

Пример 3: Использование progress callback для отслеживания процесса (PHP 8.0+)

$zip = new ZipArchive();
$zip->open('large.zip');
$totalSize = $zip->getArchiveSize(); // размер в байтах
$extractedSize = 0;

$zip->setExtractCallback(function ($code, $info) use (&$extractedSize, $totalSize) {
    if ($code === ZipArchive::ER_EXTRACT) {
        $extractedSize += $info['uncompressed_size'] ?? 0;
        $percent = $totalSize > 0 ? round($extractedSize / $totalSize * 100, 2) : 0;
        echo "\rИзвлечено $percent%";
    }
    return true;
});

$zip->extractTo('./destination');
$zip->close();

Callback функция вызывается для каждого извлечённого файла. $info содержит данные о файле.

Пример 4: Создание архива и отправка его браузеру без сохранения на диск

$zip = new ZipArchive();
$tmpFile = tempnam(sys_get_temp_dir(), 'zip');
if ($zip->open($tmpFile, ZipArchive::OVERWRITE) !== true) {
    throw new Exception('Не удалось создать временный архив');
}

$zip->addFromString('readme.txt', 'Hello, world!');
$zip->addFile('image.png', 'photos/image.png');
$zip->close();

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

Этот подход позволяет отдавать архив без сохранения его в публичной директории. Временный файл удаляется после отправки.

Пример 5: Проверка целостности архива и получение списка файлов с размерами

$zip = new ZipArchive();
if ($zip->open('test.zip') === true) {
    echo 'Архив открыт, количество файлов: ' . $zip->numFiles . "\n";
    for ($i = 0; $i < $zip->numFiles; $i++) {
        $stat = $zip->statIndex($i);
        printf("%s - %d байт (crc32: %s)\n", $stat['name'], $stat['size'], dechex($stat['crc']));
    }
    // Проверка целостности (по CRC)
    if ($zip->isValid()) {
        echo "Архив корректен (CRC совпадает)\n";
    } else {
        echo "Обнаружены ошибки CRC\n";
    }
    $zip->close();
}

Архив открыт, количество файлов: 2
file1.txt - 1024 байт (crc32: a1b2c3d4)
file2.txt - 2048 байт (crc32: e5f6a7b8)
Архив корректен (CRC совпадает)

Метод statIndex() возвращает метаданные, включая CRC32. isValid() проверяет контрольные суммы всех файлов (требует полного чтения архива).

Пример 6: Работа с комментариями архива и отдельных файлов

$zip = new ZipArchive();
$zip->open('comment.zip', ZipArchive::CREATE);
$zip->addFromString('a.txt', 'data');
// Комментарий к архиву
$zip->setArchiveComment('Архив создан 31.03.2025');
// Комментарий к конкретному файлу
$zip->setCommentName('a.txt', 'Этот файл содержит важные данные');
$zip->close();

// Чтение комментариев
$zip->open('comment.zip');
echo 'Комментарий архива: ' . $zip->getArchiveComment() . "\n";
echo 'Комментарий a.txt: ' . $zip->getCommentName('a.txt') . "\n";
$zip->close();

Комментарий архива: Архив создан 31.03.2025
Комментарий a.txt: Этот файл содержит важные данные

Комментарии полезны для метаданных, но не шифруются и могут быть утеряны при модификации архива сторонними программами.

Пример 7: Обработка ошибок при добавлении больших файлов с использованием потока

$zip = new ZipArchive();
$zip->open('large.zip', ZipArchive::CREATE);

// Добавление файла из потока (не загружая весь файл в память)
$stream = fopen('/path/to/bigfile.iso', 'rb');
if ($stream) {
    $zip->addFileFromStream($stream, 'bigfile.iso');
    fclose($stream);
} else {
    echo 'Не удалось открыть файл для чтения';
}

// Или добавить из строки с использованием временного файла
file_put_contents('tmp_iso', file_get_contents('http://example.com/file'), LOCK_EX);
$zip->addFile('tmp_iso', 'remote.iso');
$zip->close();
unlink('tmp_iso');

Метод addFileFromStream() доступен с PHP 8.0. Для старых версий приходится сначала загружать файл на диск.