PHP: полный мануал с примерами, функциями и ООП

<?php
declare(strict_types=1);

$path = __DIR__ . '/lesson.zip';
$zip = new ZipArchive();
if ($zip->open($path, ZipArchive::CREATE | ZipArchive::EXCL) !== true) {
    throw new RuntimeException('Не удалось создать учебный архив');
}
$zip->addFromString('order.txt', 'paid:42');
echo "Подготовлен чек\n";
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
if (is_file($path)) unlink($path);

Подготовлен чек

new создаёт объект управления, -> вызывает его метод; :: обращается к именованному флагу класса. Проверка !== true нужна из-за целочисленных ошибок.

<?php
declare(strict_types=1);

$zip = new ZipArchive();
$result = $zip->open(__DIR__ . '/missing.zip', ZipArchive::RDONLY);
echo $result === ZipArchive::ER_NOENT ? "Нет поставки\n" : "Другой результат\n";

Нет поставки

Проверяется конкретный код; отсутствующий ZIP не создаётся.

<?php
declare(strict_types=1);

$path = __DIR__ . '/lesson.zip';
$zip = new ZipArchive();
if ($zip->open($path, ZipArchive::CREATE | ZipArchive::EXCL) !== true) {
    throw new RuntimeException('Не удалось создать учебный архив');
}
if (!$zip->addFromString('order.txt', 'paid:42')) {
    throw new RuntimeException('Запись не добавлена');
}
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
if ($zip->open($path) !== true) {
    throw new RuntimeException('Архив не прочитан');
}
echo $zip->getFromName("order.txt"), "\n";
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
if (is_file($path)) unlink($path);

paid:42

В подготовке close() уже проверен, затем открыт сохранённый файл. После второго close() удаляется только учебный ZIP.

<?php
declare(strict_types=1);

$path = __DIR__ . '/lesson.zip';
$zip = new ZipArchive();
if ($zip->open($path, ZipArchive::CREATE | ZipArchive::EXCL) !== true) {
    throw new RuntimeException('Не удалось создать учебный архив');
}
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
echo file_exists($path) ? "есть\n" : "нет записей — нет файла\n";

нет записей — нет файла

Не добавили ни одной записи: обычная политика libzip удаляет пустой архив. Для намеренно пустого ZIP нужен AFL_CREATE_OR_KEEP_FILE_FOR_EMPTY_ARCHIVE.

<?php
declare(strict_types=1);

$path = __DIR__ . '/lesson.zip';
$zip = new ZipArchive();
if ($zip->open($path, ZipArchive::CREATE | ZipArchive::EXCL) !== true) {
    throw new RuntimeException('Не удалось создать учебный архив');
}
$zip->addEmptyDir("acts");
echo $zip->getNameIndex(0), "\n";
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
if (is_file($path)) unlink($path);

acts/

Внешняя папка acts не создаётся: меняется только структура архива.

<?php
declare(strict_types=1);

$path = __DIR__ . '/lesson.zip';
$zip = new ZipArchive();
if ($zip->open($path, ZipArchive::CREATE | ZipArchive::EXCL) !== true) {
    throw new RuntimeException('Не удалось создать учебный архив');
}
$zip->addEmptyDir("Акты", ZipArchive::FL_ENC_UTF_8);
echo $zip->getNameIndex(0), "\n";
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
if (is_file($path)) unlink($path);

Акты/

Явно указан UTF-8 для имени; содержимого у пустой папки нет.

<?php
declare(strict_types=1);

$path = __DIR__ . '/lesson.zip';
$zip = new ZipArchive();
if ($zip->open($path, ZipArchive::CREATE | ZipArchive::EXCL) !== true) {
    throw new RuntimeException('Не удалось создать учебный архив');
}
$zip->addFromString('order.txt', 'paid:42');
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
if ($zip->open($path) !== true) {
    throw new RuntimeException('Архив не прочитан');
}
echo $zip->getFromName("order.txt"), "\n";
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
if (is_file($path)) unlink($path);

paid:42

Перед чтением повторно открываем сохранённую версию.

<?php
declare(strict_types=1);

$path = __DIR__ . '/lesson.zip';
$zip = new ZipArchive();
if ($zip->open($path, ZipArchive::CREATE | ZipArchive::EXCL) !== true) {
    throw new RuntimeException('Не удалось создать учебный архив');
}
if (!$zip->addFromString('order.txt', 'paid:42')) {
    throw new RuntimeException('Запись не добавлена');
}
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
if ($zip->open($path) !== true) {
    throw new RuntimeException('Архив не прочитан');
}
$zip->addFromString("order.txt", "cancelled:42");
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
if ($zip->open($path) !== true) {
    throw new RuntimeException('Архив не прочитан');
}
echo $zip->getFromName("order.txt"), "\n";
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
if (is_file($path)) unlink($path);

cancelled:42

Значение flags по умолчанию допускает замену. Для запрета дубликата передайте 0 и проверьте false.

<?php
declare(strict_types=1);

$path = __DIR__ . '/lesson.zip';
$zip = new ZipArchive();
if ($zip->open($path, ZipArchive::CREATE | ZipArchive::EXCL) !== true) {
    throw new RuntimeException('Не удалось создать учебный архив');
}
$zip->addFile(__DIR__ . "/source.csv", "price.csv");
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
if ($zip->open($path) !== true) {
    throw new RuntimeException('Архив не прочитан');
}
echo $zip->getFromName("price.csv"), "\n";
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
if (is_file($path)) unlink($path);

SKU;42

Файл-источник и имя записи — разные вещи. Входной source.csv дан рядом с примером.

<?php
declare(strict_types=1);

$path = __DIR__ . '/lesson.zip';
$zip = new ZipArchive();
if ($zip->open($path, ZipArchive::CREATE | ZipArchive::EXCL) !== true) {
    throw new RuntimeException('Не удалось создать учебный архив');
}
$zip->addFile(__DIR__ . "/slice.txt", "number.txt", 7, 2);
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
if ($zip->open($path) !== true) {
    throw new RuntimeException('Архив не прочитан');
}
echo $zip->getFromIndex(0), "\n";
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
if (is_file($path)) unlink($path);

42

Первые 7 ASCII-байтов prefix: пропускаются; длина 2 оставляет 42. Для UTF-8 байтовый разрез может повредить символ.

<?php
declare(strict_types=1);

$path = __DIR__ . '/lesson.zip';
$zip = new ZipArchive();
if ($zip->open($path, ZipArchive::CREATE | ZipArchive::EXCL) !== true) {
    throw new RuntimeException('Не удалось создать учебный архив');
}
if (!$zip->addFromString('order.txt', 'paid:42')) {
    throw new RuntimeException('Запись не добавлена');
}
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
if ($zip->open($path) !== true) {
    throw new RuntimeException('Архив не прочитан');
}
$zip->replaceFile(__DIR__ . "/source.csv", 0);
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
if ($zip->open($path) !== true) {
    throw new RuntimeException('Архив не прочитан');
}
echo $zip->getFromName("order.txt"), "\n";
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
if (is_file($path)) unlink($path);

SKU;42

Файл-источник и имя записи — разные вещи. Входной source.csv дан рядом с примером.

<?php
declare(strict_types=1);

$path = __DIR__ . '/lesson.zip';
$zip = new ZipArchive();
if ($zip->open($path, ZipArchive::CREATE | ZipArchive::EXCL) !== true) {
    throw new RuntimeException('Не удалось создать учебный архив');
}
if (!$zip->addFromString('order.txt', 'paid:42')) {
    throw new RuntimeException('Запись не добавлена');
}
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
if ($zip->open($path) !== true) {
    throw new RuntimeException('Архив не прочитан');
}
$zip->replaceFile(__DIR__ . "/slice.txt", 0, 7, 2);
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
if ($zip->open($path) !== true) {
    throw new RuntimeException('Архив не прочитан');
}
echo $zip->getFromIndex(0), "\n";
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
if (is_file($path)) unlink($path);

42

Первые 7 ASCII-байтов prefix: пропускаются; длина 2 оставляет 42. Для UTF-8 байтовый разрез может повредить символ.

<?php
declare(strict_types=1);

$path = __DIR__ . '/lesson.zip';
$zip = new ZipArchive();
if ($zip->open($path, ZipArchive::CREATE | ZipArchive::EXCL) !== true) {
    throw new RuntimeException('Не удалось создать учебный архив');
}
chdir(__DIR__);
$added = $zip->addGlob("input/*.csv", 0, ["remove_path" => "input/", "add_path" => "prices/"]);
if ($added === false) throw new RuntimeException("Пакет не собран");
echo count($added), ":", $zip->getNameIndex(0), "\n";
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
if (is_file($path)) unlink($path);

1:prices/a.csv

remove_path/remove_all_path меняют имя в ZIP, не перемещают исходные файлы. Папки и файлы fixtures должны существовать перед запуском.

<?php
declare(strict_types=1);

$path = __DIR__ . '/lesson.zip';
$zip = new ZipArchive();
if ($zip->open($path, ZipArchive::CREATE | ZipArchive::EXCL) !== true) {
    throw new RuntimeException('Не удалось создать учебный архив');
}
chdir(__DIR__);
$added = $zip->addGlob("input/*.txt", 0, ["remove_all_path" => true]);
echo $added === [] ? "Нет документов\n" : "Другая ветка\n";
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}

Нет документов

Пустая выборка обработана отдельно от false. Пустой ZIP после close() не остаётся.

<?php
declare(strict_types=1);

$path = __DIR__ . '/lesson.zip';
$zip = new ZipArchive();
if ($zip->open($path, ZipArchive::CREATE | ZipArchive::EXCL) !== true) {
    throw new RuntimeException('Не удалось создать учебный архив');
}
chdir(__DIR__);
$added = $zip->addPattern("/\.csv$/", "input", ["remove_all_path" => true, "add_path" => "prices/"]);
if ($added === false) throw new RuntimeException("Пакет не собран");
echo count($added), ":", $zip->getNameIndex(0), "\n";
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
if (is_file($path)) unlink($path);

1:prices/a.csv

remove_path/remove_all_path меняют имя в ZIP, не перемещают исходные файлы. Папки и файлы fixtures должны существовать перед запуском.

<?php
declare(strict_types=1);

$path = __DIR__ . '/lesson.zip';
$zip = new ZipArchive();
if ($zip->open($path, ZipArchive::CREATE | ZipArchive::EXCL) !== true) {
    throw new RuntimeException('Не удалось создать учебный архив');
}
chdir(__DIR__);
$added = $zip->addPattern("/^invoice-.*\.txt$/", "input", ["remove_all_path" => true]);
echo $added === [] ? "Нет документов\n" : "Другая ветка\n";
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}

Нет документов

Пустая выборка обработана отдельно от false. Пустой ZIP после close() не остаётся.

<?php
declare(strict_types=1);

$path = __DIR__ . '/lesson.zip';
$zip = new ZipArchive();
if ($zip->open($path, ZipArchive::CREATE | ZipArchive::EXCL) !== true) {
    throw new RuntimeException('Не удалось создать учебный архив');
}
if (!$zip->addFromString('order.txt', 'paid:42')) {
    throw new RuntimeException('Запись не добавлена');
}
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
if ($zip->open($path) !== true) {
    throw new RuntimeException('Архив не прочитан');
}
echo $zip->count(), "\n";
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
if (is_file($path)) unlink($path);

1

В подготовленном архиве один чек.

<?php
declare(strict_types=1);

$path = __DIR__ . '/lesson.zip';
$zip = new ZipArchive();
if ($zip->open($path, ZipArchive::CREATE | ZipArchive::EXCL) !== true) {
    throw new RuntimeException('Не удалось создать учебный архив');
}
if (!$zip->addFromString('order.txt', 'paid:42')) {
    throw new RuntimeException('Запись не добавлена');
}
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
if ($zip->open($path) !== true) {
    throw new RuntimeException('Архив не прочитан');
}
$zip->addEmptyDir("acts");
echo count($zip), "\n";
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
if (is_file($path)) unlink($path);

2

Countable позволяет общую функцию count(). После удаления индексы могут иметь пропуски: количество не доказывает доступность каждого номера.

<?php
declare(strict_types=1);

$path = __DIR__ . '/lesson.zip';
$zip = new ZipArchive();
if ($zip->open($path, ZipArchive::CREATE | ZipArchive::EXCL) !== true) {
    throw new RuntimeException('Не удалось создать учебный архив');
}
if (!$zip->addFromString('order.txt', 'paid:42')) {
    throw new RuntimeException('Запись не добавлена');
}
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
if ($zip->open($path) !== true) {
    throw new RuntimeException('Архив не прочитан');
}
$index = $zip->locateName("order.txt");
echo $index !== false ? "Индекс: $index\n" : "Нет\n";
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
if (is_file($path)) unlink($path);

Индекс: 0

Строгое сравнение различает false и 0.

<?php
declare(strict_types=1);

$path = __DIR__ . '/lesson.zip';
$zip = new ZipArchive();
if ($zip->open($path, ZipArchive::CREATE | ZipArchive::EXCL) !== true) {
    throw new RuntimeException('Не удалось создать учебный архив');
}
if (!$zip->addFromString('order.txt', 'paid:42')) {
    throw new RuntimeException('Запись не добавлена');
}
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
if ($zip->open($path) !== true) {
    throw new RuntimeException('Архив не прочитан');
}
echo $zip->locateName("ORDER.TXT", ZipArchive::FL_NOCASE), "\n";
var_export($zip->locateName("missing.txt")); echo "\n";
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
if (is_file($path)) unlink($path);

0
false

FL_NOCASE удобен для поиска, но не решает конфликты нескольких подходящих имён. В импорте лучше требовать однозначное точное имя.

<?php
declare(strict_types=1);

$path = __DIR__ . '/lesson.zip';
$zip = new ZipArchive();
if ($zip->open($path, ZipArchive::CREATE | ZipArchive::EXCL) !== true) {
    throw new RuntimeException('Не удалось создать учебный архив');
}
if (!$zip->addFromString('order.txt', 'paid:42')) {
    throw new RuntimeException('Запись не добавлена');
}
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
if ($zip->open($path) !== true) {
    throw new RuntimeException('Архив не прочитан');
}
echo $zip->getNameIndex(0), "\n";
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
if (is_file($path)) unlink($path);

