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

<?php
declare(strict_types=1);

$report = "order=42;status=ready";
$packed = gzcompress($report);
if ($packed === false) { throw new RuntimeException('Compression failed'); }
$restored = gzuncompress($packed);
var_dump($restored === $report);
echo $restored, "\n";

bool(true)
order=42;status=ready

Проверяем точные восстановленные данные, а не жёсткий hex сжатого потока: бинарное оформление может зависеть от версии библиотеки, режима и ОС.

<?php
declare(strict_types=1);

$report = str_repeat("order=42;status=ready\n", 100);
$packed = gzcompress($report, 6);
if ($packed === false) { throw new RuntimeException('Compression failed'); }
var_dump(strlen($packed) < strlen($report));
var_dump(gzuncompress($packed) === $report);

bool(true)
bool(true)

В этой fixture много повторов, поэтому уменьшение заметно. Для уже сжатого изображения/случайного токена эффект будет другим. Сравнение размера не измеряет время CPU.

<?php
declare(strict_types=1);

try { gzcompress('report', 10); }
catch (ValueError $error) { echo "Invalid level\n"; }
try { gzcompress('report', -1, 999); }
catch (ValueError $error) { echo "Invalid format\n"; }

Invalid level
Invalid format

Это ошибки конфигурации разработчика. Получатель должен знать формат заранее; смена третьего аргумента требует изменить парный декодер.

<?php
declare(strict_types=1);

$report = "order=42;status=ready";
$packed = gzencode($report);
if ($packed === false) { throw new RuntimeException('Compression failed'); }
$restored = gzdecode($packed);
var_dump($restored === $report);
echo $restored, "\n";

bool(true)
order=42;status=ready

Проверяем точные восстановленные данные, а не жёсткий hex сжатого потока: бинарное оформление может зависеть от версии библиотеки, режима и ОС.

<?php
declare(strict_types=1);

$report = str_repeat("order=42;status=ready\n", 100);
$packed = gzencode($report, 6);
if ($packed === false) { throw new RuntimeException('Compression failed'); }
var_dump(strlen($packed) < strlen($report));
var_dump(gzdecode($packed) === $report);

bool(true)
bool(true)

В этой fixture много повторов, поэтому уменьшение заметно. Для уже сжатого изображения/случайного токена эффект будет другим. Сравнение размера не измеряет время CPU.

<?php
declare(strict_types=1);

try { gzencode('report', 10); }
catch (ValueError $error) { echo "Invalid level\n"; }
try { gzencode('report', -1, 999); }
catch (ValueError $error) { echo "Invalid format\n"; }

Invalid level
Invalid format

Это ошибки конфигурации разработчика. Получатель должен знать формат заранее; смена третьего аргумента требует изменить парный декодер.

<?php
declare(strict_types=1);

$report = "order=42;status=ready";
$packed = gzdeflate($report);
if ($packed === false) { throw new RuntimeException('Compression failed'); }
$restored = gzinflate($packed);
var_dump($restored === $report);
echo $restored, "\n";

bool(true)
order=42;status=ready

Проверяем точные восстановленные данные, а не жёсткий hex сжатого потока: бинарное оформление может зависеть от версии библиотеки, режима и ОС.

<?php
declare(strict_types=1);

$report = str_repeat("order=42;status=ready\n", 100);
$packed = gzdeflate($report, 6);
if ($packed === false) { throw new RuntimeException('Compression failed'); }
var_dump(strlen($packed) < strlen($report));
var_dump(gzinflate($packed) === $report);

bool(true)
bool(true)

В этой fixture много повторов, поэтому уменьшение заметно. Для уже сжатого изображения/случайного токена эффект будет другим. Сравнение размера не измеряет время CPU.

<?php
declare(strict_types=1);

try { gzdeflate('report', 10); }
catch (ValueError $error) { echo "Invalid level\n"; }
try { gzdeflate('report', -1, 999); }
catch (ValueError $error) { echo "Invalid format\n"; }

Invalid level
Invalid format

Это ошибки конфигурации разработчика. Получатель должен знать формат заранее; смена третьего аргумента требует изменить парный декодер.

<?php
declare(strict_types=1);

$packed = gzcompress('ready');
echo gzuncompress($packed), "\n";
$empty = gzuncompress(gzcompress(''));
var_dump($empty, $empty === false);

ready
string(0) ""
bool(false)

Обычная проверка if (!$empty) смешала бы пустой успех с false. После распаковки JSON/CSV ещё требует собственного разбора и проверки.

<?php
declare(strict_types=1);

$warnings = 0;
set_error_handler(function (int $level, string $message) use (&$warnings): bool {
    if ($level !== E_WARNING) { return false; }
    $warnings++;
    return true;
});
try { $decoded = gzuncompress('not a compressed stream'); }
finally { restore_error_handler(); }
var_dump($decoded);
echo $warnings, "\n";

bool(false)
1

Анонимный обработчик считает ожидаемое E_WARNING этой fixture и возвращает прежний обработчик в finally. В приложении фиксируют причину отказа, не гасят все предупреждения оператором @.

<?php
declare(strict_types=1);

$limit = 47;
$packed = gzcompress(str_repeat('A', 48));
$decoded = gzuncompress($packed, $limit);
if ($decoded === false || strlen($decoded) > $limit) {
    echo "Payload rejected\n";
} else {
    echo "Payload accepted\n";
}

Payload rejected

