Gzpassthru: примеры (PHP)

$filename = 'example.txt.gz';
$handle = gzopen($filename, 'rb');
if ($handle) {
    echo gzpassthru($handle); // Выводит содержимое распакованным
}

Содержимое файла example.txt, сжатого в gz...

$handle = gzopen('data.gz', 'rb');
gzread($handle, 10); // Пропускаем первые 10 байт распакованных данных
echo 'Остальные данные: ';
echo gzpassthru($handle); // Выводит все данные с 11-го байта до конца

Остальные данные: ... (распакованное содержимое с 11-го байта)

gzread() - читает указанное количество байт из gz-файла. Позволяет контролировать объем считываемых данных, в отличие от gzpassthru, которая читает до конца.

readgzfile() - читает и выводит весь gz-файл. Функция похожа на комбинацию gzopen(), gzpassthru() и gzclose(), но не требует явного открытия и закрытия файла.

gzinflate() - распаковывает сырую сжатую строку без заголовков gzip. Используется для работы со сжатыми данными в памяти.

Выбор функции зависит от задачи: gzpassthru удобна для прямого вывода, gzread - для обработки частями, readgzfile - для простого вывода всего файла, gzinflate - для работы со строками.

Gzpassthru в Python

import gzip
with gzip.open('example.txt.gz', 'rb') as f:
    print(f.read().decode())  # Чтение всего содержимого

Содержимое файла...

const zlib = require('zlib');
const fs = require('fs');
const gunzip = zlib.createGunzip();
const input = fs.createReadStream('file.gz');
input.pipe(gunzip).pipe(process.stdout);

Содержимое файла в stdout...

Gzpassthru в MySQL

Прямого аналога нет, но есть функции для работы со сжатыми данными, например, COMPRESS() и UNCOMPRESS() для строк.

SELECT UNCOMPRESS(compressed_column) FROM table;

$file = fopen('test.txt', 'r');
echo gzpassthru($file); // Не gz-ресурс

Warning: gzpassthru(): supplied resource is not a valid stream resource

$gz = gzopen('file.gz', 'rb');
gzpassthru($gz); // Файл автоматически закрыт
echo gzread($gz, 10); // Ошибка

Warning: gzread(): %d is not a valid stream resource

$handle = @gzopen('missing.gz', 'rb');
if (!$handle) {
    echo 'Ошибка открытия файла';
} else {
    gzpassthru($handle);
}

Ошибка открытия файла

В PHP 8.0.0 функция gzpassthru() теперь выбрасывает исключение ValueError, если параметр $stream не является ресурсом. Ранее выдавалась ошибка уровня E_WARNING.

Других значительных изменений в поведении функции в последних версиях PHP не было. Функция сохраняет обратную совместимость.

$gzFile = 'archive.tar.gz';
$handle = gzopen($gzFile, 'rb');
if ($handle) {
    header('Content-Type: application/octet-stream');
    header('Content-Disposition: attachment; filename="archive.tar"');
    header('Content-Encoding: gzip'); // Указываем, что содержимое сжато
    gzpassthru($handle); // Отправляем сжатые данные как есть
}

$logGz = 'app.log.gz';
$handle = gzopen($logGz, 'rb');
$firstLine = gzgets($handle); // Читаем первую строку
$bytesRead = gzpassthru($handle); // Выводим остальное
file_put_contents('bytes.log', "Прочитано байт: $bytesRead");

Построчная обработка невозможна, так как gzpassthru выводит все сразу. Для построчной обработки следует использовать gzgets() в цикле.

$handle = gzopen('large.log.gz', 'rb');
while (!gzeof($handle)) {
    $line = gzgets($handle);
    // Обработка строки
}
gzclose($handle);