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

Базовый пример чтения нескольких символов из сжатого файла.

<?php
$filename = 'example.txt.gz';
$handle = gzopen($filename, 'r');
if ($handle) {
    echo "Первые 5 символов: ";
    for ($i = 0; $i < 5; $i++) {
        $char = gzgetc($handle);
        if ($char === false) break;
        echo $char;
    }
    gzclose($handle);
} else {
    echo "Не удалось открыть файл.";
}
?>

Первые 5 символов: Hello

Чтение файла до конца.

<?php
$handle = gzopen('data.gz', 'r');
if ($handle) {
    while (($char = gzgetc($handle)) !== false) {
        echo $char;
    }
    gzclose($handle);
}
?>

(Выводит всё содержимое файла data.gz)

Читает произвольное количество байт из сжатого файла. Более эффективна для чтения больших блоков данных.

Распаковывают строку, сжатую определенным методом, без необходимости работы с файловой системой.

Аналог для обычных, несжатых файлов. Используется с указателем, возвращаемым fopen().

Когда что использовать: gzgetc полезна для посимвольного анализа или обработки сжатых текстовых данных. Для чтения строк целиком лучше подходит gzgets, а для бинарных данных или больших блоков — gzread.

Gzgetc в Python

Модуль gzip. Файл открывается как текстовый, и для посимвольного чтения можно использовать методы файлового объекта, например, read(1).

import gzip
with gzip.open('example.gz', 'rt', encoding='utf-8') as f:
    char = f.read(1)
    print(char)

H

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

const zlib = require('zlib');
const fs = require('fs');
const gunzip = zlib.createGunzip();
const readStream = fs.createReadStream('example.gz');
let data = '';
readStream.pipe(gunzip).on('data', (chunk) => { data += chunk; });

Gzgetc в MySQL

Прямого аналога для посимвольного чтения сжатых файлов не существует. Сжатие обычно применяется на уровне таблиц или столбцов.

Самая частая ошибка — попытка использовать указатель от обычного fopen() или уже закрытый ресурс.

<?php
$fp = fopen('test.txt', 'r');
$char = gzgetc($fp); // Неверно!
gzclose($fp);
?>

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

<?php
$gz = gzopen('empty.gz', 'r');
while ($char = gzgetc($gz)) { // Цикл не остановится при EOF
    echo $char;
}
?>

При достижении конца файла gzgetc возвращает false, но это же значение интерпретируется как логическое false, и цикл прерывается. Однако если файл содержит символ "0" (ноль), который также преобразуется в false, цикл может завершиться преждевременно. Правильнее использовать строгое сравнение: ($char = gzgetc($gz)) !== false.

В PHP 8 не было внесено специфических изменений в работу функции gzgetc. Однако, как и многие другие функции, в случае передачи неверного типа аргумента (например, null или array вместо ресурса) будет выбрасываться ошибка типа TypeError, а не предупреждение, как в предыдущих версиях.

<?php
$handle = gzopen('book.txt.gz', 'r');
$charCount = [];
if ($handle) {
    while (($char = gzgetc($handle)) !== false) {
        if (!isset($charCount[$char])) {
            $charCount[$char] = 0;
        }
        $charCount[$char]++;
    }
    gzclose($handle);
    arsort($charCount);
    echo "Самые частые символы:\n";
    $i = 0;
    foreach ($charCount as $char => $count) {
        printf("Символ '%s' (код %d): %d раз\n", $char, ord($char), $count);
        if (++$i >= 5) break;
    }
}
?>

Поиск последовательности "DATA_START" в сжатом лог-файле.

<?php
$gz = gzopen('logfile.gz', 'r');
$marker = 'DATA_START';
$buffer = '';
$found = false;
if ($gz) {
    while (($char = gzgetc($gz)) !== false) {
        $buffer .= $char;
        if (strlen($buffer) > strlen($marker)) {
            $buffer = substr($buffer, 1);
        }
        if ($buffer === $marker) {
            $found = true;
            echo "Маркер найден. Начинаем чтение данных.\n";
            break;
        }
    }
    if ($found) {
        // Чтение полезных данных после маркера
        $data = gzread($gz, 1024);
        echo $data;
    } else {
        echo "Маркер не найден.\n";
    }
    gzclose($gz);
}
?>

<?php
function my_gzgets($gz, $length = 1024) {
    $line = '';
    $bytesRead = 0;
    while ($bytesRead < $length && ($char = gzgetc($gz)) !== false) {
        $line .= $char;
        $bytesRead++;
        if ($char === "\n") {
            break;
        }
    }
    return ($line === '' && $char === false) ? false : $line;
}

$gz = gzopen('lines.gz', 'r');
if ($gz) {
    while (($line = my_gzgets($gz)) !== false) {
        echo "Прочитана строка: " . htmlspecialchars($line) . "<br>";
    }
    gzclose($gz);
}
?>