В проверенном PHP8.5.11 декодер здесь возвращает 48 байт при max_length=47. Поэтому последняя проверка обязательна для точного договора. На другой версии декодер может раньше отказать; это также отказ входа. Для жёсткого бюджета памяти нужен ограниченный изолированный процесс/подходящий потоковый API.

<?php
declare(strict_types=1);

$packed = gzencode('ready');
echo gzdecode($packed), "\n";
$empty = gzdecode(gzencode(''));
var_dump($empty, $empty === false);

ready
string(0) ""
bool(false)

Обычная проверка if (!$empty) смешала бы пустой успех с false. После распаковки JSON/CSV ещё требует собственного разбора и проверки.

<?php
declare(strict_types=1);

$warnings = 0;
set_error_handler(function (int $level, string $message) use (&$warnings): bool {
    if ($level !== E_WARNING) { return false; }
    $warnings++;
    return true;
});
try { $decoded = gzdecode('not a compressed stream'); }
finally { restore_error_handler(); }
var_dump($decoded);
echo $warnings, "\n";

bool(false)
1

Анонимный обработчик считает ожидаемое E_WARNING этой fixture и возвращает прежний обработчик в finally. В приложении фиксируют причину отказа, не гасят все предупреждения оператором @.

<?php
declare(strict_types=1);

$limit = 47;
$packed = gzencode(str_repeat('A', 48));
$decoded = gzdecode($packed, $limit);
if ($decoded === false || strlen($decoded) > $limit) {
    echo "Payload rejected\n";
} else {
    echo "Payload accepted\n";
}

Payload rejected

В проверенном PHP8.5.11 декодер здесь возвращает 48 байт при max_length=47. Поэтому последняя проверка обязательна для точного договора. На другой версии декодер может раньше отказать; это также отказ входа. Для жёсткого бюджета памяти нужен ограниченный изолированный процесс/подходящий потоковый API.

<?php
declare(strict_types=1);

$packed = gzdeflate('ready');
echo gzinflate($packed), "\n";
$empty = gzinflate(gzdeflate(''));
var_dump($empty, $empty === false);

ready
string(0) ""
bool(false)

Обычная проверка if (!$empty) смешала бы пустой успех с false. После распаковки JSON/CSV ещё требует собственного разбора и проверки.

<?php
declare(strict_types=1);

$warnings = 0;
set_error_handler(function (int $level, string $message) use (&$warnings): bool {
    if ($level !== E_WARNING) { return false; }
    $warnings++;
    return true;
});
try { $decoded = gzinflate('not a compressed stream'); }
finally { restore_error_handler(); }
var_dump($decoded);
echo $warnings, "\n";

bool(false)
1

Анонимный обработчик считает ожидаемое E_WARNING этой fixture и возвращает прежний обработчик в finally. В приложении фиксируют причину отказа, не гасят все предупреждения оператором @.

<?php
declare(strict_types=1);

$limit = 47;
$packed = gzdeflate(str_repeat('A', 48));
$decoded = gzinflate($packed, $limit);
if ($decoded === false || strlen($decoded) > $limit) {
    echo "Payload rejected\n";
} else {
    echo "Payload accepted\n";
}

Payload rejected

В проверенном PHP8.5.11 декодер здесь возвращает 48 байт при max_length=47. Поэтому последняя проверка обязательна для точного договора. На другой версии декодер может раньше отказать; это также отказ входа. Для жёсткого бюджета памяти нужен ограниченный изолированный процесс/подходящий потоковый API.

<?php
declare(strict_types=1);

$packed = zlib_encode('report-ready', ZLIB_ENCODING_GZIP, 6);
if ($packed === false) { throw new RuntimeException('Compression failed'); }
echo gzdecode($packed), "\n";

report-ready

При таком вызове результат имеет gzip-формат независимо от нейтрального имени функции.

<?php
declare(strict_types=1);

$formats = [ZLIB_ENCODING_RAW, ZLIB_ENCODING_DEFLATE, ZLIB_ENCODING_GZIP];
foreach ($formats as $format) {
    $packed = zlib_encode('same bytes', $format);
    if ($packed === false) { throw new RuntimeException('Compression failed'); }
    var_dump(zlib_decode($packed) === 'same bytes');
}

bool(true)
bool(true)
bool(true)

Общий декодер умеет распознавать эти варианты; для строгого endpoint лучше хранить/проверять заранее согласованный формат. ZIP сюда не входит.

<?php
declare(strict_types=1);

$inputs = [gzencode('gzip'), gzcompress('zlib'), gzdeflate('raw')];
foreach ($inputs as $packed) { echo zlib_decode($packed), "\n"; }

gzip
zlib
raw

Здесь входные формы созданы в самом примере. Присутствие raw среди разрешённых форматов означает отсутствие встроенной в оболочку контрольной суммы.

<?php
declare(strict_types=1);

$warnings = 0;
set_error_handler(function (int $level, string $message) use (&$warnings): bool {
    if ($level !== E_WARNING) { return false; }
    $warnings++;
    return true;
});
try { $decoded = zlib_decode('plain text'); }
finally { restore_error_handler(); }
var_dump($decoded);
echo $warnings, "\n";

bool(false)
1

Нет fallback «вернём исходный текст и считаем импорт успешным»: такой режим должен быть отдельно предусмотрен форматом входа.

<?php
declare(strict_types=1);

$limit = 47;
$decoded = zlib_decode(gzencode(str_repeat('A', 48)), $limit);
var_dump($decoded === false || strlen($decoded) > $limit);