order.txt

Имя записи не является безопасным HTML: при выводе в веб-страницу нужно htmlspecialchars().

<?php
declare(strict_types=1);

$path = __DIR__ . '/lesson.zip';
$zip = new ZipArchive();
if ($zip->open($path, ZipArchive::CREATE | ZipArchive::EXCL) !== true) {
    throw new RuntimeException('Не удалось создать учебный архив');
}
if (!$zip->addFromString('order.txt', 'paid:42')) {
    throw new RuntimeException('Запись не добавлена');
}
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
if ($zip->open($path) !== true) {
    throw new RuntimeException('Архив не прочитан');
}
$zip->renameIndex(0, "receipt.txt");
echo $zip->getNameIndex(0), "\n", $zip->getNameIndex(0, ZipArchive::FL_UNCHANGED), "\n";
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
if (is_file($path)) unlink($path);

receipt.txt
order.txt

UNCHANGED обращается к состоянию, открытому с диска, а не отменяет изменение.

<?php
declare(strict_types=1);

$path = __DIR__ . '/lesson.zip';
$zip = new ZipArchive();
if ($zip->open($path, ZipArchive::CREATE | ZipArchive::EXCL) !== true) {
    throw new RuntimeException('Не удалось создать учебный архив');
}
if (!$zip->addFromString('order.txt', 'paid:42')) {
    throw new RuntimeException('Запись не добавлена');
}
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
if ($zip->open($path) !== true) {
    throw new RuntimeException('Архив не прочитан');
}
echo $zip->getFromName("order.txt"), "\n";
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
if (is_file($path)) unlink($path);

paid:42

Это байты содержимого, а не имя и не распакованный файл на диске.

<?php
declare(strict_types=1);

$path = __DIR__ . '/lesson.zip';
$zip = new ZipArchive();
if ($zip->open($path, ZipArchive::CREATE | ZipArchive::EXCL) !== true) {
    throw new RuntimeException('Не удалось создать учебный архив');
}
if (!$zip->addFromString('order.txt', 'paid:42')) {
    throw new RuntimeException('Запись не добавлена');
}
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
if ($zip->open($path) !== true) {
    throw new RuntimeException('Архив не прочитан');
}
echo $zip->getFromName("order.txt", 4), "\n";
var_export($zip->getFromName("missing.txt")); echo "\n";
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
if (is_file($path)) unlink($path);

paid
false

Первые 4 байта подходят для ASCII-маркера. Ограниченный префикс не доказывает целостность всего содержимого; UTF-8 можно разрезать посередине символа.

<?php
declare(strict_types=1);

$path = __DIR__ . '/lesson.zip';
$zip = new ZipArchive();
if ($zip->open($path, ZipArchive::CREATE | ZipArchive::EXCL) !== true) {
    throw new RuntimeException('Не удалось создать учебный архив');
}
if (!$zip->addFromString('order.txt', 'paid:42')) {
    throw new RuntimeException('Запись не добавлена');
}
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
if ($zip->open($path) !== true) {
    throw new RuntimeException('Архив не прочитан');
}
echo $zip->getFromIndex(0), "\n";
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
if (is_file($path)) unlink($path);

paid:42

Это байты содержимого, а не имя и не распакованный файл на диске.

<?php
declare(strict_types=1);

$path = __DIR__ . '/lesson.zip';
$zip = new ZipArchive();
if ($zip->open($path, ZipArchive::CREATE | ZipArchive::EXCL) !== true) {
    throw new RuntimeException('Не удалось создать учебный архив');
}
if (!$zip->addFromString('order.txt', 'paid:42')) {
    throw new RuntimeException('Запись не добавлена');
}
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
if ($zip->open($path) !== true) {
    throw new RuntimeException('Архив не прочитан');
}
echo $zip->getFromIndex(0, 4), "\n";
var_export($zip->getFromIndex(9)); echo "\n";
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
if (is_file($path)) unlink($path);

paid
false

Первые 4 байта подходят для ASCII-маркера. Ограниченный префикс не доказывает целостность всего содержимого; UTF-8 можно разрезать посередине символа.

<?php
declare(strict_types=1);

$path = __DIR__ . '/lesson.zip';
$zip = new ZipArchive();
if ($zip->open($path, ZipArchive::CREATE | ZipArchive::EXCL) !== true) {
    throw new RuntimeException('Не удалось создать учебный архив');
}
if (!$zip->addFromString('order.txt', 'paid:42')) {
    throw new RuntimeException('Запись не добавлена');
}
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
if ($zip->open($path) !== true) {
    throw new RuntimeException('Архив не прочитан');
}
$info = $zip->statName("order.txt");
if ($info === false) throw new RuntimeException("Нет записи");
echo $info["name"], ":", $info["size"], "\n";
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
if (is_file($path)) unlink($path);

order.txt:7

size и comp_size различаются по смыслу; коэффициент сжатия не является гарантией безопасности.

<?php
declare(strict_types=1);

$path = __DIR__ . '/lesson.zip';
$zip = new ZipArchive();
if ($zip->open($path, ZipArchive::CREATE | ZipArchive::EXCL) !== true) {
    throw new RuntimeException('Не удалось создать учебный архив');
}
if (!$zip->addFromString('order.txt', 'paid:42')) {
    throw new RuntimeException('Запись не добавлена');
}
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
if ($zip->open($path) !== true) {
    throw new RuntimeException('Архив не прочитан');
}
$info = $zip->statName("order.txt");
if ($info === false) throw new RuntimeException("Нет записи");
echo $info["size"] <= 1024 ? "В пределах 1 KiB\n" : "Слишком большой\n";
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
if (is_file($path)) unlink($path);

В пределах 1 KiB

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

<?php
declare(strict_types=1);

$path = __DIR__ . '/lesson.zip';
$zip = new ZipArchive();
if ($zip->open($path, ZipArchive::CREATE | ZipArchive::EXCL) !== true) {
    throw new RuntimeException('Не удалось создать учебный архив');
}
if (!$zip->addFromString('order.txt', 'paid:42')) {
    throw new RuntimeException('Запись не добавлена');
}
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
if ($zip->open($path) !== true) {
    throw new RuntimeException('Архив не прочитан');
}
$info = $zip->statIndex(0);
if ($info === false) throw new RuntimeException("Нет записи");
echo $info["name"], ":", $info["size"], "\n";
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
if (is_file($path)) unlink($path);

order.txt:7

size и comp_size различаются по смыслу; коэффициент сжатия не является гарантией безопасности.

<?php
declare(strict_types=1);

$path = __DIR__ . '/lesson.zip';
$zip = new ZipArchive();
if ($zip->open($path, ZipArchive::CREATE | ZipArchive::EXCL) !== true) {
    throw new RuntimeException('Не удалось создать учебный архив');
}
if (!$zip->addFromString('order.txt', 'paid:42')) {
    throw new RuntimeException('Запись не добавлена');
}
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
if ($zip->open($path) !== true) {
    throw new RuntimeException('Архив не прочитан');
}
$info = $zip->statIndex(0);
if ($info === false) throw new RuntimeException("Нет записи");
echo $info["size"] <= 1024 ? "В пределах 1 KiB\n" : "Слишком большой\n";
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
if (is_file($path)) unlink($path);

В пределах 1 KiB

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

<?php
declare(strict_types=1);

$path = __DIR__ . '/lesson.zip';
$zip = new ZipArchive();
if ($zip->open($path, ZipArchive::CREATE | ZipArchive::EXCL) !== true) {
    throw new RuntimeException('Не удалось создать учебный архив');
}
if (!$zip->addFromString('order.txt', 'paid:42')) {
    throw new RuntimeException('Запись не добавлена');
}
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
if ($zip->open($path) !== true) {
    throw new RuntimeException('Архив не прочитан');
}
$stream = $zip->getStream("order.txt");
if ($stream === false) throw new RuntimeException("Нет потока");
echo fread($stream, 4), "\n";
fclose($stream);
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
if (is_file($path)) unlink($path);

paid

resource — дескриптор открытого потока; fclose закрывает именно его. Поток создан для чтения, fwrite здесь не подходит.

<?php
declare(strict_types=1);

$path = __DIR__ . '/lesson.zip';
$zip = new ZipArchive();
if ($zip->open($path, ZipArchive::CREATE | ZipArchive::EXCL) !== true) {
    throw new RuntimeException('Не удалось создать учебный архив');
}
if (!$zip->addFromString('order.txt', 'paid:42')) {
    throw new RuntimeException('Запись не добавлена');
}
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
if ($zip->open($path) !== true) {
    throw new RuntimeException('Архив не прочитан');
}
$stream = $zip->getStream("order.txt");
if ($stream === false) throw new RuntimeException("Нет потока");
try {
    $body = stream_get_contents($stream, 9);
    if ($body === false || strlen($body) > 8) throw new RuntimeException("Лимит");
    echo $body, "\n";
} finally {
    fclose($stream);
}
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
if (is_file($path)) unlink($path);

paid:42

Читаем лимит+1, чтобы обнаружить превышение; finally освобождает поток и при исключении. В большом импорте обрабатывайте порции и суммарный счётчик.

<?php
declare(strict_types=1);

$path = __DIR__ . '/lesson.zip';
$zip = new ZipArchive();
if ($zip->open($path, ZipArchive::CREATE | ZipArchive::EXCL) !== true) {
    throw new RuntimeException('Не удалось создать учебный архив');
}
if (!$zip->addFromString('order.txt', 'paid:42')) {
    throw new RuntimeException('Запись не добавлена');
}
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
if ($zip->open($path) !== true) {
    throw new RuntimeException('Архив не прочитан');
}
$stream = $zip->getStreamName("order.txt");
if ($stream === false) throw new RuntimeException("Нет потока");
echo fread($stream, 4), "\n";
fclose($stream);
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
if (is_file($path)) unlink($path);

paid

resource — дескриптор открытого потока; fclose закрывает именно его. Поток создан для чтения, fwrite здесь не подходит.

<?php
declare(strict_types=1);

$path = __DIR__ . '/lesson.zip';
$zip = new ZipArchive();
if ($zip->open($path, ZipArchive::CREATE | ZipArchive::EXCL) !== true) {
    throw new RuntimeException('Не удалось создать учебный архив');
}
if (!$zip->addFromString('order.txt', 'paid:42')) {
    throw new RuntimeException('Запись не добавлена');
}
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
if ($zip->open($path) !== true) {
    throw new RuntimeException('Архив не прочитан');
}
$stream = $zip->getStreamName("order.txt");
if ($stream === false) throw new RuntimeException("Нет потока");
try {
    $body = stream_get_contents($stream, 9);
    if ($body === false || strlen($body) > 8) throw new RuntimeException("Лимит");
    echo $body, "\n";
} finally {
    fclose($stream);
}
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
if (is_file($path)) unlink($path);

paid:42

Читаем лимит+1, чтобы обнаружить превышение; finally освобождает поток и при исключении. В большом импорте обрабатывайте порции и суммарный счётчик.

<?php
declare(strict_types=1);

$path = __DIR__ . '/lesson.zip';
$zip = new ZipArchive();
if ($zip->open($path, ZipArchive::CREATE | ZipArchive::EXCL) !== true) {
    throw new RuntimeException('Не удалось создать учебный архив');
}
if (!$zip->addFromString('order.txt', 'paid:42')) {
    throw new RuntimeException('Запись не добавлена');
}
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
if ($zip->open($path) !== true) {
    throw new RuntimeException('Архив не прочитан');
}
$stream = $zip->getStreamIndex(0);
if ($stream === false) throw new RuntimeException("Нет потока");
echo fread($stream, 4), "\n";
fclose($stream);
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
if (is_file($path)) unlink($path);

paid

resource — дескриптор открытого потока; fclose закрывает именно его. Поток создан для чтения, fwrite здесь не подходит.

<?php
declare(strict_types=1);

$path = __DIR__ . '/lesson.zip';
$zip = new ZipArchive();
if ($zip->open($path, ZipArchive::CREATE | ZipArchive::EXCL) !== true) {
    throw new RuntimeException('Не удалось создать учебный архив');
}
if (!$zip->addFromString('order.txt', 'paid:42')) {
    throw new RuntimeException('Запись не добавлена');
}
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
if ($zip->open($path) !== true) {
    throw new RuntimeException('Архив не прочитан');
}
$stream = $zip->getStreamIndex(0);
if ($stream === false) throw new RuntimeException("Нет потока");
try {
    $body = stream_get_contents($stream, 9);
    if ($body === false || strlen($body) > 8) throw new RuntimeException("Лимит");
    echo $body, "\n";
} finally {
    fclose($stream);
}
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
if (is_file($path)) unlink($path);

paid:42

Читаем лимит+1, чтобы обнаружить превышение; finally освобождает поток и при исключении. В большом импорте обрабатывайте порции и суммарный счётчик.

<?php
declare(strict_types=1);

$path = __DIR__ . '/lesson.zip';
$zip = new ZipArchive();
if ($zip->open($path, ZipArchive::CREATE | ZipArchive::EXCL) !== true) {
    throw new RuntimeException('Не удалось создать учебный архив');
}
if (!$zip->addFromString('order.txt', 'paid:42')) {
    throw new RuntimeException('Запись не добавлена');
}
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
if ($zip->open($path) !== true) {
    throw new RuntimeException('Архив не прочитан');
}
$zip->locateName("missing.txt");
echo $zip->status === ZipArchive::ER_NOENT ? "Нет записи\n" : "Иной код\n";
echo $zip->getStatusString() !== "" ? "Есть описание\n" : "Пусто\n";
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
if (is_file($path)) unlink($path);

Нет записи
Есть описание

Журнал может содержать чувствительные пути: не отдавайте его клиенту целиком.

<?php
declare(strict_types=1);

