offsetで指定した場所から開始し、 ファイルの内容を全て文字列に読み込むこと以外はfile()と等価。 失敗した場合、file_get_contents() は FALSE を返します。
file_get_contents()はファイルの内容を文字列に読み込む 方法として好ましいものです。もしOSがサポートしていれば パフォーマンス向上のためにメモリマッピング技術が使用されます。
注意: offset パラメータは、PHP 5.1.0で追加されました。
注意: 空白のような特殊な文字を有するURIをオープンする場合には、 urlencode()でそのURIをエンコードする必要があります。
注意: この関数はバイナリデータに対応しています。
ティップ: fopen wrappers が有効の場合、この関数のファイル名として URL を使用することが出来ます。ファイル名の指定方法に関する詳細は fopen()、サポートされるURLプロトコルの種類 については、(例えば)付録L を参照してください。
注意: コンテキストのサポートは、 PHP 5.0.0 で追加されました。contexts の説明に関しては、 参照CXXII, ストリーム関数 を参照してください。
警告 |
IISのような、いくつかの標準に 対応してないWebサーバーは、PHPに警告を発生させるような手順でデータを送信します。 このようなサーバーを使用する場合は、 error_reportingを警告を発生しないレベルまで小さくする必要があります。 PHP 4.3.7 以降では、https:// ラッパーでストリームをオープンする際に バグがある IISサーバーソフトウエアを検出することができ、この警告を抑制することができます。 あなたが ssl:// ソケットを作性するために fsockopen() を使用している場合、 自らこの警告を検出し、抑制する必要があります。 |
fgets(), file(), fread(), include(), readfile() そして file_put_contents()も参照してください。