bool(true)

Проверяется именно непригодность для лимита, а не обещание конкретного внутреннего буфера. Для нескольких склеенных gzip members используйте явную обработку границ: одно успешное распаковывание не гарантирует потребление всех переданных байтов.

<?php
declare(strict_types=1);

$context = deflate_init(ZLIB_ENCODING_GZIP);
if ($context === false) { throw new RuntimeException('Context unavailable'); }
$packed = deflate_add($context, 'report', ZLIB_FINISH);
if ($packed === false) { throw new RuntimeException('Compression failed'); }
echo gzdecode($packed), "\n";
var_dump($context instanceof DeflateContext);

report
bool(true)

instanceof проверяет тип непрозрачного объекта. Пользователь не заполняет его поля вручную: состояние управляется функциями zlib.

<?php
declare(strict_types=1);

try { deflate_init(ZLIB_ENCODING_GZIP, ['level' => 10]); }
catch (ValueError $error) { echo "Bad level\n"; }
try { deflate_init(ZLIB_ENCODING_GZIP, ['window' => 7]); }
catch (ValueError $error) { echo "Bad window\n"; }

Bad level
Bad window

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

<?php
declare(strict_types=1);

$dictionary = 'order status customer delivery';
$encoder = deflate_init(ZLIB_ENCODING_DEFLATE, ['dictionary' => $dictionary]);
$decoder = inflate_init(ZLIB_ENCODING_DEFLATE, ['dictionary' => $dictionary]);
if ($encoder === false || $decoder === false) { throw new RuntimeException('Context unavailable'); }
$packed = deflate_add($encoder, 'order status ready', ZLIB_FINISH);
if ($packed === false) { throw new RuntimeException('Compression failed'); }
echo inflate_add($decoder, $packed, ZLIB_FINISH), "\n";

order status ready

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

<?php
declare(strict_types=1);

$encoder = deflate_init(ZLIB_ENCODING_DEFLATE, ['dictionary' => ['order', 'status']]);
$decoder = inflate_init(ZLIB_ENCODING_DEFLATE, ['dictionary' => "order\0status\0"]);
if ($encoder === false || $decoder === false) { throw new RuntimeException('Context unavailable'); }
$packed = deflate_add($encoder, 'order status', ZLIB_FINISH);
if ($packed === false) { throw new RuntimeException('Compression failed'); }
echo inflate_add($decoder, $packed, ZLIB_FINISH), "\n";
var_dump(inflate_get_status($decoder) === ZLIB_STREAM_END);

order status
bool(true)

Компрессор получил массив, декомпрессор — эквивалентную строку с двумя нулевыми байтами. Подстановка пробелов дала бы другой словарь и отказ.

<?php
declare(strict_types=1);

$context = deflate_init(ZLIB_ENCODING_GZIP);
if ($context === false) { throw new RuntimeException('Context unavailable'); }
$packed = '';
foreach (["one\n", "two\n"] as $part) {
    $chunk = deflate_add($context, $part, ZLIB_NO_FLUSH);
    if ($chunk === false) { throw new RuntimeException('Compression failed'); }
    $packed .= $chunk;
}
$last = deflate_add($context, '', ZLIB_FINISH);
if ($last === false) { throw new RuntimeException('Finish failed'); }
$packed .= $last;
echo gzdecode($packed);

one
two

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

<?php
declare(strict_types=1);

$context = deflate_init(ZLIB_ENCODING_RAW);
if ($context === false) { throw new RuntimeException('Context unavailable'); }
$chunk = deflate_add($context, '', ZLIB_NO_FLUSH);
var_dump($chunk, $chunk === false);
$last = deflate_add($context, '', ZLIB_FINISH);
var_dump(is_string($last), gzinflate($last) === '');

string(0) ""
bool(false)
bool(true)
bool(true)

Пустой вход без FINISH ничего не выдаёт. FINISH даже для пустого сообщения формирует корректный завершённый поток.

<?php
declare(strict_types=1);

$context = deflate_init(ZLIB_ENCODING_GZIP);
if ($context === false) { throw new RuntimeException('Context unavailable'); }
$first = deflate_add($context, 'first', ZLIB_FINISH);
$second = deflate_add($context, 'second', ZLIB_FINISH);
echo gzdecode($first), "\n", gzdecode($second), "\n";

first
second

Это проверенное поведение PHP8.5.11. Для ясной архитектуры независимым документам можно создавать отдельные контексты; получатель двух склеенных members должен явно поддерживать такой контейнер.

<?php
declare(strict_types=1);

$context = inflate_init(ZLIB_ENCODING_GZIP);
if ($context === false) { throw new RuntimeException('Context unavailable'); }
$decoded = inflate_add($context, gzencode('catalog'), ZLIB_FINISH);
echo $decoded, "\n";
var_dump(inflate_get_status($context) === ZLIB_STREAM_END);

catalog
bool(true)

FINISH сам по себе не сертификат завершённости входа: проверка статуса подтверждает достигнутый конец потока.

<?php
declare(strict_types=1);

try { inflate_init(ZLIB_ENCODING_GZIP, ['window' => 16]); }
catch (ValueError $error) { echo "Bad window\n"; }
$context = inflate_init(ZLIB_ENCODING_GZIP, ['level' => 999]);
var_dump($context instanceof InflateContext);

Bad window
bool(true)