$path = __DIR__ . '/lesson.zip';
$zip = new ZipArchive();
if ($zip->open($path, ZipArchive::CREATE | ZipArchive::EXCL) !== true) {
    throw new RuntimeException('Не удалось создать учебный архив');
}
if (!$zip->addFromString('order.txt', 'paid:42')) {
    throw new RuntimeException('Запись не добавлена');
}
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
if ($zip->open($path) !== true) {
    throw new RuntimeException('Архив не прочитан');
}
$zip->locateName("missing.txt");
$zip->clearError();
echo $zip->status === ZipArchive::ER_OK ? "OK\n" : "Ошибка\n";
echo $zip->getStatusString() !== "" ? "Есть описание состояния\n" : "Пусто\n";
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
if (is_file($path)) unlink($path);

OK
Есть описание состояния

Текст существует и для нормального состояния, поэтому непустая строка сама по себе не признак ошибки.

<?php
declare(strict_types=1);

$path = __DIR__ . '/lesson.zip';
$zip = new ZipArchive();
if ($zip->open($path, ZipArchive::CREATE | ZipArchive::EXCL) !== true) {
    throw new RuntimeException('Не удалось создать учебный архив');
}
if (!$zip->addFromString('order.txt', 'paid:42')) {
    throw new RuntimeException('Запись не добавлена');
}
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
if ($zip->open($path) !== true) {
    throw new RuntimeException('Архив не прочитан');
}
$zip->locateName("missing.txt");
$zip->clearError();
echo $zip->status === ZipArchive::ER_OK ? "Сброшено\n" : "Ошибка\n";
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
if (is_file($path)) unlink($path);

Сброшено

Не скрывайте необработанный отказ простым сбросом.

<?php
declare(strict_types=1);

$path = __DIR__ . '/lesson.zip';
$zip = new ZipArchive();
if ($zip->open($path, ZipArchive::CREATE | ZipArchive::EXCL) !== true) {
    throw new RuntimeException('Не удалось создать учебный архив');
}
if (!$zip->addFromString('order.txt', 'paid:42')) {
    throw new RuntimeException('Запись не добавлена');
}
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
if ($zip->open($path) !== true) {
    throw new RuntimeException('Архив не прочитан');
}
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
$zip->clearError();
echo $zip->status, ":", $zip->statusSys, "\n";
unlink($path);

0:0

Метод работает с сохранёнными кодами закрытого объекта; другие операции над записями всё ещё требуют open().

<?php
declare(strict_types=1);

$path = __DIR__ . '/lesson.zip';
$zip = new ZipArchive();
if ($zip->open($path, ZipArchive::CREATE | ZipArchive::EXCL) !== true) {
    throw new RuntimeException('Не удалось создать учебный архив');
}
if (!$zip->addFromString('order.txt', 'paid:42')) {
    throw new RuntimeException('Запись не добавлена');
}
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
if ($zip->open($path) !== true) {
    throw new RuntimeException('Архив не прочитан');
}
$dest = __DIR__ . "/unpack";
mkdir($dest, 0700);
if (!$zip->extractTo($dest, "order.txt")) throw new RuntimeException("Не извлечён");
echo file_get_contents($dest . "/order.txt"), "\n";
unlink($dest . "/order.txt");
rmdir($dest);
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
if (is_file($path)) unlink($path);

paid:42

Своя новая папка исключает случайную перезапись существующего пользовательского документа. Пример получает собственный доверенный ZIP.

<?php
declare(strict_types=1);

$path = __DIR__ . '/lesson.zip';
$zip = new ZipArchive();
if ($zip->open($path, ZipArchive::CREATE | ZipArchive::EXCL) !== true) {
    throw new RuntimeException('Не удалось создать учебный архив');
}
if (!$zip->addFromString('order.txt', 'paid:42')) {
    throw new RuntimeException('Запись не добавлена');
}
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
if ($zip->open($path) !== true) {
    throw new RuntimeException('Архив не прочитан');
}
$allowed = ["order.txt"];
foreach ($allowed as $name) {
    if ($zip->locateName($name) === false) throw new RuntimeException("Неполный пакет");
}
$dest = __DIR__ . "/unpack";
mkdir($dest, 0700);
if (!$zip->extractTo($dest, $allowed)) throw new RuntimeException("Ошибка распаковки");
echo count($allowed), " документ\n";
unlink($dest . "/order.txt");
rmdir($dest);
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
if (is_file($path)) unlink($path);

1 документ

Список имён — политика импорта; он не разрешает остальные записи архива.

<?php
declare(strict_types=1);

$path = __DIR__ . '/lesson.zip';
$zip = new ZipArchive();
if ($zip->open($path, ZipArchive::CREATE | ZipArchive::EXCL) !== true) {
    throw new RuntimeException('Не удалось создать учебный архив');
}
if (!$zip->addFromString('order.txt', 'paid:42')) {
    throw new RuntimeException('Запись не добавлена');
}
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
if ($zip->open($path) !== true) {
    throw new RuntimeException('Архив не прочитан');
}
$zip->setArchiveComment("Поставка 42");
echo $zip->getArchiveComment(), "\n";
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
if (is_file($path)) unlink($path);

Поставка 42

Комментарий — метаданные ZIP, не дополнительный текстовый файл; он не шифруется вместе с содержимым записи.

<?php
declare(strict_types=1);

$path = __DIR__ . '/lesson.zip';
$zip = new ZipArchive();
if ($zip->open($path, ZipArchive::CREATE | ZipArchive::EXCL) !== true) {
    throw new RuntimeException('Не удалось создать учебный архив');
}
if (!$zip->addFromString('order.txt', 'paid:42')) {
    throw new RuntimeException('Запись не добавлена');
}
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
if ($zip->open($path) !== true) {
    throw new RuntimeException('Архив не прочитан');
}
$zip->setArchiveComment("Поставка 42");
$zip->setArchiveComment("");
var_export($zip->getArchiveComment() === ""); echo "\n";
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
if (is_file($path)) unlink($path);

true

Пустой комментарий — успешный результат; false имеет другой смысл. FL_UNCHANGED не делает откат.

<?php
declare(strict_types=1);

$path = __DIR__ . '/lesson.zip';
$zip = new ZipArchive();
if ($zip->open($path, ZipArchive::CREATE | ZipArchive::EXCL) !== true) {
    throw new RuntimeException('Не удалось создать учебный архив');
}
if (!$zip->addFromString('order.txt', 'paid:42')) {
    throw new RuntimeException('Запись не добавлена');
}
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
if ($zip->open($path) !== true) {
    throw new RuntimeException('Архив не прочитан');
}
$zip->setArchiveComment("Поставка 42");
echo $zip->getArchiveComment(), "\n";
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
if (is_file($path)) unlink($path);

Поставка 42

Комментарий — метаданные ZIP, не дополнительный текстовый файл; он не шифруется вместе с содержимым записи.

<?php
declare(strict_types=1);

$path = __DIR__ . '/lesson.zip';
$zip = new ZipArchive();
if ($zip->open($path, ZipArchive::CREATE | ZipArchive::EXCL) !== true) {
    throw new RuntimeException('Не удалось создать учебный архив');
}
if (!$zip->addFromString('order.txt', 'paid:42')) {
    throw new RuntimeException('Запись не добавлена');
}
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
if ($zip->open($path) !== true) {
    throw new RuntimeException('Архив не прочитан');
}
$zip->setArchiveComment("Черновик");
echo $zip->getArchiveComment(), "\n";
var_export($zip->getArchiveComment(ZipArchive::FL_UNCHANGED) === ""); echo "\n";
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
if (is_file($path)) unlink($path);

Черновик
true

Пустой комментарий — успешный результат; false имеет другой смысл. FL_UNCHANGED не делает откат.

<?php
declare(strict_types=1);

$path = __DIR__ . '/lesson.zip';
$zip = new ZipArchive();
if ($zip->open($path, ZipArchive::CREATE | ZipArchive::EXCL) !== true) {
    throw new RuntimeException('Не удалось создать учебный архив');
}
if (!$zip->addFromString('order.txt', 'paid:42')) {
    throw new RuntimeException('Запись не добавлена');
}
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
if ($zip->open($path) !== true) {
    throw new RuntimeException('Архив не прочитан');
}
$zip->setCommentIndex(0, "Поставка 42");
echo $zip->getCommentIndex(0), "\n";
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
if (is_file($path)) unlink($path);

Поставка 42

Комментарий — метаданные ZIP, не дополнительный текстовый файл; он не шифруется вместе с содержимым записи.

<?php
declare(strict_types=1);

$path = __DIR__ . '/lesson.zip';
$zip = new ZipArchive();
if ($zip->open($path, ZipArchive::CREATE | ZipArchive::EXCL) !== true) {
    throw new RuntimeException('Не удалось создать учебный архив');
}
if (!$zip->addFromString('order.txt', 'paid:42')) {
    throw new RuntimeException('Запись не добавлена');
}
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
if ($zip->open($path) !== true) {
    throw new RuntimeException('Архив не прочитан');
}
$zip->setCommentIndex(0, "Поставка 42");
$zip->setCommentIndex(0, "");
var_export($zip->getCommentIndex(0) === ""); echo "\n";
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
if (is_file($path)) unlink($path);

true

Пустой комментарий — успешный результат; false имеет другой смысл. FL_UNCHANGED не делает откат.

<?php
declare(strict_types=1);

$path = __DIR__ . '/lesson.zip';
$zip = new ZipArchive();
if ($zip->open($path, ZipArchive::CREATE | ZipArchive::EXCL) !== true) {
    throw new RuntimeException('Не удалось создать учебный архив');
}
if (!$zip->addFromString('order.txt', 'paid:42')) {
    throw new RuntimeException('Запись не добавлена');
}
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
if ($zip->open($path) !== true) {
    throw new RuntimeException('Архив не прочитан');
}
$zip->setCommentIndex(0, "Поставка 42");
echo $zip->getCommentIndex(0), "\n";
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
if (is_file($path)) unlink($path);

Поставка 42

Комментарий — метаданные ZIP, не дополнительный текстовый файл; он не шифруется вместе с содержимым записи.

<?php
declare(strict_types=1);

$path = __DIR__ . '/lesson.zip';
$zip = new ZipArchive();
if ($zip->open($path, ZipArchive::CREATE | ZipArchive::EXCL) !== true) {
    throw new RuntimeException('Не удалось создать учебный архив');
}
if (!$zip->addFromString('order.txt', 'paid:42')) {
    throw new RuntimeException('Запись не добавлена');
}
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
if ($zip->open($path) !== true) {
    throw new RuntimeException('Архив не прочитан');
}
$zip->setCommentIndex(0, "Черновик");
echo $zip->getCommentIndex(0), "\n";
var_export($zip->getCommentIndex(0, ZipArchive::FL_UNCHANGED) === ""); echo "\n";
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
if (is_file($path)) unlink($path);

Черновик
true

Пустой комментарий — успешный результат; false имеет другой смысл. FL_UNCHANGED не делает откат.

<?php
declare(strict_types=1);

$path = __DIR__ . '/lesson.zip';
$zip = new ZipArchive();
if ($zip->open($path, ZipArchive::CREATE | ZipArchive::EXCL) !== true) {
    throw new RuntimeException('Не удалось создать учебный архив');
}
if (!$zip->addFromString('order.txt', 'paid:42')) {
    throw new RuntimeException('Запись не добавлена');
}
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
if ($zip->open($path) !== true) {
    throw new RuntimeException('Архив не прочитан');
}
$zip->setCommentName("order.txt", "Поставка 42");
echo $zip->getCommentName("order.txt"), "\n";
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
if (is_file($path)) unlink($path);

Поставка 42

Комментарий — метаданные ZIP, не дополнительный текстовый файл; он не шифруется вместе с содержимым записи.

<?php
declare(strict_types=1);

$path = __DIR__ . '/lesson.zip';
$zip = new ZipArchive();
if ($zip->open($path, ZipArchive::CREATE | ZipArchive::EXCL) !== true) {
    throw new RuntimeException('Не удалось создать учебный архив');
}
if (!$zip->addFromString('order.txt', 'paid:42')) {
    throw new RuntimeException('Запись не добавлена');
}
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
if ($zip->open($path) !== true) {
    throw new RuntimeException('Архив не прочитан');
}
$zip->setCommentName("order.txt", "Поставка 42");
$zip->setCommentName("order.txt", "");
var_export($zip->getCommentName("order.txt") === ""); echo "\n";
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
if (is_file($path)) unlink($path);

true

Пустой комментарий — успешный результат; false имеет другой смысл. FL_UNCHANGED не делает откат.

<?php
declare(strict_types=1);

$path = __DIR__ . '/lesson.zip';
$zip = new ZipArchive();
if ($zip->open($path, ZipArchive::CREATE | ZipArchive::EXCL) !== true) {
    throw new RuntimeException('Не удалось создать учебный архив');
}
if (!$zip->addFromString('order.txt', 'paid:42')) {
    throw new RuntimeException('Запись не добавлена');
}
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
if ($zip->open($path) !== true) {
    throw new RuntimeException('Архив не прочитан');
}
$zip->setCommentName("order.txt", "Поставка 42");
echo $zip->getCommentName("order.txt"), "\n";
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
if (is_file($path)) unlink($path);

Поставка 42

Комментарий — метаданные ZIP, не дополнительный текстовый файл; он не шифруется вместе с содержимым записи.

<?php
declare(strict_types=1);

$path = __DIR__ . '/lesson.zip';
$zip = new ZipArchive();
if ($zip->open($path, ZipArchive::CREATE | ZipArchive::EXCL) !== true) {
    throw new RuntimeException('Не удалось создать учебный архив');
}
if (!$zip->addFromString('order.txt', 'paid:42')) {
    throw new RuntimeException('Запись не добавлена');
}
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
if ($zip->open($path) !== true) {
    throw new RuntimeException('Архив не прочитан');
}
$zip->setCommentName("order.txt", "Черновик");
echo $zip->getCommentName("order.txt"), "\n";
var_export($zip->getCommentName("order.txt", ZipArchive::FL_UNCHANGED) === ""); echo "\n";
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
if (is_file($path)) unlink($path);

Черновик
true

Пустой комментарий — успешный результат; false имеет другой смысл. FL_UNCHANGED не делает откат.

<?php
declare(strict_types=1);

