PHP マニュアル
前のページ |  | 次のページ

# file_get_contents

(PHP 4 >= 4.3.0, PHP 5)

file_get_contents -- ファイルの内容を全て文字列に読み込む

## 説明

string file_get_contents ( string filename [, bool use_include_path [, resource context [, int offset [, int maxlen]]]] )

file_get_contents() は、 `offset`で指定した場所から開始し `maxlen` バイト分だけ ファイルの内容を文字列に読み込むこと以外は file() と等価です。 失敗した場合、file_get_contents() は `FALSE` を返します。

file_get_contents()はファイルの内容を文字列に読み込む 方法として好ましいものです。もしOSがサポートしていれば パフォーマンス向上のためにメモリマッピング技術が使用されます。

> 注意: 空白のような特殊な文字を有するURIをオープンする場合には、 urlencode()でそのURIをエンコードする必要があります。

> 注意: `context` パラメータを省略するには、`NULL` を指定します。

## 変更履歴

バージョン | 説明
--- | ---
5.0.0 | コンテキストサポートが追加されました。
5.1.0 | `offset` と `maxlen` パラメータが追加されました。

## 注意

> 注意: この関数はバイナリデータに対応しています。

> ティップ: fopen wrappers が有効の場合、この関数のファイル名として URL を使用することができます。ファイル名の指定方法に関する詳細は fopen()、サポートされる URL プロトコルの種類 については、(例えば)付録M を参照してください。

> 注意: コンテキストのサポートは、 PHP 5.0.0 で追加されました。`contexts` の説明に関しては、 参照CLVIII, ストリーム関数 を参照してください。

警告
IIS のような、いくつかの標準に 対応してない Web サーバは、PHP に警告を発生させるような手順でデータを送信します。 このようなサーバを使用する場合は、 error_reporting を警告を発生しないレベルまで小さくする必要があります。 PHP 4.3.7 以降では、https:// ラッパーでストリームをオープンする際に バグがある IIS サーバソフトウエアを検出することができ、この警告を抑制することができます。 あなたが ssl:// ソケットを作性するために fsockopen() を使用している場合、 自らこの警告を検出し、抑制する必要があります。

## 参考

file()
fgets()
fread()
readfile()
file_put_contents()
stream_get_contents()
stream_context_create()

前のページ | ホーム | 次のページ
file_exists | 上に戻る | file_put_contents