Второй вызов намеренно демонстрирует игнорируемый level в PHP8.5.11. Это не рекомендация передавать 999: рабочий код вообще не включает неиспользуемые настройки.

<?php
declare(strict_types=1);

$encoder = deflate_init(ZLIB_ENCODING_DEFLATE, ['dictionary' => 'order status customer']);
if ($encoder === false) { throw new RuntimeException('Encoder unavailable'); }
$packed = deflate_add($encoder, 'order status ready', ZLIB_FINISH);
$decoder = inflate_init(ZLIB_ENCODING_DEFLATE);
if ($decoder === false) { throw new RuntimeException('Decoder unavailable'); }
$warnings = 0;
set_error_handler(function (int $level, string $message) use (&$warnings): bool {
    if ($level !== E_WARNING) { return false; }
    $warnings++;
    return true;
});
try { $decoded = inflate_add($decoder, $packed, ZLIB_FINISH); }
finally { restore_error_handler(); }
var_dump($decoded, inflate_get_status($decoder) === ZLIB_NEED_DICT);
echo $warnings, "\n";

bool(false)
bool(true)
1

Обработчик считает ожидаемое предупреждение этой fixture. Правильный путь — передать согласованный dictionary при создании нового декодера; угадывание словаря не часть обычного импорта.

<?php
declare(strict_types=1);

foreach ([[''], ["bad\0entry"]] as $dictionary) {
    try { inflate_init(ZLIB_ENCODING_DEFLATE, ['dictionary' => $dictionary]); }
    catch (ValueError $error) { echo "bad element\n"; }
}
try { inflate_init(ZLIB_ENCODING_DEFLATE, ['dictionary' => new stdClass()]); }
catch (TypeError $error) { echo "bad type\n"; }

bad element
bad element
bad type

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

<?php
declare(strict_types=1);

$packed = gzencode("one\ntwo\n");
$context = inflate_init(ZLIB_ENCODING_GZIP);
if ($context === false) { throw new RuntimeException('Context unavailable'); }
$decoded = '';
foreach (str_split($packed, 5) as $part) {
    $chunk = inflate_add($context, $part, ZLIB_SYNC_FLUSH);
    if ($chunk === false) { throw new RuntimeException('Bad compressed data'); }
    $decoded .= $chunk;
    if (strlen($decoded) > 1000) { throw new RuntimeException('Output limit'); }
}
if (inflate_get_status($context) !== ZLIB_STREAM_END) { throw new RuntimeException('Incomplete stream'); }
echo $decoded;

one
two

Здесь str_split делит fixture, а не читает сеть. При настоящем импорте выдаваемые chunks передают дальше, считая общий объём. Проверка после вызова не ограничивает пиковое выделение памяти внутри этого вызова.

<?php
declare(strict_types=1);

$packed = substr(gzencode('order-ready'), 0, -4);
$context = inflate_init(ZLIB_ENCODING_GZIP);
if ($context === false) { throw new RuntimeException('Context unavailable'); }
$decoded = inflate_add($context, $packed, ZLIB_FINISH);
var_dump(is_string($decoded));
var_dump(inflate_get_status($context) === ZLIB_STREAM_END);

bool(true)
bool(false)

Убрана часть завершающих данных gzip. Некоторые полезные байты уже распакованы, но полного проверенного сообщения нет. Сохранять заказ по такому промежуточному результату нельзя.

<?php
declare(strict_types=1);

$context = inflate_init(ZLIB_ENCODING_GZIP);
if ($context === false) { throw new RuntimeException('Context unavailable'); }
var_dump(inflate_get_status($context) === ZLIB_OK);
inflate_add($context, gzencode('ready'), ZLIB_FINISH);
var_dump(inflate_get_status($context) === ZLIB_STREAM_END);

bool(true)
bool(true)

Начальное OK не означает, что вообще поступили какие-то данные. Конец получен после полного gzip.

<?php
declare(strict_types=1);

$context = inflate_init(ZLIB_ENCODING_GZIP);
if ($context === false) { throw new RuntimeException('Context unavailable'); }
$packed = substr(gzencode('ready'), 0, 8);
inflate_add($context, $packed, ZLIB_FINISH);
echo inflate_get_status($context) === ZLIB_STREAM_END ? "Complete\n" : "Incomplete\n";

Incomplete

Это короткий неполный заголовок. Не нужно угадывать конкретный status для каждого разреза входа, если ваша обязательная постусловие — достигнутый конец.

<?php
declare(strict_types=1);

$packed = gzencode('ready');
$context = inflate_init(ZLIB_ENCODING_GZIP);
if ($context === false) { throw new RuntimeException('Context unavailable'); }
inflate_add($context, $packed, ZLIB_FINISH);
var_dump(inflate_get_read_len($context) === strlen($packed));

bool(true)

Не сравниваем значение с длиной слова ready: счётчик учитывает сжатую оболочку, а не только полезный текст.

<?php
declare(strict_types=1);

$first = gzencode('one');
$second = gzencode('two');
$buffer = $first . $second;
$context = inflate_init(ZLIB_ENCODING_GZIP);
if ($context === false) { throw new RuntimeException('Context unavailable'); }
echo inflate_add($context, $buffer, ZLIB_FINISH), "\n";
if (inflate_get_status($context) !== ZLIB_STREAM_END) { throw new RuntimeException('First member incomplete'); }
$consumed = inflate_get_read_len($context);
var_dump($consumed === strlen($first));
$tail = substr($buffer, $consumed);
echo inflate_add($context, $tail, ZLIB_FINISH), "\n";
var_dump(inflate_get_status($context) === ZLIB_STREAM_END);