$path = __DIR__ . '/lesson.zip';
$zip = new ZipArchive();
if ($zip->open($path, ZipArchive::CREATE | ZipArchive::EXCL) !== true) {
    throw new RuntimeException('Не удалось создать учебный архив');
}
if (!$zip->addFromString('order.txt', 'paid:42')) {
    throw new RuntimeException('Запись не добавлена');
}
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
if ($zip->open($path) !== true) {
    throw new RuntimeException('Архив не прочитан');
}
$zip->setExternalAttributesIndex(0, ZipArchive::OPSYS_UNIX, 0100644 << 16);
$system = 0; $attributes = 0;
if (!$zip->getExternalAttributesIndex(0, $system, $attributes)) throw new RuntimeException("Нет атрибутов");
echo $system === ZipArchive::OPSYS_UNIX ? "UNIX\n" : "Другое\n";
echo decoct(($attributes >> 16) & 0xffff), "\n";
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
if (is_file($path)) unlink($path);

UNIX
100644

Начальный 0 в 0100644 — восьмеричная запись; << и >> сдвигают биты, & оставляет нужное поле. Это меняет метаданные ZIP, а не chmod локального файла.

<?php
declare(strict_types=1);

$path = __DIR__ . '/lesson.zip';
$zip = new ZipArchive();
if ($zip->open($path, ZipArchive::CREATE | ZipArchive::EXCL) !== true) {
    throw new RuntimeException('Не удалось создать учебный архив');
}
if (!$zip->addFromString('order.txt', 'paid:42')) {
    throw new RuntimeException('Запись не добавлена');
}
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
if ($zip->open($path) !== true) {
    throw new RuntimeException('Архив не прочитан');
}
$zip->setExternalAttributesIndex(0, ZipArchive::OPSYS_UNIX, 0100644 << 16);
$system = 0; $attributes = 0;
if (!$zip->getExternalAttributesIndex(0, $system, $attributes)) throw new RuntimeException("Нет атрибутов");
$isRegular = $system === ZipArchive::OPSYS_UNIX && (($attributes >> 16) & 0170000) === 0100000;
echo $isRegular ? "Обычный файл\n" : "Нужна другая политика\n";
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
if (is_file($path)) unlink($path);

Обычный файл

Маска 0170000 выделяет тип. Если система не UNIX, эти биты нельзя трактовать по UNIX-правилам; консервативный импорт должен выбрать явную политику.

<?php
declare(strict_types=1);

$path = __DIR__ . '/lesson.zip';
$zip = new ZipArchive();
if ($zip->open($path, ZipArchive::CREATE | ZipArchive::EXCL) !== true) {
    throw new RuntimeException('Не удалось создать учебный архив');
}
if (!$zip->addFromString('order.txt', 'paid:42')) {
    throw new RuntimeException('Запись не добавлена');
}
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
if ($zip->open($path) !== true) {
    throw new RuntimeException('Архив не прочитан');
}
$zip->setExternalAttributesIndex(0, ZipArchive::OPSYS_UNIX, 0100644 << 16);
$system = 0; $attributes = 0;
if (!$zip->getExternalAttributesIndex(0, $system, $attributes)) throw new RuntimeException("Нет атрибутов");
echo $system === ZipArchive::OPSYS_UNIX ? "UNIX\n" : "Другое\n";
echo decoct(($attributes >> 16) & 0xffff), "\n";
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
if (is_file($path)) unlink($path);

UNIX
100644

Начальный 0 в 0100644 — восьмеричная запись; << и >> сдвигают биты, & оставляет нужное поле. Это меняет метаданные ZIP, а не chmod локального файла.

<?php
declare(strict_types=1);

$path = __DIR__ . '/lesson.zip';
$zip = new ZipArchive();
if ($zip->open($path, ZipArchive::CREATE | ZipArchive::EXCL) !== true) {
    throw new RuntimeException('Не удалось создать учебный архив');
}
if (!$zip->addFromString('order.txt', 'paid:42')) {
    throw new RuntimeException('Запись не добавлена');
}
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
if ($zip->open($path) !== true) {
    throw new RuntimeException('Архив не прочитан');
}
$zip->setExternalAttributesIndex(0, ZipArchive::OPSYS_UNIX, 0100644 << 16);
$system = 0; $attributes = 0;
if (!$zip->getExternalAttributesIndex(0, $system, $attributes)) throw new RuntimeException("Нет атрибутов");
$isRegular = $system === ZipArchive::OPSYS_UNIX && (($attributes >> 16) & 0170000) === 0100000;
echo $isRegular ? "Обычный файл\n" : "Нужна другая политика\n";
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
if (is_file($path)) unlink($path);

Обычный файл

Маска 0170000 выделяет тип. Если система не UNIX, эти биты нельзя трактовать по UNIX-правилам; консервативный импорт должен выбрать явную политику.

<?php
declare(strict_types=1);

$path = __DIR__ . '/lesson.zip';
$zip = new ZipArchive();
if ($zip->open($path, ZipArchive::CREATE | ZipArchive::EXCL) !== true) {
    throw new RuntimeException('Не удалось создать учебный архив');
}
if (!$zip->addFromString('order.txt', 'paid:42')) {
    throw new RuntimeException('Запись не добавлена');
}
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
if ($zip->open($path) !== true) {
    throw new RuntimeException('Архив не прочитан');
}
date_default_timezone_set("UTC");
$zip->setMtimeIndex(0, 1704067200);
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
if ($zip->open($path) !== true) {
    throw new RuntimeException('Архив не прочитан');
}
echo gmdate("Y-m-d H:i:s", $zip->statIndex(0)["mtime"]), "\n";
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
if (is_file($path)) unlink($path);

2024-01-01 00:00:00

Время фиксировано и зона UTC задана явно; архивный формат может округлять точность, поэтому здесь выбрана чётная секунда.

<?php
declare(strict_types=1);

$path = __DIR__ . '/lesson.zip';
$zip = new ZipArchive();
if ($zip->open($path, ZipArchive::CREATE | ZipArchive::EXCL) !== true) {
    throw new RuntimeException('Не удалось создать учебный архив');
}
if (!$zip->addFromString('order.txt', 'paid:42')) {
    throw new RuntimeException('Запись не добавлена');
}
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
if ($zip->open($path) !== true) {
    throw new RuntimeException('Архив не прочитан');
}
date_default_timezone_set("UTC");
$zip->addFromString("note.txt", "ok");
$zip->setMtimeIndex(0, 1704067200);
$zip->setMtimeIndex(1, 1704067200);
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
if ($zip->open($path) !== true) {
    throw new RuntimeException('Архив не прочитан');
}
echo $zip->statIndex(0)["mtime"] === $zip->statIndex(1)["mtime"] ? "Один выпуск\n" : "Разные даты\n";
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
if (is_file($path)) unlink($path);

Один выпуск

Единая метка полезна для выпуска, но сама по себе не делает ZIP побайтово воспроизводимым: есть порядок, кодеки, прочие метаданные.

<?php
declare(strict_types=1);

$path = __DIR__ . '/lesson.zip';
$zip = new ZipArchive();
if ($zip->open($path, ZipArchive::CREATE | ZipArchive::EXCL) !== true) {
    throw new RuntimeException('Не удалось создать учебный архив');
}
if (!$zip->addFromString('order.txt', 'paid:42')) {
    throw new RuntimeException('Запись не добавлена');
}
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
if ($zip->open($path) !== true) {
    throw new RuntimeException('Архив не прочитан');
}
$zip->setExternalAttributesName("order.txt", ZipArchive::OPSYS_UNIX, 0100644 << 16);
$system = 0; $attributes = 0;
if (!$zip->getExternalAttributesName("order.txt", $system, $attributes)) throw new RuntimeException("Нет атрибутов");
echo $system === ZipArchive::OPSYS_UNIX ? "UNIX\n" : "Другое\n";
echo decoct(($attributes >> 16) & 0xffff), "\n";
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
if (is_file($path)) unlink($path);

UNIX
100644

Начальный 0 в 0100644 — восьмеричная запись; << и >> сдвигают биты, & оставляет нужное поле. Это меняет метаданные ZIP, а не chmod локального файла.

<?php
declare(strict_types=1);

$path = __DIR__ . '/lesson.zip';
$zip = new ZipArchive();
if ($zip->open($path, ZipArchive::CREATE | ZipArchive::EXCL) !== true) {
    throw new RuntimeException('Не удалось создать учебный архив');
}
if (!$zip->addFromString('order.txt', 'paid:42')) {
    throw new RuntimeException('Запись не добавлена');
}
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
if ($zip->open($path) !== true) {
    throw new RuntimeException('Архив не прочитан');
}
$zip->setExternalAttributesName("order.txt", ZipArchive::OPSYS_UNIX, 0100644 << 16);
$system = 0; $attributes = 0;
if (!$zip->getExternalAttributesName("order.txt", $system, $attributes)) throw new RuntimeException("Нет атрибутов");
$isRegular = $system === ZipArchive::OPSYS_UNIX && (($attributes >> 16) & 0170000) === 0100000;
echo $isRegular ? "Обычный файл\n" : "Нужна другая политика\n";
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
if (is_file($path)) unlink($path);

Обычный файл

Маска 0170000 выделяет тип. Если система не UNIX, эти биты нельзя трактовать по UNIX-правилам; консервативный импорт должен выбрать явную политику.

<?php
declare(strict_types=1);

$path = __DIR__ . '/lesson.zip';
$zip = new ZipArchive();
if ($zip->open($path, ZipArchive::CREATE | ZipArchive::EXCL) !== true) {
    throw new RuntimeException('Не удалось создать учебный архив');
}
if (!$zip->addFromString('order.txt', 'paid:42')) {
    throw new RuntimeException('Запись не добавлена');
}
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
if ($zip->open($path) !== true) {
    throw new RuntimeException('Архив не прочитан');
}
$zip->setExternalAttributesName("order.txt", ZipArchive::OPSYS_UNIX, 0100644 << 16);
$system = 0; $attributes = 0;
if (!$zip->getExternalAttributesName("order.txt", $system, $attributes)) throw new RuntimeException("Нет атрибутов");
echo $system === ZipArchive::OPSYS_UNIX ? "UNIX\n" : "Другое\n";
echo decoct(($attributes >> 16) & 0xffff), "\n";
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
if (is_file($path)) unlink($path);

UNIX
100644

Начальный 0 в 0100644 — восьмеричная запись; << и >> сдвигают биты, & оставляет нужное поле. Это меняет метаданные ZIP, а не chmod локального файла.

<?php
declare(strict_types=1);

$path = __DIR__ . '/lesson.zip';
$zip = new ZipArchive();
if ($zip->open($path, ZipArchive::CREATE | ZipArchive::EXCL) !== true) {
    throw new RuntimeException('Не удалось создать учебный архив');
}
if (!$zip->addFromString('order.txt', 'paid:42')) {
    throw new RuntimeException('Запись не добавлена');
}
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
if ($zip->open($path) !== true) {
    throw new RuntimeException('Архив не прочитан');
}
$zip->setExternalAttributesName("order.txt", ZipArchive::OPSYS_UNIX, 0100644 << 16);
$system = 0; $attributes = 0;
if (!$zip->getExternalAttributesName("order.txt", $system, $attributes)) throw new RuntimeException("Нет атрибутов");
$isRegular = $system === ZipArchive::OPSYS_UNIX && (($attributes >> 16) & 0170000) === 0100000;
echo $isRegular ? "Обычный файл\n" : "Нужна другая политика\n";
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
if (is_file($path)) unlink($path);

Обычный файл

Маска 0170000 выделяет тип. Если система не UNIX, эти биты нельзя трактовать по UNIX-правилам; консервативный импорт должен выбрать явную политику.

<?php
declare(strict_types=1);

$path = __DIR__ . '/lesson.zip';
$zip = new ZipArchive();
if ($zip->open($path, ZipArchive::CREATE | ZipArchive::EXCL) !== true) {
    throw new RuntimeException('Не удалось создать учебный архив');
}
if (!$zip->addFromString('order.txt', 'paid:42')) {
    throw new RuntimeException('Запись не добавлена');
}
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
if ($zip->open($path) !== true) {
    throw new RuntimeException('Архив не прочитан');
}
date_default_timezone_set("UTC");
$zip->setMtimeName("order.txt", 1704067200);
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
if ($zip->open($path) !== true) {
    throw new RuntimeException('Архив не прочитан');
}
echo gmdate("Y-m-d H:i:s", $zip->statIndex(0)["mtime"]), "\n";
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
if (is_file($path)) unlink($path);

2024-01-01 00:00:00

Время фиксировано и зона UTC задана явно; архивный формат может округлять точность, поэтому здесь выбрана чётная секунда.

<?php
declare(strict_types=1);

$path = __DIR__ . '/lesson.zip';
$zip = new ZipArchive();
if ($zip->open($path, ZipArchive::CREATE | ZipArchive::EXCL) !== true) {
    throw new RuntimeException('Не удалось создать учебный архив');
}
if (!$zip->addFromString('order.txt', 'paid:42')) {
    throw new RuntimeException('Запись не добавлена');
}
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
if ($zip->open($path) !== true) {
    throw new RuntimeException('Архив не прочитан');
}
date_default_timezone_set("UTC");
$zip->addFromString("note.txt", "ok");
$zip->setMtimeName("order.txt", 1704067200);
$zip->setMtimeName("note.txt", 1704067200);
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
if ($zip->open($path) !== true) {
    throw new RuntimeException('Архив не прочитан');
}
echo $zip->statIndex(0)["mtime"] === $zip->statIndex(1)["mtime"] ? "Один выпуск\n" : "Разные даты\n";
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
if (is_file($path)) unlink($path);

Один выпуск

Единая метка полезна для выпуска, но сама по себе не делает ZIP побайтово воспроизводимым: есть порядок, кодеки, прочие метаданные.

<?php
declare(strict_types=1);

