file_get_contents()

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 の説明に関しては、 ストリーム を参照してください。

警告

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()