(PHP 4 >= 4.0.4, PHP 5)
gzencode — Crea una cadena comprimida con gzip
$data
[, int $level
= -1
[, int $encoding_mode
= FORCE_GZIP
]] )
Esta función retorna una versión comprimida de la data
de entrada, compatible con la salida del programa gzip.
Para más información sobre el formato de archivo GZIP, ver el documento: » GZIP file format specification version 4.3 (RFC 1952).
data
Los datos a codificar.
level
El nivel de compresión. Se puede dar como 0 para ninguna compresión, hasta 9 para la máxima compresión. Si no se incluye, se utilizará el nivel de compresión por defecto de la librería zlib.
encoding_mode
El modo de codificación. Puede ser FORCE_GZIP
(por defecto) o FORCE_DEFLATE
.
Antes de PHP 5.4.0, utilizar FORCE_DEFLATE
resultaba en
un string comprimido zlib estándar (incluyendo encabezados de la librería) después
del encabezado de archivo gzip pero sin el cierre de la suma de control crc32.
En PHP 5.4.0 y posterior, FORCE_DEFLATE
genera
una salida que cumple el RFC 1950, consistente en un encabezado zlib, los datos
comprimidos y una suma de control Adler.
La cadena codificada o FALSE
si ocurre un error.
Versión | Descripción |
---|---|
5.4.0 |
FORCE_DEFLATE ahora genera una salida que cumple el
RFC 1950.
|
4.2.0 |
El parámetro encoding_mode fue agregado.
|
Los datos resultantes contienen los encabezados y estructura de datos apropiados para construir un archivo .gz estándar, por ejemplo:
Ejemplo #1 Creando un archivo gzip
<?php
$data = implode("", file("bigfile.txt"));
$gzdata = gzencode($data, 9);
$fp = fopen("bigfile.txt.gz", "w");
fwrite($fp, $gzdata);
fclose($fp);
?>