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 offsetmaxlen パラメータが追加されました。

注意

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

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

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

警告

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