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:

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