gz ファイルを開く

# gzopen

(PHP 4, PHP 5, PHP 7, PHP 8)

gzopen — gz ファイルを開く

### 説明

function gzopen(string `$filename`, string `$mode`, bool `$use_include_path` = `false`): resource|false

読み込みもしくは書き込みのために gzip (.gz) ファイルをオープンします。

gzopen() は、gzip フォーマットでないファイルの読み込みについても使用することができます。 この場合、gzread()は、ファイルを解凍せずに直接読み 込まれます。

### パラメータ

`filename`

  ファイル名を指定します

`mode`

  fopen() と同じ (`rb` または `wb`) ですが、 圧縮レベル (`wb9`) または圧縮の方策、 つまり、`wb6f` のようにフィルターを通したデータを `f` で指定したり、`h` でハフマン圧縮のみを行うことを指定したりすることができます (方策に関するパラメータの詳細については、zlib.h の中の `deflateInit2` の説明を参照ください)。

`use_include_path`
  `true` を設定すると、include_path にあるファイルも検索します。

### 戻り値

オープンしたファイルへのファイルポインタを返します。その後、 このファイルディスクプリタから読み込んだ全ては透過的に解凍され、 書き込んだものは圧縮されます。

オープンに失敗した場合、この関数は `false` を返します。

### 変更履歴

バージョン | 説明
--- | ---
8.5.0 | `use_include_path` の型が bool になりました。 これより前は、int でした。

### 例

例1 gzopen() の例

    <?php
    $fp = gzopen("/tmp/file.gz", "r");
    ?>

### 参考

- gzclose() - 開かれたgzファイルへのポインタを閉じる

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open