gzencode

(PHP 4 >= 4.0.4, PHP 5)

gzencode -- Cria uma string comprimida com gzip

Descrição

string gzencode ( string data [, int level [, int encoding_mode]] )

Esta função retorna uma versão comprimida dos dados de entrada data compatível com a saída do programa gzip, ou FALSE se um erro for encontrado. O parâmetro opcional level pode ser dado como 0 para sem compressão até 9 para compressão máxima, se não for dado o nível de compressão padrão será o nível de compressão padrão da biblioteca zlib.

Você também pode dar FORCE_GZIP (o padrão) ou FORCE_DEFLATE como o terceiro parâmetro, que é opcional, encoding_mode. Se você usar FORCE_DEFLATE, você obtém uma string DEFLATE (inclusive os cabeçalhos gzip) após os cabeçalhos do arquivo gzip mais sem o checksum crc32.

Nota: level foi adicionado no PHP 4.2, antes do PHP 4.2 gzencode() tinha apenas os parâmetros data e (opcional) encoding_mode.

Os dados resultantes contém os cabeçalhos apropriados e a estrutura de dados para fazer um arquivo .gz padrão, ex:

Exemplo 1. Criando um arquivo gzip

<?php
    $data
= implode("", file("bigfile.txt"));
    
$gzdata = gzencode($data, 9);
    
$fp = fopen("bigfile.txt.gz", "w");
    
fwrite($fp, $gzdata);
    
fclose($fp);
?>

Para maiores informações sobre o formato GZIP, veja o documento: GZIP file format specification version 4.3 (RFC 1952).

Veja também gzcompress(). gzuncompress(), gzdeflate() e gzinflate().