gzread

Binary-safe gz-file read

&reftitle.description; ``string``false```gzread` `resource` `stream` `int` `length`

`gzread` reads up to `length` bytes from the given gz-file pointer. Reading stops when `length` (uncompressed) bytes have been read or EOF is reached, whichever comes first.

&reftitle.parameters;

`stream`

- The gz-file pointer. It must be valid, and must point to a file successfully opened by `gzopen`.

`length`

- The number of bytes to read.

&reftitle.returnvalues;

The data that have been read, &return.falseforfailure;.

&reftitle.changelog;

&Version; | &Description;
7.4.0 | This functions returns &false; on failure now; previously `0` was returned.

&reftitle.examples;

### `gzread` example

    <?php
    // get contents of a gz-file into a string
    $filename = "/usr/local/something.txt.gz";
    $zd = gzopen($filename, "r");
    $contents = gzread($zd, 10000);
    gzclose($zd);
    ?>

&reftitle.seealso;

- `gzwrite`
- `gzopen`
- `gzgets`
- `gzgetss`
- `gzfile`
- `gzpassthru`