$path = __DIR__ . '/lesson.zip';
$zip = new ZipArchive();
if ($zip->open($path, ZipArchive::CREATE | ZipArchive::EXCL) !== true) {
    throw new RuntimeException('Не удалось создать учебный архив');
}
$zip->setArchiveFlag(ZipArchive::AFL_CREATE_OR_KEEP_FILE_FOR_EMPTY_ARCHIVE, 1);
echo $zip->getArchiveFlag(ZipArchive::AFL_CREATE_OR_KEEP_FILE_FOR_EMPTY_ARCHIVE), "\n";
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
echo is_file($path) ? "ZIP сохранён\n" : "Нет\n";
unlink($path);

1
ZIP сохранён

Возможность требует PHP 8.3 / PECL 1.22 и libzip 1.10; это не то же самое, что нулевой файл.

<?php
declare(strict_types=1);

$path = __DIR__ . '/lesson.zip';
$zip = new ZipArchive();
if ($zip->open($path, ZipArchive::CREATE | ZipArchive::EXCL) !== true) {
    throw new RuntimeException('Не удалось создать учебный архив');
}
if (!$zip->addFromString('order.txt', 'paid:42')) {
    throw new RuntimeException('Запись не добавлена');
}
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
if ($zip->open($path) !== true) {
    throw new RuntimeException('Архив не прочитан');
}
$zip->setArchiveFlag(ZipArchive::AFL_WANT_TORRENTZIP, 1);
echo $zip->getArchiveFlag(ZipArchive::AFL_WANT_TORRENTZIP) === 1 ? "Запрошен TorrentZip\n" : "Нет\n";
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
if (is_file($path)) unlink($path);

Запрошен TorrentZip

AFL_RDONLY от open(RDONLY) нельзя снять; вручную установленный через setArchiveFlag можно снять обратно (уточнение libzip к краткому тексту PHP.net). AFL_IS_TORRENTZIP — наблюдаемый признак. WANT_TORRENTZIP запрашивает формат для записи и не доказывает, что несохранённые изменения уже применены.

<?php
declare(strict_types=1);

$path = __DIR__ . '/lesson.zip';
$zip = new ZipArchive();
if ($zip->open($path, ZipArchive::CREATE | ZipArchive::EXCL) !== true) {
    throw new RuntimeException('Не удалось создать учебный архив');
}
$zip->setArchiveFlag(ZipArchive::AFL_CREATE_OR_KEEP_FILE_FOR_EMPTY_ARCHIVE, 1);
echo $zip->getArchiveFlag(ZipArchive::AFL_CREATE_OR_KEEP_FILE_FOR_EMPTY_ARCHIVE), "\n";
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
echo is_file($path) ? "ZIP сохранён\n" : "Нет\n";
unlink($path);

1
ZIP сохранён

Возможность требует PHP 8.3 / PECL 1.22 и libzip 1.10; это не то же самое, что нулевой файл.

<?php
declare(strict_types=1);

$path = __DIR__ . '/lesson.zip';
$zip = new ZipArchive();
if ($zip->open($path, ZipArchive::CREATE | ZipArchive::EXCL) !== true) {
    throw new RuntimeException('Не удалось создать учебный архив');
}
if (!$zip->addFromString('order.txt', 'paid:42')) {
    throw new RuntimeException('Запись не добавлена');
}
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
if ($zip->open($path) !== true) {
    throw new RuntimeException('Архив не прочитан');
}
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
if ($zip->open($path, ZipArchive::RDONLY) !== true) throw new RuntimeException("Нет ZIP");
echo $zip->getArchiveFlag(ZipArchive::AFL_RDONLY) === 1 ? "Только чтение\n" : "Другое\n";
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
if (is_file($path)) unlink($path);

Только чтение

AFL_RDONLY от open(RDONLY) нельзя снять; вручную установленный через setArchiveFlag можно снять обратно (уточнение libzip к краткому тексту PHP.net). AFL_IS_TORRENTZIP — наблюдаемый признак. WANT_TORRENTZIP запрашивает формат для записи и не доказывает, что несохранённые изменения уже применены.

<?php
declare(strict_types=1);

$path = __DIR__ . '/lesson.zip';
$zip = new ZipArchive();
if ($zip->open($path, ZipArchive::CREATE | ZipArchive::EXCL) !== true) {
    throw new RuntimeException('Не удалось создать учебный архив');
}
if (!$zip->addFromString('order.txt', 'paid:42')) {
    throw new RuntimeException('Запись не добавлена');
}
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
if ($zip->open($path) !== true) {
    throw new RuntimeException('Архив не прочитан');
}
$zip->deleteIndex(0);
var_export($zip->locateName("order.txt")); echo "\n";
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
if (is_file($path)) unlink($path);

false

Операция меняет запись ZIP, не удаляет/переименовывает исходный файл на компьютере.

<?php
declare(strict_types=1);

$path = __DIR__ . '/lesson.zip';
$zip = new ZipArchive();
if ($zip->open($path, ZipArchive::CREATE | ZipArchive::EXCL) !== true) {
    throw new RuntimeException('Не удалось создать учебный архив');
}
if (!$zip->addFromString('order.txt', 'paid:42')) {
    throw new RuntimeException('Запись не добавлена');
}
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
if ($zip->open($path) !== true) {
    throw new RuntimeException('Архив не прочитан');
}
$zip->deleteIndex(0);
$zip->unchangeIndex(0);
echo $zip->getNameIndex(0), "\n";
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
if (is_file($path)) unlink($path);

order.txt

Для отката по имени после rename используйте новое текущее имя. Удалённую запись удобно восстановить по сохранённому индексу.

<?php
declare(strict_types=1);

$path = __DIR__ . '/lesson.zip';
$zip = new ZipArchive();
if ($zip->open($path, ZipArchive::CREATE | ZipArchive::EXCL) !== true) {
    throw new RuntimeException('Не удалось создать учебный архив');
}
if (!$zip->addFromString('order.txt', 'paid:42')) {
    throw new RuntimeException('Запись не добавлена');
}
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
if ($zip->open($path) !== true) {
    throw new RuntimeException('Архив не прочитан');
}
$zip->deleteName("order.txt");
var_export($zip->locateName("order.txt")); echo "\n";
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
if (is_file($path)) unlink($path);

false

Операция меняет запись ZIP, не удаляет/переименовывает исходный файл на компьютере.

<?php
declare(strict_types=1);

$path = __DIR__ . '/lesson.zip';
$zip = new ZipArchive();
if ($zip->open($path, ZipArchive::CREATE | ZipArchive::EXCL) !== true) {
    throw new RuntimeException('Не удалось создать учебный архив');
}
if (!$zip->addFromString('order.txt', 'paid:42')) {
    throw new RuntimeException('Запись не добавлена');
}
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
if ($zip->open($path) !== true) {
    throw new RuntimeException('Архив не прочитан');
}
$zip->deleteName("order.txt");
$zip->unchangeIndex(0);
echo $zip->getNameIndex(0), "\n";
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
if (is_file($path)) unlink($path);

order.txt

Для отката по имени после rename используйте новое текущее имя. Удалённую запись удобно восстановить по сохранённому индексу.

<?php
declare(strict_types=1);

$path = __DIR__ . '/lesson.zip';
$zip = new ZipArchive();
if ($zip->open($path, ZipArchive::CREATE | ZipArchive::EXCL) !== true) {
    throw new RuntimeException('Не удалось создать учебный архив');
}
if (!$zip->addFromString('order.txt', 'paid:42')) {
    throw new RuntimeException('Запись не добавлена');
}
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
if ($zip->open($path) !== true) {
    throw new RuntimeException('Архив не прочитан');
}
$zip->renameIndex(0, "receipt.txt");
echo $zip->getNameIndex(0), "\n";
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
if (is_file($path)) unlink($path);

receipt.txt

Операция меняет запись ZIP, не удаляет/переименовывает исходный файл на компьютере.

<?php
declare(strict_types=1);

$path = __DIR__ . '/lesson.zip';
$zip = new ZipArchive();
if ($zip->open($path, ZipArchive::CREATE | ZipArchive::EXCL) !== true) {
    throw new RuntimeException('Не удалось создать учебный архив');
}
if (!$zip->addFromString('order.txt', 'paid:42')) {
    throw new RuntimeException('Запись не добавлена');
}
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
if ($zip->open($path) !== true) {
    throw new RuntimeException('Архив не прочитан');
}
$zip->renameIndex(0, "receipt.txt");
echo $zip->getNameIndex(0, ZipArchive::FL_UNCHANGED), "\n";
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
if (is_file($path)) unlink($path);

order.txt

Для отката по имени после rename используйте новое текущее имя. Удалённую запись удобно восстановить по сохранённому индексу.

<?php
declare(strict_types=1);

$path = __DIR__ . '/lesson.zip';
$zip = new ZipArchive();
if ($zip->open($path, ZipArchive::CREATE | ZipArchive::EXCL) !== true) {
    throw new RuntimeException('Не удалось создать учебный архив');
}
if (!$zip->addFromString('order.txt', 'paid:42')) {
    throw new RuntimeException('Запись не добавлена');
}
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
if ($zip->open($path) !== true) {
    throw new RuntimeException('Архив не прочитан');
}
$zip->renameName("order.txt", "receipt.txt");
echo $zip->getNameIndex(0), "\n";
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
if (is_file($path)) unlink($path);

receipt.txt

Операция меняет запись ZIP, не удаляет/переименовывает исходный файл на компьютере.

<?php
declare(strict_types=1);

$path = __DIR__ . '/lesson.zip';
$zip = new ZipArchive();
if ($zip->open($path, ZipArchive::CREATE | ZipArchive::EXCL) !== true) {
    throw new RuntimeException('Не удалось создать учебный архив');
}
if (!$zip->addFromString('order.txt', 'paid:42')) {
    throw new RuntimeException('Запись не добавлена');
}
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
if ($zip->open($path) !== true) {
    throw new RuntimeException('Архив не прочитан');
}
$zip->renameName("order.txt", "receipt.txt");
echo $zip->getNameIndex(0, ZipArchive::FL_UNCHANGED), "\n";
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
if (is_file($path)) unlink($path);

order.txt

Для отката по имени после rename используйте новое текущее имя. Удалённую запись удобно восстановить по сохранённому индексу.

<?php
declare(strict_types=1);

$path = __DIR__ . '/lesson.zip';
$zip = new ZipArchive();
if ($zip->open($path, ZipArchive::CREATE | ZipArchive::EXCL) !== true) {
    throw new RuntimeException('Не удалось создать учебный архив');
}
if (!$zip->addFromString('order.txt', 'paid:42')) {
    throw new RuntimeException('Запись не добавлена');
}
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
if ($zip->open($path) !== true) {
    throw new RuntimeException('Архив не прочитан');
}
$zip->addFromString("order.txt", "cancelled:42");
$zip->unchangeIndex(0);
echo $zip->getFromName("order.txt"), "\n";
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
if (is_file($path)) unlink($path);

paid:42

Операция меняет запись ZIP, не удаляет/переименовывает исходный файл на компьютере.

<?php
declare(strict_types=1);

$path = __DIR__ . '/lesson.zip';
$zip = new ZipArchive();
if ($zip->open($path, ZipArchive::CREATE | ZipArchive::EXCL) !== true) {
    throw new RuntimeException('Не удалось создать учебный архив');
}
if (!$zip->addFromString('order.txt', 'paid:42')) {
    throw new RuntimeException('Запись не добавлена');
}
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
if ($zip->open($path) !== true) {
    throw new RuntimeException('Архив не прочитан');
}
$zip->renameIndex(0, "receipt.txt");
$zip->unchangeIndex(0);
echo $zip->getNameIndex(0), "\n";
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
if (is_file($path)) unlink($path);

order.txt

Для отката по имени после rename используйте новое текущее имя. Удалённую запись удобно восстановить по сохранённому индексу.

<?php
declare(strict_types=1);

$path = __DIR__ . '/lesson.zip';
$zip = new ZipArchive();
if ($zip->open($path, ZipArchive::CREATE | ZipArchive::EXCL) !== true) {
    throw new RuntimeException('Не удалось создать учебный архив');
}
if (!$zip->addFromString('order.txt', 'paid:42')) {
    throw new RuntimeException('Запись не добавлена');
}
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
if ($zip->open($path) !== true) {
    throw new RuntimeException('Архив не прочитан');
}
$zip->addFromString("order.txt", "cancelled:42");
$zip->unchangeName("order.txt");
echo $zip->getFromName("order.txt"), "\n";
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
if (is_file($path)) unlink($path);

paid:42

Операция меняет запись ZIP, не удаляет/переименовывает исходный файл на компьютере.

<?php
declare(strict_types=1);

$path = __DIR__ . '/lesson.zip';
$zip = new ZipArchive();
if ($zip->open($path, ZipArchive::CREATE | ZipArchive::EXCL) !== true) {
    throw new RuntimeException('Не удалось создать учебный архив');
}
if (!$zip->addFromString('order.txt', 'paid:42')) {
    throw new RuntimeException('Запись не добавлена');
}
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
if ($zip->open($path) !== true) {
    throw new RuntimeException('Архив не прочитан');
}
$zip->renameIndex(0, "receipt.txt");
$zip->unchangeName("receipt.txt");
echo $zip->getNameIndex(0), "\n";
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
if (is_file($path)) unlink($path);

order.txt

Для отката по имени после rename используйте новое текущее имя. Удалённую запись удобно восстановить по сохранённому индексу.

<?php
declare(strict_types=1);

$path = __DIR__ . '/lesson.zip';
$zip = new ZipArchive();
if ($zip->open($path, ZipArchive::CREATE | ZipArchive::EXCL) !== true) {
    throw new RuntimeException('Не удалось создать учебный архив');
}
if (!$zip->addFromString('order.txt', 'paid:42')) {
    throw new RuntimeException('Запись не добавлена');
}
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
if ($zip->open($path) !== true) {
    throw new RuntimeException('Архив не прочитан');
}
$zip->setArchiveComment("Черновик");
$zip->renameIndex(0, "receipt.txt");
$zip->unchangeAll();
echo $zip->getNameIndex(0), "\n";
var_export($zip->getArchiveComment() === ""); echo "\n";
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
if (is_file($path)) unlink($path);

order.txt
true

Комментарий всего архива относится к общим данным; имя записи — к конкретному документу.

