Forum und email
Referencia de funciones
PHP Manual

Funciones de Compresión Zlib

Introducción

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).

Note: 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.

Requisitos

Este módulo usa las funciones de » zlib, por Jean-loup Gailly y Mark Adler. Debe usar una versión de zlib >= 1.0.9 con éste módulo.

Instalación

Soporte Zlib en PHP no está activo por defecto. Usted necesitará configurar PHP --with-zlib[=DIR]

La versión para Windows de PHP tiene soporte nativo para esta extensión. No se necesita cargar ninguna extensión adicional para usar estas funciones.

Note: soporte integrado para zlib en Windows está disponible con PHP 4.3.0

Configuración en tiempo de ejecución

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ón php.ini.

Opciones de configuración Zlib
Nombre Valor por Defecto Modificable Changelog
zlib.output_compression "Off" PHP_INI_ALL Available since PHP 4.0.5.
zlib.output_compression_level "-1" PHP_INI_ALL Available since PHP 4.3.0.
zlib.output_handler "" PHP_INI_ALL Available since PHP 4.3.0.
For further details and definitions of the PHP_INI_* constants, see the Directivas de php.ini.

A continuación se presenta una corta explicación de las directivas de configuración.

zlib.output_compression boolean/integer

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).

Note: 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.

Tipos de recursos

Esta extensión no tiene ningún tipo de recurso definido.

Constantes predefinidas

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.

FORCE_GZIP (entero)
FORCE_DEFLATE (entero)

Ejemplos

Este ejemplo abre un archivo temporal y escribe una cadena de prueba en él, luego imprime el contenido de este archivo dos veces.

Example#1 Pequeño Ejemplo de Zlib

<?php

$nombre_archivo = tempnam('/tmp', 'zlibtest') . '.gz';
echo "<html>\n<head></head>\n<body>\n<pre>\n";
$s = "&iexcl;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 "&iexcl;Error con las funciones zlib!";
}
unlink($nombre_archivo);
echo "</pre>\n</body>\n</html>\n";

?>

Table of Contents

  • gzclose — Cierra un apuntador de un fichero gz abierto
  • gzcompress — Comprime una cadena
  • gzdecode — Decodes a gzip compressed string
  • gzdeflate — Comprime una cadena
  • gzencode — Crea una cadena comprimida con gzip
  • gzeof — Prueba de apuntador para el fin de archivo gz
  • gzfile — Lee un archivo gz completo en una matriz
  • gzgetc — Obtiene un caracter del archivo GZ apuntado
  • gzgets — Obtiene una línea del archivo apuntado
  • gzgetss — Obtiene una línea del archivo apuntado y le retira las etiquetas HTML
  • gzinflate — Descomprime una cadena comprimida
  • gzopen — Abrir un archivo gz
  • gzpassthru — Imprimir todos los datos que restan en un apuntador a archivo gz
  • gzputs — Alias de gzwrite
  • gzread — Lectura segura de archivo binario gz
  • gzrewind — Reinicia la posición de un apuntador de archivo gz
  • gzseek — Busca en el archivo gz apuntado
  • gztell — Indica la posición de lectura/escritura del apuntador a archivo gz
  • gzuncompress — Descomprime una cadena comprimida
  • gzwrite — Escritura en un archivo gz, segura con material binario
  • readgzfile — Imprimir un archivo gz
  • zlib_get_coding_type — Regresa el tipo de codificación usada para la salida de la compresión
Referencia de funciones
PHP Manual