導入

このモジュールにより gzip (.gz) で圧縮されたファイルを読み書きすることが可能となります。 この際、ファイルシステム 関数の gzip 圧縮対応版 (非圧縮ファイルも扱えますが、 ソケットは扱えません)を使用します。

注意: バージョン 4.0.4 で .gz ファイルに対応した fopen のラッパー を導入しました。 fopen() に渡すファイル名または パス名に zlib: をつけると、通常の f*() ファイルアクセス関数を使用して圧縮ファイルに透過的にアクセスすることが できます。

PHP 4.3.0 において、';' を含むファイル名との曖昧さを避けるため zlib: は compress.zlib:// に変更されました。fopencookie() 関数は もはや必要ありません。詳細な情報は、 圧縮ストリーム項 にあります。

要件

このモジュールは、Jean-loup Gailly および Mark Adler による » zlib の関数を使用します。 このモジュールを使用するには、zlib バージョン >= 1.0.9 を使用する必要があります。

インストール手順

PHPにおけるZlibサポートは、デフォルトでは利用できません。 Zlibサポートを有効にするには、PHPのコンパイル時にconfigureの オプションに--with-zlib[=DIR]を 指定してコンパイルする必要があります。

Windows 版の PHP には この拡張モジュールのサポートが組み込まれています。これらの関数を使用 するために拡張モジュールを追加でロードする必要はありません。

注意: PHP 4.3.0 以降、zlib モジュールは Windows 用 php バイナリにビルトインされています。

実行時設定

php.ini の設定により動作が変化します。

zlib 拡張モジュールは、 ブラウザがサポートする場合にページを透過的に圧縮するオプションを提供します。 ここで、 設定ファイル php.ini のオプションには、以下の 3 種類があります。

以下に設定ディレクティブに関する 簡単な説明を示します。

リソース型

この拡張モジュールでは、ファイルポインタリソースを定義しています。これは gzopen() が返すものです。

定義済み定数

以下の定数が定義されています。 この関数の拡張モジュールが PHP 組み込みでコンパイルされているか、 実行時に動的にロードされている場合のみ使用可能です。

例

テンポラリファイルをオープンし、テスト用文字列を書きこみ、 続いて、このファイルの内容を 2 回出力します。

目次

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

gzcompress — 文字列を圧縮する

gzdecode — gzip 圧縮された文字列をデコードする

gzdeflate — 文字列を deflate 圧縮する

gzencode — gzip 圧縮された文字列を作成する

gzeof — gz ファイルポインタがファイル終端かどうか調べる

gzfile — gzファイル全体を配列に読み込む

gzgetc — gz ファイルへのポインタから文字を得る

gzgets — ファイルポインタから 1 行を得る

gzgetss — gzファイルへのポインタから1行を得て、HTMLタグを取り除く

gzinflate — deflate圧縮された文字列を解凍する

gzopen — gz ファイルを開く

gzpassthru — gzファイルへのポインタから残りのデータ全部を出力する

gzputs — のエイリアス gzwrite()

gzread — バイナリ対応のgzファイル読み込み

gzrewind — gz ファイルポインタの示す位置を元に戻す

gzseek — gz ファイルポインタの位置を移動する

gztell — gzファイルポインタの読み込み/書き込み位置を返します

gzuncompress — 圧縮された文字列を解凍する

gzwrite — バイナリセーフな gz ファイル書き込み

readgzfile — gz ファイルを出力する

zlib_get_coding_type — 出力圧縮に使用されたコーディングの種類を返す