gzencode

(PHP 4 >= 4.0.4, PHP 5)

gzencode — Crea una stringa compressa con gzip

Descrizione

string gzencode ( string $dati [, int $livello [, int $encoding_mode ]] )

Questa funzione restituisce una versione compressa di dati compatibile con l'output del programma gzip, oppure FALSE se si verifica un errore. Il parametro opzionale livello varia da 0 (nessuna compressione) a 9 (compressione massima), se il livello di compressione non viene specificato verrà adottato quello di default della libreria zlib.

Si può anche impostare FORCE_GZIP (il default) o FORCE_DEFLATE come terzo parametro opzionale encoding_mode. Se si utilizza FORCE_DEFLATE, si ottiene una stringa compressa col DEFLATE standard di zlib (comprendente gli header zlib) dopo l'header del file gzip ma senza il checksum crc32 finale.

Nota:
livello è stato aggiunto nel PHP 4.2, prima di questa versione gzencode() aveva solo i parametri dati e (opzionale) encoding_mode.

I dati risultanti contengono gli header e la struttura adeguati per creare un file .gz standard, ad esempio:

Example #1 Creare un file gzip


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

Per ulteriori informazioni sul formato dei file GZIP, consultare il documento: » GZIP file format specification version 4.3 (RFC 1952).

Vedere anche gzcompress(). gzuncompress(), gzdeflate(), gzinflate().