one
bool(true)
two
bool(true)

Для общего цикла проверяют, что consumed продвигается, ограничивают количество members и суммарный выход. Здесь ровно два известных member. Один gzdecode от склеенного buffer не стоит считать проверкой обоих.

<?php
declare(strict_types=1);

$path = __DIR__ . '/report.gz';
file_put_contents($path, gzencode("A1\nB2\n"));
$stream = gzopen($path, 'rb');
if ($stream === false) { throw new RuntimeException('Open failed'); }
try {
    echo gzread($stream, 2), "
";
} finally { gzclose($stream); }

A1

Создание fixture через gzencode нужно только для самостоятельного запуска. В проекте report.gz, например, уже получен от поставщика.

<?php
declare(strict_types=1);

$path = __DIR__ . '/export.gz';
$stream = gzopen($path, 'wb6');
if ($stream === false) { throw new RuntimeException('Open failed'); }
try {
    $text = "order=25\n";
    if (gzwrite($stream, $text) !== strlen($text)) { throw new RuntimeException('Write failed'); }
} finally { gzclose($stream); }
echo gzdecode(file_get_contents($path));

order=25

Файл wb обнуляется при открытии. Для замены важной выгрузки пишут во временный файл и выполняют согласованную публикацию, не портят старый файл до готовности нового.

<?php
declare(strict_types=1);

$path = __DIR__ . '/plain.txt';
file_put_contents($path, 'not compressed');
$stream = gzopen($path, 'rb');
if ($stream === false) { throw new RuntimeException('Open failed'); }
try { echo gzread($stream, 100), "\n"; }
finally { gzclose($stream); }

not compressed

gzopen читает и обычный файл. Если вход обязан быть завершённым gzip-потоком, нужен отдельный договор и проверка декодером, а не только расширение .gz.

<?php
declare(strict_types=1);

$path = __DIR__ . '/report.gz';
file_put_contents($path, gzencode("A1\nB2\n"));
$stream = gzopen($path, 'rb');
if ($stream === false) { throw new RuntimeException('Open failed'); }
var_dump(is_resource($stream));
var_dump(gzclose($stream));
var_dump(is_resource($stream));

bool(true)
bool(true)
bool(false)

После закрытия переменная ещё существует, но действующего ресурса уже нет.

<?php
declare(strict_types=1);

$path = __DIR__ . '/status.gz';
$stream = gzopen($path, 'wb');
if ($stream === false) { throw new RuntimeException('Open failed'); }
$written = false;
try { $written = gzwrite($stream, 'READY'); }
finally { $closed = gzclose($stream); }
if ($written !== 5 || !$closed) { throw new RuntimeException('Export failed'); }
echo gzdecode(file_get_contents($path)), "\n";

READY

Успешное закрытие не заменяет fsync, транзакцию публикации и проверку целостности у получателя. Ошибку записи не скрывают успешным close.

<?php
declare(strict_types=1);

$path = __DIR__ . '/ready.gz';
$stream = gzopen($path, 'wb');
if ($stream === false) { throw new RuntimeException('Open failed'); }
try { var_dump(gzwrite($stream, 'READY')); }
finally { gzclose($stream); }
echo gzdecode(file_get_contents($path)), "
";

int(5)
READY

Число5 относится к READY. Размер полученного gzip-файла иной; маленькая строка из-за служебных полей может даже увеличиться.

<?php
declare(strict_types=1);

$path = __DIR__ . '/part.gz';
$stream = gzopen($path, 'wb');
if ($stream === false) { throw new RuntimeException('Open failed'); }
try { var_dump(gzwrite($stream, 'ABCDEF', 3)); }
finally { gzclose($stream); }
echo gzdecode(file_get_contents($path)), "
";

int(3)
ABC

length считает байты, не символы Unicode; обрезанный посередине русский символ уже не будет корректным UTF-8.

<?php
declare(strict_types=1);

$stream = gzopen(__DIR__ . '/rows.gz', 'wb');
if ($stream === false) { throw new RuntimeException('Open failed'); }
$data = "A1
B2
";
try {
    $offset = 0;
    while ($offset < strlen($data)) {
        $count = gzwrite($stream, substr($data, $offset));
        if ($count === false || $count === 0) { throw new RuntimeException('No progress'); }
        $offset += $count;
    }
    echo $offset, "
";
} finally { gzclose($stream); }

6

В демонстрации маленький буфер, поэтому копия substr допустима. Для больших экспортов формируют ограниченные куски, контролируют время/ошибки и проверяют закрытие. Повторять весь data после короткой записи нельзя: получится дубликат.

<?php
declare(strict_types=1);

$path = __DIR__ . '/ready.gz';
$stream = gzopen($path, 'wb');
if ($stream === false) { throw new RuntimeException('Open failed'); }
try { var_dump(gzputs($stream, 'READY')); }
finally { gzclose($stream); }
echo gzdecode(file_get_contents($path)), "
";

int(5)
READY

Число5 относится к READY. Размер полученного gzip-файла иной; маленькая строка из-за служебных полей может даже увеличиться.

<?php
declare(strict_types=1);

$path = __DIR__ . '/part.gz';
$stream = gzopen($path, 'wb');
if ($stream === false) { throw new RuntimeException('Open failed'); }
try { var_dump(gzputs($stream, 'ABCDEF', 3)); }
finally { gzclose($stream); }
echo gzdecode(file_get_contents($path)), "
";

