gzencode

Create a gzip compressed string

&reftitle.description; ``string``false```gzencode` `string` `data` `int` `level`-1 `int` `encoding` `ZLIB_ENCODING_GZIP`

This function returns a compressed version of the input `data` compatible with the output of the `gzip` program.

For more information on the GZIP file format, see the document: GZIP file format specification version 4.3 (RFC 1952).

&reftitle.parameters;

`data`

- The data to encode.

`level`

- The level of compression. Can be given as 0 for no compression up to 9 for maximum compression. If not given, the default compression level will be the default compression level of the zlib library.

`encoding`

- The encoding mode. Can be `FORCE_GZIP` (the default) or `FORCE_DEFLATE`.

  `FORCE_DEFLATE` generates RFC 1950 compliant output, consisting of a zlib header, the deflated data, and an Adler checksum.

&reftitle.returnvalues;

The encoded string, or &false; if an error occurred.

&reftitle.examples;

The resulting data contains the appropriate headers and data structure to make a standard .gz file, e.g.:

### Creating a gzip file

    <?php
    $data = file_get_contents("bigfile.txt");
    $gzdata = gzencode($data, 9);
    file_put_contents("bigfile.txt.gz", $gzdata);
    ?>

&reftitle.seealso;

- `gzdecode`
- `gzdeflate`
- `gzinflate`
- `gzuncompress`
- `gzcompress`
- ZLIB Compressed Data Format Specification (RFC 1950)