<?php
declare(strict_types=1);

$path = __DIR__ . '/lesson.zip';
$zip = new ZipArchive();
if ($zip->open($path, ZipArchive::CREATE | ZipArchive::EXCL) !== true) {
    throw new RuntimeException('Не удалось создать учебный архив');
}
if (!$zip->addFromString('order.txt', 'paid:42')) {
    throw new RuntimeException('Запись не добавлена');
}
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
if ($zip->open($path) !== true) {
    throw new RuntimeException('Архив не прочитан');
}
$zip->addFromString("order.txt", "cancelled:42");
$zip->unchangeAll();
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
if ($zip->open($path) !== true) {
    throw new RuntimeException('Архив не прочитан');
}
echo $zip->getFromName("order.txt"), "\n";
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
if (is_file($path)) unlink($path);

paid:42

Сравнение показывает, почему unchangeArchive не заменяет unchangeAll при отказе импорта. Проверяется уже сохранённое содержимое.

<?php
declare(strict_types=1);

$path = __DIR__ . '/lesson.zip';
$zip = new ZipArchive();
if ($zip->open($path, ZipArchive::CREATE | ZipArchive::EXCL) !== true) {
    throw new RuntimeException('Не удалось создать учебный архив');
}
if (!$zip->addFromString('order.txt', 'paid:42')) {
    throw new RuntimeException('Запись не добавлена');
}
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
if ($zip->open($path) !== true) {
    throw new RuntimeException('Архив не прочитан');
}
$zip->setArchiveComment("Черновик");
$zip->renameIndex(0, "receipt.txt");
$zip->unchangeArchive();
echo $zip->getNameIndex(0), "\n";
var_export($zip->getArchiveComment() === ""); echo "\n";
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
if (is_file($path)) unlink($path);

receipt.txt
true

Комментарий всего архива относится к общим данным; имя записи — к конкретному документу.

<?php
declare(strict_types=1);

$path = __DIR__ . '/lesson.zip';
$zip = new ZipArchive();
if ($zip->open($path, ZipArchive::CREATE | ZipArchive::EXCL) !== true) {
    throw new RuntimeException('Не удалось создать учебный архив');
}
if (!$zip->addFromString('order.txt', 'paid:42')) {
    throw new RuntimeException('Запись не добавлена');
}
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
if ($zip->open($path) !== true) {
    throw new RuntimeException('Архив не прочитан');
}
$zip->addFromString("order.txt", "cancelled:42");
$zip->unchangeArchive();
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
if ($zip->open($path) !== true) {
    throw new RuntimeException('Архив не прочитан');
}
echo $zip->getFromName("order.txt"), "\n";
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
if (is_file($path)) unlink($path);

cancelled:42

Сравнение показывает, почему unchangeArchive не заменяет unchangeAll при отказе импорта. Проверяется уже сохранённое содержимое.

<?php
declare(strict_types=1);

$method = ZipArchive::CM_DEFLATE;
$available = ZipArchive::isCompressionMethodSupported($method, true);
echo $available ? "Можно создать выбранный формат\n" : "Отказать: нужного кодека нет\n";

Можно создать выбранный формат

Ожидаемый вывод относится к проверенной сборке главы, где AES-256/DEFLATE поддерживаются. На другой сборке честная ветка отказа запрещает молча выдать документ без требуемой защиты/формата.

<?php
declare(strict_types=1);

$method = ZipArchive::CM_DEFLATE;
$canWrite = ZipArchive::isCompressionMethodSupported($method, true);
$canRead = ZipArchive::isCompressionMethodSupported($method, false);
if ($canWrite && $canRead) {
    echo "Сервер может принять и выдать этот формат\n";
} else {
    echo "Нужна другая сборка или согласованный формат\n";
}

Сервер может принять и выдать этот формат

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

<?php
declare(strict_types=1);

$method = ZipArchive::EM_AES_256;
$available = ZipArchive::isEncryptionMethodSupported($method, true);
echo $available ? "Можно создать выбранный формат\n" : "Отказать: нужного кодека нет\n";

Можно создать выбранный формат

Ожидаемый вывод относится к проверенной сборке главы, где AES-256/DEFLATE поддерживаются. На другой сборке честная ветка отказа запрещает молча выдать документ без требуемой защиты/формата.

<?php
declare(strict_types=1);

$method = ZipArchive::EM_AES_256;
$canWrite = ZipArchive::isEncryptionMethodSupported($method, true);
$canRead = ZipArchive::isEncryptionMethodSupported($method, false);
if ($canWrite && $canRead) {
    echo "Сервер может принять и выдать этот формат\n";
} else {
    echo "Нужна другая сборка или согласованный формат\n";
}

Сервер может принять и выдать этот формат

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

<?php
declare(strict_types=1);

$path = __DIR__ . '/lesson.zip';
$zip = new ZipArchive();
if ($zip->open($path, ZipArchive::CREATE | ZipArchive::EXCL) !== true) {
    throw new RuntimeException('Не удалось создать учебный архив');
}
if (!$zip->addFromString('order.txt', 'paid:42')) {
    throw new RuntimeException('Запись не добавлена');
}
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
if ($zip->open($path) !== true) {
    throw new RuntimeException('Архив не прочитан');
}
if (!$zip->setCompressionIndex(0, ZipArchive::CM_STORE)) throw new RuntimeException("Нет STORE");
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
if ($zip->open($path) !== true) {
    throw new RuntimeException('Архив не прочитан');
}
echo $zip->statIndex(0)["comp_method"] === ZipArchive::CM_STORE ? "Без сжатия\n" : "Другой метод\n";
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
if (is_file($path)) unlink($path);

Без сжатия

Не печатаем размеры сжатых байтов как константу: они зависят от кодека и его версии.

<?php
declare(strict_types=1);

$path = __DIR__ . '/lesson.zip';
$zip = new ZipArchive();
if ($zip->open($path, ZipArchive::CREATE | ZipArchive::EXCL) !== true) {
    throw new RuntimeException('Не удалось создать учебный архив');
}
if (!$zip->addFromString('order.txt', 'paid:42')) {
    throw new RuntimeException('Запись не добавлена');
}
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
if ($zip->open($path) !== true) {
    throw new RuntimeException('Архив не прочитан');
}
if (!ZipArchive::isCompressionMethodSupported(ZipArchive::CM_DEFLATE, true)) throw new RuntimeException("Нужен DEFLATE");
if (!$zip->setCompressionIndex(0, ZipArchive::CM_DEFLATE, 6)) throw new RuntimeException("Не настроено");
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
if ($zip->open($path) !== true) {
    throw new RuntimeException('Архив не прочитан');
}
echo $zip->getFromName("order.txt"), "\n";
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
if (is_file($path)) unlink($path);

paid:42

Проверяем восстановление содержимого, а не обещаем, что крошечная строка станет меньше: служебные данные могут перевесить выигрыш.

<?php
declare(strict_types=1);

$path = __DIR__ . '/lesson.zip';
$zip = new ZipArchive();
if ($zip->open($path, ZipArchive::CREATE | ZipArchive::EXCL) !== true) {
    throw new RuntimeException('Не удалось создать учебный архив');
}
if (!$zip->addFromString('order.txt', 'paid:42')) {
    throw new RuntimeException('Запись не добавлена');
}
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
if ($zip->open($path) !== true) {
    throw new RuntimeException('Архив не прочитан');
}
if (!ZipArchive::isEncryptionMethodSupported(ZipArchive::EM_AES_256, true)) throw new RuntimeException("Нужен AES-256");
if (!$zip->setEncryptionIndex(0, ZipArchive::EM_AES_256, "lesson-only-password")) throw new RuntimeException("Не зашифровано");
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
if ($zip->open($path) !== true) {
    throw new RuntimeException('Архив не прочитан');
}
$zip->setPassword("lesson-only-password");
echo $zip->getFromName("order.txt"), "\n";
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
if (is_file($path)) unlink($path);

paid:42

Это явно учебный пароль. В рабочем сервисе секрет поступает из защищённого источника и не попадает в репозиторий/журнал. Требуется AES-поддержка сборки.

<?php
declare(strict_types=1);

$path = __DIR__ . '/lesson.zip';
$zip = new ZipArchive();
if ($zip->open($path, ZipArchive::CREATE | ZipArchive::EXCL) !== true) {
    throw new RuntimeException('Не удалось создать учебный архив');
}
if (!$zip->addFromString('order.txt', 'paid:42')) {
    throw new RuntimeException('Запись не добавлена');
}
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
if ($zip->open($path) !== true) {
    throw new RuntimeException('Архив не прочитан');
}
if (!ZipArchive::isEncryptionMethodSupported(ZipArchive::EM_AES_256, true)) throw new RuntimeException("Нужен AES-256");
$zip->setPassword("lesson-only-password");
if (!$zip->setEncryptionIndex(0, ZipArchive::EM_AES_256)) throw new RuntimeException("Не настроено");
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
if ($zip->open($path) !== true) {
    throw new RuntimeException('Архив не прочитан');
}
$zip->setPassword("lesson-only-password");
echo $zip->statIndex(0)["encryption_method"] === ZipArchive::EM_AES_256 ? "AES-256\n" : "Нет\n";
echo $zip->getFromName("order.txt"), "\n";
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
if (is_file($path)) unlink($path);

AES-256
paid:42

setPassword задаёт default, а setEncryption* выбирает шифрование конкретной записи. Пропуск второго шага оставит её открытой.

<?php
declare(strict_types=1);

$path = __DIR__ . '/lesson.zip';
$zip = new ZipArchive();
if ($zip->open($path, ZipArchive::CREATE | ZipArchive::EXCL) !== true) {
    throw new RuntimeException('Не удалось создать учебный архив');
}
if (!$zip->addFromString('order.txt', 'paid:42')) {
    throw new RuntimeException('Запись не добавлена');
}
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
if ($zip->open($path) !== true) {
    throw new RuntimeException('Архив не прочитан');
}
if (!$zip->setCompressionName("order.txt", ZipArchive::CM_STORE)) throw new RuntimeException("Нет STORE");
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
if ($zip->open($path) !== true) {
    throw new RuntimeException('Архив не прочитан');
}
echo $zip->statIndex(0)["comp_method"] === ZipArchive::CM_STORE ? "Без сжатия\n" : "Другой метод\n";
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
if (is_file($path)) unlink($path);

Без сжатия

Не печатаем размеры сжатых байтов как константу: они зависят от кодека и его версии.

<?php
declare(strict_types=1);

$path = __DIR__ . '/lesson.zip';
$zip = new ZipArchive();
if ($zip->open($path, ZipArchive::CREATE | ZipArchive::EXCL) !== true) {
    throw new RuntimeException('Не удалось создать учебный архив');
}
if (!$zip->addFromString('order.txt', 'paid:42')) {
    throw new RuntimeException('Запись не добавлена');
}
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
if ($zip->open($path) !== true) {
    throw new RuntimeException('Архив не прочитан');
}
if (!ZipArchive::isCompressionMethodSupported(ZipArchive::CM_DEFLATE, true)) throw new RuntimeException("Нужен DEFLATE");
if (!$zip->setCompressionName("order.txt", ZipArchive::CM_DEFLATE, 6)) throw new RuntimeException("Не настроено");
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
if ($zip->open($path) !== true) {
    throw new RuntimeException('Архив не прочитан');
}
echo $zip->getFromName("order.txt"), "\n";
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
if (is_file($path)) unlink($path);

paid:42

Проверяем восстановление содержимого, а не обещаем, что крошечная строка станет меньше: служебные данные могут перевесить выигрыш.

<?php
declare(strict_types=1);

$path = __DIR__ . '/lesson.zip';
$zip = new ZipArchive();
if ($zip->open($path, ZipArchive::CREATE | ZipArchive::EXCL) !== true) {
    throw new RuntimeException('Не удалось создать учебный архив');
}
if (!$zip->addFromString('order.txt', 'paid:42')) {
    throw new RuntimeException('Запись не добавлена');
}
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
if ($zip->open($path) !== true) {
    throw new RuntimeException('Архив не прочитан');
}
if (!ZipArchive::isEncryptionMethodSupported(ZipArchive::EM_AES_256, true)) throw new RuntimeException("Нужен AES-256");
if (!$zip->setEncryptionName("order.txt", ZipArchive::EM_AES_256, "lesson-only-password")) throw new RuntimeException("Не зашифровано");
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
if ($zip->open($path) !== true) {
    throw new RuntimeException('Архив не прочитан');
}
$zip->setPassword("lesson-only-password");
echo $zip->getFromName("order.txt"), "\n";
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
if (is_file($path)) unlink($path);

paid:42

Это явно учебный пароль. В рабочем сервисе секрет поступает из защищённого источника и не попадает в репозиторий/журнал. Требуется AES-поддержка сборки.

<?php
declare(strict_types=1);

$path = __DIR__ . '/lesson.zip';
$zip = new ZipArchive();
if ($zip->open($path, ZipArchive::CREATE | ZipArchive::EXCL) !== true) {
    throw new RuntimeException('Не удалось создать учебный архив');
}
if (!$zip->addFromString('order.txt', 'paid:42')) {
    throw new RuntimeException('Запись не добавлена');
}
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
if ($zip->open($path) !== true) {
    throw new RuntimeException('Архив не прочитан');
}
if (!ZipArchive::isEncryptionMethodSupported(ZipArchive::EM_AES_256, true)) throw new RuntimeException("Нужен AES-256");
$zip->setPassword("lesson-only-password");
if (!$zip->setEncryptionName("order.txt", ZipArchive::EM_AES_256)) throw new RuntimeException("Не настроено");
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
if ($zip->open($path) !== true) {
    throw new RuntimeException('Архив не прочитан');
}
$zip->setPassword("lesson-only-password");
echo $zip->statIndex(0)["encryption_method"] === ZipArchive::EM_AES_256 ? "AES-256\n" : "Нет\n";
echo $zip->getFromName("order.txt"), "\n";
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
if (is_file($path)) unlink($path);

AES-256
paid:42

setPassword задаёт default, а setEncryption* выбирает шифрование конкретной записи. Пропуск второго шага оставит её открытой.