int(3)
ABC

length считает байты, не символы Unicode; обрезанный посередине русский символ уже не будет корректным UTF-8.

<?php
declare(strict_types=1);

$stream = gzopen(__DIR__ . '/rows.gz', 'wb');
if ($stream === false) { throw new RuntimeException('Open failed'); }
$data = "A1
B2
";
try {
    $offset = 0;
    while ($offset < strlen($data)) {
        $count = gzputs($stream, substr($data, $offset));
        if ($count === false || $count === 0) { throw new RuntimeException('No progress'); }
        $offset += $count;
    }
    echo $offset, "
";
} finally { gzclose($stream); }

6

В демонстрации маленький буфер, поэтому копия substr допустима. Для больших экспортов формируют ограниченные куски, контролируют время/ошибки и проверяют закрытие. Повторять весь data после короткой записи нельзя: получится дубликат.

<?php
declare(strict_types=1);

$path = __DIR__ . '/report.gz';
file_put_contents($path, gzencode("A1\nB2\n"));
$stream = gzopen($path, 'rb');
if ($stream === false) { throw new RuntimeException('Open failed'); }
try {
    echo gzread($stream, 2), "|", gzread($stream, 4);
} finally { gzclose($stream); }

A1|
B2

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

<?php
declare(strict_types=1);

$path = __DIR__ . '/report.gz';
file_put_contents($path, gzencode("A1\nB2\n"));
$stream = gzopen($path, 'rb');
if ($stream === false) { throw new RuntimeException('Open failed'); }
try {
    $total = 0;
    while (!gzeof($stream)) {
        $part = gzread($stream, 2);
        if ($part === false) { throw new RuntimeException('Read failed'); }
        if ($part === '' && !gzeof($stream)) { throw new RuntimeException('No progress'); }
        $total += strlen($part);
        if ($total > 1024) { throw new RuntimeException('Export too large'); }
        echo $part;
    }
    echo 'bytes=', $total, "
";
} finally { gzclose($stream); }

A1
B2
bytes=6

Лимит проверяется до дальнейшей обработки очередной порции. Сам gzip-файл и время распаковки также ограничивают; декодер может использовать внутреннюю память. Для недоверенного файла проверяют завершённость формата отдельно.

<?php
declare(strict_types=1);

$path = __DIR__ . '/report.gz';
file_put_contents($path, gzencode("A1\nB2\n"));
$stream = gzopen($path, 'rb');
if ($stream === false) { throw new RuntimeException('Open failed'); }
try {
    echo gzgets($stream);
    echo gzgets($stream);
    var_dump(gzgets($stream));
} finally { gzclose($stream); }

A1
B2
bool(false)

false на EOF отличается от успешной строки "0". Проверяйте строгое сравнение.

<?php
declare(strict_types=1);

$path = __DIR__ . '/report.gz';
file_put_contents($path, gzencode("A1\nB2\n"));
$stream = gzopen($path, 'rb');
if ($stream === false) { throw new RuntimeException('Open failed'); }
try {
    echo json_encode(gzgets($stream, 2)), "
";
    echo json_encode(gzgets($stream)), "
";
} finally { gzclose($stream); }

"A"
"1\n"

length2 разрешил только один байт. При разборе NDJSON/CSV нельзя отправлять такой кусок в парсер как готовую строку; собирайте запись до разделителя с собственным пределом размера.

<?php
declare(strict_types=1);

