Este módulo le permite leer y escribir de forma
transparente sobre archivos gzip (.gz) comprimidos, a
través de algunas versiones de la mayoría de
funciones del sistema de
archivos que trabajen con archivos comprimidos-gzip (y
archivos sin comprimir también, pero no con sockets).
Nota:
La versión 4.0.4 introdujo una envoltura fopen para
archivos-.gz, de modo que puede usar una URL especial 'zlib:'
para acceder a archivos comprimidos de forma transparente usando
las funciones de acceso normales f*() si precede el nombre o
ruta de archivo con un prefijo 'zlib:' al llamar a
fopen().
En la versión 4.3.0, este prefijo especial ha cambiado a
'zlib://' para prevenir ambigüedades con nombres de archivo
que contengan ':'.
Esta característica requiere una biblioteca C de tiempo
de ejecución que provee la función
fopencookie(). Hasta donde se conoce, la
biblioteca de C GNU es la única que ofrece esta
característica.
El comportamiento de estas
funciones está afectado por los valores definidos en
php.ini.
La extensión de zlib ofrece la opción de comprimir transparentemente
tus páginas web al vuelo, si el navegador de internet soporta esto. Por lo tanto
hay tres opciones en el
archivo de configuraciónphp.ini.
Tabla 1. Opciones de configuración Zlib
Nombre
Valor por Defecto
Modificable
zlib.output_compression
"Off"
PHP_INI_ALL
zlib.output_compression_level
"-1"
PHP_INI_ALL
zlib.output_handler
""
PHP_INI_ALL
Para más detalles y definiciones de las constantes PHP_INI_* vea
ini_set().
A continuación se
presenta una corta explicación de las directivas de
configuración.
Si se desea comprimir páginas transparentemente. Si esta opción
está en "On" en php.ini o en la configuración del Apache,
las páginas son comprimidas si el navegador envía un encabezado
"Accept-Encoding: gzip" o "deflate". "Content-Encoding: gzip" (respectivamente
"deflate") y "Vary: Accept-Encoding", los encabezados son agregados a la
salida.
Esta opción también acepta valores enteros en vez de los
boleanos "On"/"Off", usando esto usted puede fijar el tamaño del
buffer de salida (default es 4KB).
Nota: output_handler debe estar
vacío si está puesto en 'On' en lugar de este usted debe
usar zlib.output_handler.
zlib.output_compression_level
entero
El nivel de compresión usado para la salida transparentemente
comprimida.
zlib.output_handler
cadena
Usted no puede especificar manejadores adicionales de salida si
zlib.output_compression está activada. Estos ajustes no son lo
mismo que output_handler
sino un diferente orden.
Estas constantes están
definidas por esta extensión y estarán disponibles
solamente cuando la extensión ha sido o bien compilada dentro
de PHP o grabada dinámicamente en tiempo de ejecución.
Este ejemplo abre un archivo temporal y escribe una cadena de
prueba en él, luego imprime el contenido de este archivo
dos veces.
Ejemplo 1. Pequeño Ejemplo de Zlib
<?php
$nombre_archivo = tempnam('/tmp', 'zlibtest') . '.gz'; echo "<html>\n<head></head>\n<body>\n<pre>\n"; $s = "¡Tan solo una prueba, prueba, prueba, prueba, prueba, prueba!\n";
// abrir el archivo para escritura con maxima compresion $zp = gzopen($nombre_archivo, "w9");
// escribir la cadena en el archivo gzwrite($zp, $s);
// cerrar el archivo gzclose($zp);
// abrir el archivo para lectura $zp = gzopen($nombre_archivo, "r");
// leer 3 caracteres echo gzread($zp, 3);
// mostrar la salida hasta el final de archivo y cerrarlo. gzpassthru($zp); gzclose($zp);
echo "\n";
// abrir el archivo e imprimir su contenido (por segunda vez). if (readgzfile($nombre_archivo) != strlen($s)) { echo "¡Error con las funciones zlib!"; } unlink($nombre_archivo); echo "</pre>\n</body>\n</html>\n";