<?php
declare(strict_types=1);

$path = __DIR__ . '/lesson.zip';
$zip = new ZipArchive();
if ($zip->open($path, ZipArchive::CREATE | ZipArchive::EXCL) !== true) {
    throw new RuntimeException('Не удалось создать учебный архив');
}
if (!$zip->addFromString('order.txt', 'paid:42')) {
    throw new RuntimeException('Запись не добавлена');
}
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
if ($zip->open($path) !== true) {
    throw new RuntimeException('Архив не прочитан');
}
$zip->setPassword("lesson-only-password");
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
if ($zip->open($path) !== true) {
    throw new RuntimeException('Архив не прочитан');
}
echo $zip->statIndex(0)["encryption_method"] === ZipArchive::EM_NONE ? "Не зашифровано\n" : "Зашифровано\n";
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
if (is_file($path)) unlink($path);

Не зашифровано

Это проверка распространённого ошибочного ожидания. Для защиты нужен setEncryptionName/Index.

<?php
declare(strict_types=1);

$path = __DIR__ . '/lesson.zip';
$zip = new ZipArchive();
if ($zip->open($path, ZipArchive::CREATE | ZipArchive::EXCL) !== true) {
    throw new RuntimeException('Не удалось создать учебный архив');
}
if (!$zip->addFromString('order.txt', 'paid:42')) {
    throw new RuntimeException('Запись не добавлена');
}
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
if ($zip->open($path) !== true) {
    throw new RuntimeException('Архив не прочитан');
}
if (!ZipArchive::isEncryptionMethodSupported(ZipArchive::EM_AES_256, true)) throw new RuntimeException("Нужен AES");
$zip->setEncryptionName("order.txt", ZipArchive::EM_AES_256, "lesson-only-password");
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
if ($zip->open($path) !== true) {
    throw new RuntimeException('Архив не прочитан');
}
if (!$zip->setPassword("lesson-only-password")) throw new RuntimeException("Нет пароля");
echo $zip->getFromName("order.txt"), "\n";
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
if (is_file($path)) unlink($path);

paid:42

Пароль задаётся заново после повторного открытия; чтение доказывает, что он подходит к этой записи.

<?php
declare(strict_types=1);

$path = __DIR__ . '/lesson.zip';
$zip = new ZipArchive();
if ($zip->open($path, ZipArchive::CREATE | ZipArchive::EXCL) !== true) {
    throw new RuntimeException('Не удалось создать учебный архив');
}
$zip->addFromString("report.txt", str_repeat("order;42\n", 1000));
$seen = false;
$zip->registerProgressCallback(0.1, function (float $state) use (&$seen): void {
    if ($state >= 0.0 && $state <= 1.0) $seen = true;
});
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
echo $seen ? "Прогресс получен\n" : "Нет сообщений\n";
unlink($path);

Прогресс получен

use (&$seen) даёт callback доступ к внешнему флагу по ссылке. Доля относится к работе libzip при закрытии, а не ко всему HTTP-запросу.

<?php
declare(strict_types=1);

$path = __DIR__ . '/lesson.zip';
$zip = new ZipArchive();
if ($zip->open($path, ZipArchive::CREATE | ZipArchive::EXCL) !== true) {
    throw new RuntimeException('Не удалось создать учебный архив');
}
$zip->addFromString("report.txt", str_repeat("line\n", 1000));
$last = 0.0;
$zip->registerProgressCallback(0.25, function (float $state) use (&$last): void { $last = $state; });
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
echo $last >= 0.0 && $last <= 1.0 ? "Доля в диапазоне\n" : "Ошибка\n";
unlink($path);

Доля в диапазоне

Не привязываемся к точному числу вызовов, времени или шагу. Для интерфейса задача обычно пишет прогресс в отдельное состояние, а не печатает в ZIP-ответ.

<?php
declare(strict_types=1);

$path = __DIR__ . '/lesson.zip';
$zip = new ZipArchive();
if ($zip->open($path, ZipArchive::CREATE | ZipArchive::EXCL) !== true) {
    throw new RuntimeException('Не удалось создать учебный архив');
}
$zip->addFromString("report.txt", "order;42");
$zip->registerCancelCallback(static fn(): int => 0);
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
echo "Сохранено\n";
unlink($path);

Сохранено

Короткая стрелочная функция возвращает одно значение; static показывает, что ей не нужен $this.

<?php
declare(strict_types=1);

$path = __DIR__ . '/lesson.zip';
$zip = new ZipArchive();
if ($zip->open($path, ZipArchive::CREATE | ZipArchive::EXCL) !== true) {
    throw new RuntimeException('Не удалось создать учебный архив');
}
$zip->addFromString("report.txt", str_repeat("order;42\n", 1000));
$zip->registerCancelCallback(static fn(): int => 1);
$warning = false;
set_error_handler(function (int $level) use (&$warning): bool {
    if ($level !== E_WARNING) return false;
    $warning = true; return true;
});
try { $saved = $zip->close(); } finally { restore_error_handler(); }
echo !$saved && $warning && $zip->status === ZipArchive::ER_CANCELLED ? "Отменено\n" : "Другой результат\n";
if (is_file($path)) unlink($path);

Отменено

Перехват warning ограничен одним ожидаемым close(), затем восстановлен. Архив после этой попытки закрыт; повторный close() не нужен.

<?php
declare(strict_types=1);

$path = __DIR__ . '/lesson.zip';
$zip = new ZipArchive();
if ($zip->open($path, ZipArchive::CREATE | ZipArchive::EXCL) !== true) {
    throw new RuntimeException('Не удалось создать учебный архив');
}
$zip->addFromString('order.txt', 'paid:42');
$zip->setCompressionName('order.txt', ZipArchive::CM_STORE);
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
$deprecated = false;
set_error_handler(function (int $level) use (&$deprecated): bool {
    if ($level !== E_DEPRECATED) return false;
    $deprecated = true;
    return true;
});
try {
$archive = zip_open($path);
if (!is_resource($archive)) throw new RuntimeException('Не открыт ZIP');
echo is_resource($archive) ? "Ресурс ZIP\n" : "Нет\n";
zip_close($archive);
} finally {
    restore_error_handler();
}
unlink($path);

Ресурс ZIP

Подготовка создаёт собственный архив. Обработчик перехватывает только E_DEPRECATED и только внутри учебного старого API; остальные ошибки не скрываются.

<?php
declare(strict_types=1);

$path = __DIR__ . '/lesson.zip';
$zip = new ZipArchive();
if ($zip->open($path, ZipArchive::CREATE | ZipArchive::EXCL) !== true) {
    throw new RuntimeException('Не удалось создать учебный архив');
}
$zip->addFromString('order.txt', 'paid:42');
$zip->setCompressionName('order.txt', ZipArchive::CM_STORE);
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
$deprecated = false;
set_error_handler(function (int $level) use (&$deprecated): bool {
    if ($level !== E_DEPRECATED) return false;
    $deprecated = true;
    return true;
});
try {
$missing = zip_open(__DIR__ . "/missing.zip");
echo is_int($missing) ? "Код отказа\n" : "Иной результат\n";
} finally {
    restore_error_handler();
}
unlink($path);

Код отказа

Старые ресурсы не смешиваются с ZipArchive и обычными потоками. После этого разбора переходите к связанной современной карточке.

<?php
declare(strict_types=1);

$path = __DIR__ . '/lesson.zip';
$zip = new ZipArchive();
if ($zip->open($path, ZipArchive::CREATE | ZipArchive::EXCL) !== true) {
    throw new RuntimeException('Не удалось создать учебный архив');
}
$zip->addFromString('order.txt', 'paid:42');
$zip->setCompressionName('order.txt', ZipArchive::CM_STORE);
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
$deprecated = false;
set_error_handler(function (int $level) use (&$deprecated): bool {
    if ($level !== E_DEPRECATED) return false;
    $deprecated = true;
    return true;
});
try {
$archive = zip_open($path);
if (!is_resource($archive)) throw new RuntimeException('Не открыт ZIP');
zip_close($archive);
echo is_resource($archive) ? "Открыт\n" : "Закрыт\n";
} finally {
    restore_error_handler();
}
unlink($path);

Закрыт

Подготовка создаёт собственный архив. Обработчик перехватывает только E_DEPRECATED и только внутри учебного старого API; остальные ошибки не скрываются.

<?php
declare(strict_types=1);

$path = __DIR__ . '/lesson.zip';
$zip = new ZipArchive();
if ($zip->open($path, ZipArchive::CREATE | ZipArchive::EXCL) !== true) {
    throw new RuntimeException('Не удалось создать учебный архив');
}
$zip->addFromString('order.txt', 'paid:42');
$zip->setCompressionName('order.txt', ZipArchive::CM_STORE);
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
$deprecated = false;
set_error_handler(function (int $level) use (&$deprecated): bool {
    if ($level !== E_DEPRECATED) return false;
    $deprecated = true;
    return true;
});
try {
$archive = zip_open($path);
if (!is_resource($archive)) throw new RuntimeException('Не открыт ZIP');
$entry = zip_read($archive);
if ($entry === false) throw new RuntimeException('Нет записи');
echo zip_entry_name($entry), "\n";
zip_entry_close($entry);
zip_close($archive);echo "Оба ресурса освобождены\n";
} finally {
    restore_error_handler();
}
unlink($path);

order.txt
Оба ресурса освобождены

Старые ресурсы не смешиваются с ZipArchive и обычными потоками. После этого разбора переходите к связанной современной карточке.

<?php
declare(strict_types=1);

$path = __DIR__ . '/lesson.zip';
$zip = new ZipArchive();
if ($zip->open($path, ZipArchive::CREATE | ZipArchive::EXCL) !== true) {
    throw new RuntimeException('Не удалось создать учебный архив');
}
$zip->addFromString('order.txt', 'paid:42');
$zip->setCompressionName('order.txt', ZipArchive::CM_STORE);
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
$deprecated = false;
set_error_handler(function (int $level) use (&$deprecated): bool {
    if ($level !== E_DEPRECATED) return false;
    $deprecated = true;
    return true;
});
try {
$archive = zip_open($path);
if (!is_resource($archive)) throw new RuntimeException('Не открыт ZIP');
$entry = zip_read($archive);
if ($entry === false) throw new RuntimeException('Нет записи');
echo zip_entry_name($entry), "\n";
zip_entry_close($entry);
zip_close($archive);
} finally {
    restore_error_handler();
}
unlink($path);

order.txt

Подготовка создаёт собственный архив. Обработчик перехватывает только E_DEPRECATED и только внутри учебного старого API; остальные ошибки не скрываются.

<?php
declare(strict_types=1);

$path = __DIR__ . '/lesson.zip';
$zip = new ZipArchive();
if ($zip->open($path, ZipArchive::CREATE | ZipArchive::EXCL) !== true) {
    throw new RuntimeException('Не удалось создать учебный архив');
}
$zip->addFromString('order.txt', 'paid:42');
$zip->setCompressionName('order.txt', ZipArchive::CM_STORE);
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
$deprecated = false;
set_error_handler(function (int $level) use (&$deprecated): bool {
    if ($level !== E_DEPRECATED) return false;
    $deprecated = true;
    return true;
});
try {
$archive = zip_open($path);
if (!is_resource($archive)) throw new RuntimeException('Не открыт ZIP');
$names = [];
while (($entry = zip_read($archive)) !== false) {
    $names[] = zip_entry_name($entry);
    zip_entry_close($entry);
}
echo implode(",", $names), "\n";
zip_close($archive);
} finally {
    restore_error_handler();
}
unlink($path);

order.txt

Старые ресурсы не смешиваются с ZipArchive и обычными потоками. После этого разбора переходите к связанной современной карточке.

<?php
declare(strict_types=1);

$path = __DIR__ . '/lesson.zip';
$zip = new ZipArchive();
if ($zip->open($path, ZipArchive::CREATE | ZipArchive::EXCL) !== true) {
    throw new RuntimeException('Не удалось создать учебный архив');
}
$zip->addFromString('order.txt', 'paid:42');
$zip->setCompressionName('order.txt', ZipArchive::CM_STORE);
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
$deprecated = false;
set_error_handler(function (int $level) use (&$deprecated): bool {
    if ($level !== E_DEPRECATED) return false;
    $deprecated = true;
    return true;
});
try {
$archive = zip_open($path);
if (!is_resource($archive)) throw new RuntimeException('Не открыт ZIP');
$entry = zip_read($archive);
if ($entry === false) throw new RuntimeException('Нет записи');
$opened = zip_entry_open($archive, $entry);
echo $opened ? "Готово к чтению\n" : "Отказ\n";
zip_entry_close($entry);
zip_close($archive);
} finally {
    restore_error_handler();
}
unlink($path);

Готово к чтению

Подготовка создаёт собственный архив. Обработчик перехватывает только E_DEPRECATED и только внутри учебного старого API; остальные ошибки не скрываются.

<?php
declare(strict_types=1);

$path = __DIR__ . '/lesson.zip';
$zip = new ZipArchive();
if ($zip->open($path, ZipArchive::CREATE | ZipArchive::EXCL) !== true) {
    throw new RuntimeException('Не удалось создать учебный архив');
}
$zip->addFromString('order.txt', 'paid:42');
$zip->setCompressionName('order.txt', ZipArchive::CM_STORE);
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
$deprecated = false;
set_error_handler(function (int $level) use (&$deprecated): bool {
    if ($level !== E_DEPRECATED) return false;
    $deprecated = true;
    return true;
});
try {
$archive = zip_open($path);
if (!is_resource($archive)) throw new RuntimeException('Не открыт ZIP');
$entry = zip_read($archive);
if ($entry === false) throw new RuntimeException('Нет записи');
if (!zip_entry_open($archive, $entry, "rb")) throw new RuntimeException("Не открыт");
echo zip_entry_read($entry, 4), "\n";
zip_entry_close($entry);
zip_close($archive);
} finally {
    restore_error_handler();
}
unlink($path);

paid

Старые ресурсы не смешиваются с ZipArchive и обычными потоками. После этого разбора переходите к связанной современной карточке.

<?php
declare(strict_types=1);