$path = __DIR__ . '/report.gz';
file_put_contents($path, gzencode("A1\nB2\n"));
$stream = gzopen($path, 'rb');
if ($stream === false) { throw new RuntimeException('Open failed'); }
try {
    $count = 0;
    while (($line = gzgets($stream, 128)) !== false) {
        $count++;
        echo $count, ':', rtrim($line, "

"), "
";
    }
    if (!gzeof($stream)) { throw new RuntimeException('Read failed'); }
} finally { gzclose($stream); }

1:A1
2:B2

Здесь fixture гарантирует строки короче127байт. В реальной загрузке длинную строку нужно явно отклонять или собирать; gzeof само по себе не доказывает целостность gzip.

<?php
declare(strict_types=1);

$path = __DIR__ . '/report.gz';
file_put_contents($path, gzencode("A1\nB2\n"));
$stream = gzopen($path, 'rb');
if ($stream === false) { throw new RuntimeException('Open failed'); }
try { echo gzgetc($stream), '|', gzgetc($stream), "
"; }
finally { gzclose($stream); }

A|1

Для обычного чтения больших файлов вызов на каждый байт неоправданно дорог: используйте gzread.

<?php
declare(strict_types=1);

$path = __DIR__ . '/letter.gz';
file_put_contents($path, gzencode('Я'));
$stream = gzopen($path, 'rb');
if ($stream === false) { throw new RuntimeException('Open failed'); }
try {
    echo bin2hex(gzgetc($stream)), "\n";
    echo bin2hex(gzgetc($stream)), "\n";
    var_dump(gzgetc($stream));
} finally { gzclose($stream); }

d0
af
bool(false)

Я в UTF-8 состоит из D0 AF. Для обработки символов сначала соберите корректную текстовую строку и выберите mbstring или другой подходящий Unicode-инструмент.

<?php
declare(strict_types=1);

$path = __DIR__ . '/report.gz';
file_put_contents($path, gzencode("A1\nB2\n"));
$stream = gzopen($path, 'rb');
if ($stream === false) { throw new RuntimeException('Open failed'); }
try {
    var_dump(gzeof($stream));
    gzread($stream, 100);
    gzread($stream, 1);
    var_dump(gzeof($stream));
} finally { gzclose($stream); }

bool(false)
bool(true)

Отдельное чтение после конца делает демонстрацию очевидной; момент установки EOF у разных потоков не одинаков.

<?php
declare(strict_types=1);

$path = __DIR__ . '/zero.gz';
file_put_contents($path, gzencode('0'));
$stream = gzopen($path, 'rb');
if ($stream === false) { throw new RuntimeException('Open failed'); }
try {
    while (!gzeof($stream)) {
        $part = gzread($stream, 32);
        if ($part === false) { throw new RuntimeException('Read failed'); }
        if ($part === '') { break; }
        echo $part, "\n";
    }
} finally { gzclose($stream); }

0

Условие if (!$part) ошибочно приняло бы строку0 за ложь. При более общих потоках пустое чтение без EOF требует отдельной стратегии ожидания/ошибки.

<?php
declare(strict_types=1);

$path = __DIR__ . '/report.gz';
file_put_contents($path, gzencode("A1\nB2\n"));
$lines = gzfile($path);
if ($lines === false) { throw new RuntimeException('Read failed'); }
echo count($lines), "
", $lines[0];

2
A1

Индекс0 — первая строка. Для большого журнала выбирайте gzgets/gzread и обработку по частям.

<?php
declare(strict_types=1);

$path = __DIR__ . '/rows.gz';
file_put_contents($path, gzencode("A1\n\n0\n"));
$lines = gzfile($path);
if ($lines === false) { throw new RuntimeException('Read failed'); }
foreach ($lines as $line) {
    $value = rtrim($line, "\r\n");
    if ($value === '') { continue; }
    echo '[', $value, "]\n";
}

[A1]
[0]

Пропускаем только пустую строку, сохраняя0. rtrim с явными не удаляет значимые пробелы поля.

<?php
declare(strict_types=1);

$path = __DIR__ . '/report.gz';
file_put_contents($path, gzencode("A1\nB2\n"));
$stream = gzopen($path, 'rb');
if ($stream === false) { throw new RuntimeException('Open failed'); }
try {
    var_dump(gzseek($stream, 3, SEEK_SET));
    echo gzgets($stream);
} finally { gzclose($stream); }

int(0)
B2

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

<?php
declare(strict_types=1);

$path = __DIR__ . '/gap.gz';
$stream = gzopen($path, 'wb');
if ($stream === false) { throw new RuntimeException('Open failed'); }
try {
    gzwrite($stream, 'A');
    if (gzseek($stream, 3) !== 0) { throw new RuntimeException('Seek failed'); }
    gzwrite($stream, 'B');
} finally { gzclose($stream); }
echo bin2hex(gzdecode(file_get_contents($path))), "\n";

41000042

Два нулевых байта — не пробелы и не удалённый участок. Такой приём обычно не нужен для текстового отчёта.

<?php
declare(strict_types=1);

$path = __DIR__ . '/report.gz';
file_put_contents($path, gzencode("A1\nB2\n"));
$stream = gzopen($path, 'rb');
if ($stream === false) { throw new RuntimeException('Open failed'); }
try {
    var_dump(gztell($stream));
    gzread($stream, 2);
    var_dump(gztell($stream));
} finally { gzclose($stream); }

int(0)
int(2)

Позиция0 не ошибка. Сравнение === false сохраняет это различие.

<?php
declare(strict_types=1);

$path = __DIR__ . '/report.gz';
file_put_contents($path, gzencode("A1\nB2\n"));
$stream = gzopen($path, 'rb');
if ($stream === false) { throw new RuntimeException('Open failed'); }
try {
    gzgets($stream);
    $bookmark = gztell($stream);
    if ($bookmark === false) { throw new RuntimeException('Position unavailable'); }
    echo gzgets($stream);
    if (gzseek($stream, $bookmark) !== 0) { throw new RuntimeException('Seek failed'); }
    echo gzgets($stream);
} finally { gzclose($stream); }

B2
B2

Закладка относится к неизменившемуся исходному содержимому. Возврат назад в gzip может повторно распаковать значительную часть файла.

<?php
declare(strict_types=1);

$path = __DIR__ . '/report.gz';
file_put_contents($path, gzencode("A1\nB2\n"));
$stream = gzopen($path, 'rb');
if ($stream === false) { throw new RuntimeException('Open failed'); }
try {
    echo gzgets($stream);
    if (!gzrewind($stream)) { throw new RuntimeException('Rewind failed'); }
    echo gzgets($stream);
} finally { gzclose($stream); }

A1
A1

Старые данные не дописываются и не копируются: меняется состояние чтения.

<?php
declare(strict_types=1);

$path = __DIR__ . '/report.gz';
file_put_contents($path, gzencode("A1\nB2\n"));
$stream = gzopen($path, 'rb');
if ($stream === false) { throw new RuntimeException('Open failed'); }
try {
    foreach ([1, 2] as $pass) {
        if (!gzrewind($stream)) { throw new RuntimeException('Rewind failed'); }
        $count = 0;
        while (gzgets($stream) !== false) { $count++; }
        echo 'pass', $pass, '=', $count, "
";
    }
} finally { gzclose($stream); }

pass1=2
pass2=2

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

<?php
declare(strict_types=1);

$path = __DIR__ . '/report.gz';
file_put_contents($path, gzencode("A1\nB2\n"));
$stream = gzopen($path, 'rb');
if ($stream === false) { throw new RuntimeException('Open failed'); }
try {
    gzread($stream, 3);
    $count = gzpassthru($stream);
    echo 'bytes=', $count, "
";
} finally { gzclose($stream); }

B2
bytes=3

Мы пропустили первую строку с переводом; оставшиеся B2 и перевод занимают3байта.

<?php
declare(strict_types=1);

$path = __DIR__ . '/report.gz';
file_put_contents($path, gzencode("A1\nB2\n"));
$stream = gzopen($path, 'rb');
if ($stream === false) { throw new RuntimeException('Open failed'); }
try {
    ob_start();
    try { $count = gzpassthru($stream); $text = ob_get_contents(); }
    finally { ob_end_clean(); }
    echo json_encode($text), "
", $count, "
";
} finally { gzclose($stream); }

"A1\nB2\n"
6

ob_start здесь демонстрирует связь вывода и строки. Для большого файла это снова расход памяти на весь документ; для небольшого содержимого обычно проще явное чтение.

<?php
declare(strict_types=1);

$path = __DIR__ . '/report.gz';
file_put_contents($path, gzencode("A1\nB2\n"));
$bytes = readgzfile($path);
if ($bytes === false) { throw new RuntimeException('Read failed'); }
echo 'bytes=', $bytes, "
";

A1
B2
bytes=6

Не пишите echo readgzfile(...) при выдаче документа: число результата случайно допишется к телу.

<?php
declare(strict_types=1);

$path = __DIR__ . '/plain.txt';
file_put_contents($path, "READY\n");
$bytes = readgzfile($path);
var_dump($bytes);

READY
int(6)

Успех этого вызова не подтверждает наличие gzip-заголовка. Для контролируемого скачивания чужие пути/обёртки не принимают напрямую.

<?php
declare(strict_types=1);

$path = __DIR__ . '/comment.gz';
file_put_contents($path, gzencode('<b>Hello</b>'));
$stream = gzopen($path, 'rb');
if ($stream === false) { throw new RuntimeException('Open failed'); }
try {
    $line = gzgets($stream);
    if ($line === false) { throw new RuntimeException('Read failed'); }
    echo htmlspecialchars($line, ENT_QUOTES | ENT_SUBSTITUTE, 'UTF-8'), "\n";
} finally { gzclose($stream); }

<b>Hello</b>

Теги отображаются текстом в HTML. Это конкретный контекст вывода, не универсальное экранирование для JavaScript, SQL или URL.

<?php
declare(strict_types=1);

$html = '<p>Order <b>25</b></p>';
echo strip_tags($html), "\n";
var_dump(function_exists('gzgetss'));

Order 25
bool(false)

Демонстрация PHP8.5.11. Для произвольного HTML нужно учитывать блоки, пробелы, сущности и повреждённую разметку; простое удаление тегов не полноценный HTML-to-text конвертер.

<?php
declare(strict_types=1);

if (!ob_start('ob_gzhandler')) { throw new RuntimeException('Buffer unavailable'); }
echo "READY\n";
ob_end_flush();

READY

Обычный CLI не присылает Accept-Encoding. Этот опыт проверяет передачу текста, не работу HTTP-сжатия.

<?php
// Самостоятельный HTTP endpoint; автоматическое сжатие PHP отключено.
if (ini_get('zlib.output_compression')) {
    throw new RuntimeException('Choose one compression layer');
}
if (!ob_start('ob_gzhandler')) { throw new RuntimeException('Buffer unavailable'); }
header('Content-Type: text/plain; charset=UTF-8');
echo "Order 25: READY\n";
ob_end_flush();

Order 25: READY

После декодирования клиент видит Order25:READY. На отдельном localhost HTTP-стенде проверены gzip, deflate и отсутствие согласованного кодирования. В общем списке это HTTP-контекст, поэтому синтаксис отмечен отдельно от интеграционного выполнения.

<?php
// Настраивается до любого вывода; reverse proxy не должен сжимать повторно.
if (ini_set('zlib.output_compression', '1') === false) {
    throw new RuntimeException('Compression unavailable');
}
header('Content-Type: text/plain; charset=UTF-8');
echo "Order 25: READY\n";

Order 25: READY

Это альтернатива предыдущему endpoint, не дополнительный ob_gzhandler поверх него. Настройка действует только на запрос. Проверяйте возможность ini_set; системный сервер может запрещать изменение.

<?php
declare(strict_types=1);

var_dump(zlib_get_coding_type());
$packed = gzencode('READY');
var_dump(zlib_get_coding_type());
echo gzdecode($packed), "\n";

bool(false)
bool(false)
READY

Создание строки gzencode не включает HTTP-сжатие и не меняет coding type. Это две разные задачи.

<?php
if (ini_set('zlib.output_compression', '1') === false) {
    throw new RuntimeException('Compression unavailable');
}
$coding = zlib_get_coding_type();
header('Content-Type: text/plain; charset=UTF-8');
echo 'coding=', $coding === false ? 'none' : $coding, "\n";

Для запроса Accept-Encoding:gzip декодированное тело coding=gzip; для deflate — coding=deflate; без согласования — coding=none. Варианты выполнены на отдельном HTTP-стенде. Не меняйте Content-Encoding вручную по строке, возвращённой здесь.