gzencode

(PHP 4 >= 4.0.4, PHP 5)

gzencode — Crea una cadena comprimida con gzip

Descripción

string gzencode ( string $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).

Parámetros

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.

Valores devueltos

La cadena codificada o FALSE si ocurre un error.

Historial de cambios

Versión Descripción
5.4.0 FORCE_DEFLATE ahora genera una salida que cumple el RFC 1950.

Ejemplos

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);
?>

Ver también