$path = __DIR__ . '/lesson.zip';
$zip = new ZipArchive();
if ($zip->open($path, ZipArchive::CREATE | ZipArchive::EXCL) !== true) {
    throw new RuntimeException('Не удалось создать учебный архив');
}
$zip->addFromString('order.txt', 'paid:42');
$zip->setCompressionName('order.txt', ZipArchive::CM_STORE);
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
$deprecated = false;
set_error_handler(function (int $level) use (&$deprecated): bool {
    if ($level !== E_DEPRECATED) return false;
    $deprecated = true;
    return true;
});
try {
$archive = zip_open($path);
if (!is_resource($archive)) throw new RuntimeException('Не открыт ZIP');
$entry = zip_read($archive);
if ($entry === false) throw new RuntimeException('Нет записи');
var_export(zip_entry_close($entry)); echo "\n";
zip_close($archive);
} finally {
    restore_error_handler();
}
unlink($path);

true

Подготовка создаёт собственный архив. Обработчик перехватывает только E_DEPRECATED и только внутри учебного старого API; остальные ошибки не скрываются.

<?php
declare(strict_types=1);

$path = __DIR__ . '/lesson.zip';
$zip = new ZipArchive();
if ($zip->open($path, ZipArchive::CREATE | ZipArchive::EXCL) !== true) {
    throw new RuntimeException('Не удалось создать учебный архив');
}
$zip->addFromString('order.txt', 'paid:42');
$zip->setCompressionName('order.txt', ZipArchive::CM_STORE);
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
$deprecated = false;
set_error_handler(function (int $level) use (&$deprecated): bool {
    if ($level !== E_DEPRECATED) return false;
    $deprecated = true;
    return true;
});
try {
$archive = zip_open($path);
if (!is_resource($archive)) throw new RuntimeException('Не открыт ZIP');
$closed = 0;
while (($entry = zip_read($archive)) !== false) {
    if (zip_entry_close($entry)) $closed++;
}
echo $closed, " освобождённая запись\n";
zip_close($archive);
} finally {
    restore_error_handler();
}
unlink($path);

1 освобождённая запись

Старые ресурсы не смешиваются с ZipArchive и обычными потоками. После этого разбора переходите к связанной современной карточке.

<?php
declare(strict_types=1);

$path = __DIR__ . '/lesson.zip';
$zip = new ZipArchive();
if ($zip->open($path, ZipArchive::CREATE | ZipArchive::EXCL) !== true) {
    throw new RuntimeException('Не удалось создать учебный архив');
}
$zip->addFromString('order.txt', 'paid:42');
$zip->setCompressionName('order.txt', ZipArchive::CM_STORE);
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
$deprecated = false;
set_error_handler(function (int $level) use (&$deprecated): bool {
    if ($level !== E_DEPRECATED) return false;
    $deprecated = true;
    return true;
});
try {
$archive = zip_open($path);
if (!is_resource($archive)) throw new RuntimeException('Не открыт ZIP');
$entry = zip_read($archive);
if ($entry === false) throw new RuntimeException('Нет записи');
echo zip_entry_read($entry, 4), "\n";
zip_entry_close($entry);
zip_close($archive);
} finally {
    restore_error_handler();
}
unlink($path);

paid

Подготовка создаёт собственный архив. Обработчик перехватывает только E_DEPRECATED и только внутри учебного старого API; остальные ошибки не скрываются.

<?php
declare(strict_types=1);

$path = __DIR__ . '/lesson.zip';
$zip = new ZipArchive();
if ($zip->open($path, ZipArchive::CREATE | ZipArchive::EXCL) !== true) {
    throw new RuntimeException('Не удалось создать учебный архив');
}
$zip->addFromString('order.txt', 'paid:42');
$zip->setCompressionName('order.txt', ZipArchive::CM_STORE);
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
$deprecated = false;
set_error_handler(function (int $level) use (&$deprecated): bool {
    if ($level !== E_DEPRECATED) return false;
    $deprecated = true;
    return true;
});
try {
$archive = zip_open($path);
if (!is_resource($archive)) throw new RuntimeException('Не открыт ZIP');
$entry = zip_read($archive);
if ($entry === false) throw new RuntimeException('Нет записи');
$body = "";
while (($chunk = zip_entry_read($entry, 3)) !== "" && $chunk !== false) {
    $body .= $chunk;
    if (strlen($body) > 1024) throw new RuntimeException("Лимит");
}
echo $body, "\n";
zip_entry_close($entry);
zip_close($archive);
} finally {
    restore_error_handler();
}
unlink($path);

paid:42

Старые ресурсы не смешиваются с ZipArchive и обычными потоками. После этого разбора переходите к связанной современной карточке.

<?php
declare(strict_types=1);

$path = __DIR__ . '/lesson.zip';
$zip = new ZipArchive();
if ($zip->open($path, ZipArchive::CREATE | ZipArchive::EXCL) !== true) {
    throw new RuntimeException('Не удалось создать учебный архив');
}
$zip->addFromString('order.txt', 'paid:42');
$zip->setCompressionName('order.txt', ZipArchive::CM_STORE);
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
$deprecated = false;
set_error_handler(function (int $level) use (&$deprecated): bool {
    if ($level !== E_DEPRECATED) return false;
    $deprecated = true;
    return true;
});
try {
$archive = zip_open($path);
if (!is_resource($archive)) throw new RuntimeException('Не открыт ZIP');
$entry = zip_read($archive);
if ($entry === false) throw new RuntimeException('Нет записи');
echo zip_entry_name($entry), "\n";
zip_entry_close($entry);
zip_close($archive);
} finally {
    restore_error_handler();
}
unlink($path);

order.txt

Подготовка создаёт собственный архив. Обработчик перехватывает только E_DEPRECATED и только внутри учебного старого API; остальные ошибки не скрываются.

<?php
declare(strict_types=1);

$path = __DIR__ . '/lesson.zip';
$zip = new ZipArchive();
if ($zip->open($path, ZipArchive::CREATE | ZipArchive::EXCL) !== true) {
    throw new RuntimeException('Не удалось создать учебный архив');
}
$zip->addFromString('order.txt', 'paid:42');
$zip->setCompressionName('order.txt', ZipArchive::CM_STORE);
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
$deprecated = false;
set_error_handler(function (int $level) use (&$deprecated): bool {
    if ($level !== E_DEPRECATED) return false;
    $deprecated = true;
    return true;
});
try {
$archive = zip_open($path);
if (!is_resource($archive)) throw new RuntimeException('Не открыт ZIP');
$entry = zip_read($archive);
if ($entry === false) throw new RuntimeException('Нет записи');
$name = zip_entry_name($entry);
echo $name === "order.txt" ? "Ожидаемый документ\n" : "Не импортировать\n";
zip_entry_close($entry);
zip_close($archive);
} finally {
    restore_error_handler();
}
unlink($path);

Ожидаемый документ

Старые ресурсы не смешиваются с ZipArchive и обычными потоками. После этого разбора переходите к связанной современной карточке.

<?php
declare(strict_types=1);

$path = __DIR__ . '/lesson.zip';
$zip = new ZipArchive();
if ($zip->open($path, ZipArchive::CREATE | ZipArchive::EXCL) !== true) {
    throw new RuntimeException('Не удалось создать учебный архив');
}
$zip->addFromString('order.txt', 'paid:42');
$zip->setCompressionName('order.txt', ZipArchive::CM_STORE);
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
$deprecated = false;
set_error_handler(function (int $level) use (&$deprecated): bool {
    if ($level !== E_DEPRECATED) return false;
    $deprecated = true;
    return true;
});
try {
$archive = zip_open($path);
if (!is_resource($archive)) throw new RuntimeException('Не открыт ZIP');
$entry = zip_read($archive);
if ($entry === false) throw new RuntimeException('Нет записи');
echo zip_entry_filesize($entry), " байтов\n";
zip_entry_close($entry);
zip_close($archive);
} finally {
    restore_error_handler();
}
unlink($path);

7 байтов

Подготовка создаёт собственный архив. Обработчик перехватывает только E_DEPRECATED и только внутри учебного старого API; остальные ошибки не скрываются.

<?php
declare(strict_types=1);

$path = __DIR__ . '/lesson.zip';
$zip = new ZipArchive();
if ($zip->open($path, ZipArchive::CREATE | ZipArchive::EXCL) !== true) {
    throw new RuntimeException('Не удалось создать учебный архив');
}
$zip->addFromString('order.txt', 'paid:42');
$zip->setCompressionName('order.txt', ZipArchive::CM_STORE);
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
$deprecated = false;
set_error_handler(function (int $level) use (&$deprecated): bool {
    if ($level !== E_DEPRECATED) return false;
    $deprecated = true;
    return true;
});
try {
$archive = zip_open($path);
if (!is_resource($archive)) throw new RuntimeException('Не открыт ZIP');
$entry = zip_read($archive);
if ($entry === false) throw new RuntimeException('Нет записи');
$size = zip_entry_filesize($entry);
echo $size !== false && $size <= 1024 ? "Предварительный лимит соблюдён\n" : "Отказ\n";
zip_entry_close($entry);
zip_close($archive);
} finally {
    restore_error_handler();
}
unlink($path);

Предварительный лимит соблюдён

Старые ресурсы не смешиваются с ZipArchive и обычными потоками. После этого разбора переходите к связанной современной карточке.

<?php
declare(strict_types=1);

$path = __DIR__ . '/lesson.zip';
$zip = new ZipArchive();
if ($zip->open($path, ZipArchive::CREATE | ZipArchive::EXCL) !== true) {
    throw new RuntimeException('Не удалось создать учебный архив');
}
$zip->addFromString('order.txt', 'paid:42');
$zip->setCompressionName('order.txt', ZipArchive::CM_STORE);
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
$deprecated = false;
set_error_handler(function (int $level) use (&$deprecated): bool {
    if ($level !== E_DEPRECATED) return false;
    $deprecated = true;
    return true;
});
try {
$archive = zip_open($path);
if (!is_resource($archive)) throw new RuntimeException('Не открыт ZIP');
$entry = zip_read($archive);
if ($entry === false) throw new RuntimeException('Нет записи');
echo zip_entry_compressedsize($entry), " байтов STORE\n";
zip_entry_close($entry);
zip_close($archive);
} finally {
    restore_error_handler();
}
unlink($path);

7 байтов STORE

Подготовка создаёт собственный архив. Обработчик перехватывает только E_DEPRECATED и только внутри учебного старого API; остальные ошибки не скрываются.

<?php
declare(strict_types=1);

$path = __DIR__ . '/lesson.zip';
$zip = new ZipArchive();
if ($zip->open($path, ZipArchive::CREATE | ZipArchive::EXCL) !== true) {
    throw new RuntimeException('Не удалось создать учебный архив');
}
$zip->addFromString('order.txt', 'paid:42');
$zip->setCompressionName('order.txt', ZipArchive::CM_STORE);
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
$deprecated = false;
set_error_handler(function (int $level) use (&$deprecated): bool {
    if ($level !== E_DEPRECATED) return false;
    $deprecated = true;
    return true;
});
try {
$archive = zip_open($path);
if (!is_resource($archive)) throw new RuntimeException('Не открыт ZIP');
$entry = zip_read($archive);
if ($entry === false) throw new RuntimeException('Нет записи');
$packed = zip_entry_compressedsize($entry);
$plain = zip_entry_filesize($entry);
echo $packed === $plain ? "Для STORE размеры совпали\n" : "Размеры различаются\n";
zip_entry_close($entry);
zip_close($archive);
} finally {
    restore_error_handler();
}
unlink($path);

Для STORE размеры совпали

Старые ресурсы не смешиваются с ZipArchive и обычными потоками. После этого разбора переходите к связанной современной карточке.

<?php
declare(strict_types=1);

$path = __DIR__ . '/lesson.zip';
$zip = new ZipArchive();
if ($zip->open($path, ZipArchive::CREATE | ZipArchive::EXCL) !== true) {
    throw new RuntimeException('Не удалось создать учебный архив');
}
$zip->addFromString('order.txt', 'paid:42');
$zip->setCompressionName('order.txt', ZipArchive::CM_STORE);
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
$deprecated = false;
set_error_handler(function (int $level) use (&$deprecated): bool {
    if ($level !== E_DEPRECATED) return false;
    $deprecated = true;
    return true;
});
try {
$archive = zip_open($path);
if (!is_resource($archive)) throw new RuntimeException('Не открыт ZIP');
$entry = zip_read($archive);
if ($entry === false) throw new RuntimeException('Нет записи');
echo zip_entry_compressionmethod($entry), "\n";
zip_entry_close($entry);
zip_close($archive);
} finally {
    restore_error_handler();
}
unlink($path);

stored

Подготовка создаёт собственный архив. Обработчик перехватывает только E_DEPRECATED и только внутри учебного старого API; остальные ошибки не скрываются.

<?php
declare(strict_types=1);

$path = __DIR__ . '/lesson.zip';
$zip = new ZipArchive();
if ($zip->open($path, ZipArchive::CREATE | ZipArchive::EXCL) !== true) {
    throw new RuntimeException('Не удалось создать учебный архив');
}
$zip->addFromString('order.txt', 'paid:42');
$zip->setCompressionName('order.txt', ZipArchive::CM_STORE);
if (!$zip->close()) {
    throw new RuntimeException('Архив не сохранён');
}
$deprecated = false;
set_error_handler(function (int $level) use (&$deprecated): bool {
    if ($level !== E_DEPRECATED) return false;
    $deprecated = true;
    return true;
});
try {
$archive = zip_open($path);
if (!is_resource($archive)) throw new RuntimeException('Не открыт ZIP');
$entry = zip_read($archive);
if ($entry === false) throw new RuntimeException('Нет записи');
$method = zip_entry_compressionmethod($entry);
echo $method === "stored" ? "Байты не сжимались\n" : "Другой или неизвестный метод\n";
zip_entry_close($entry);
zip_close($archive);
} finally {
    restore_error_handler();
}
unlink($path);

Байты не сжимались

Старые ресурсы не смешиваются с ZipArchive и обычными потоками. После этого разбора переходите к связанной современной карточке.