PHPのfile_get_contents関数
file_get_contents
(PHP 4" = 4.3.0、PHP 5)
file_get_contents - ファイル全体を文字列に読み取ります
説明
string file_get_contents (string $file[summary$flag=0[, resource$background[summary$offset=-1][summary$maxlen=-1]]])
この関数は file() に似ていますが、file_get_contents() は指定されたオフセットから開始して maxlen バイトまでのファイル内の文字列を返します。失敗すると、file_get_contents() は FALSE を返します。
file_get_contents() は、ファイルの内容を文字列として読み取るための推奨される方法です。オペレーティング システムでサポートされている場合は、メモリ マッピング テクノロジを使用してパフォーマンスを向上させます。
注: スペースなどの特殊文字を使用して URI を開く場合は、urlencode() を使用して URI をエンコードする必要があります。
パラメータ
ファイル名
ファイル名は に変更されます。
旗
警告
PHP 6 より前のすべてのバージョンでは、このパラメータは use_include_path と呼ばれ、ブール値でした。 flag パラメータは PHP 6 以降でのみ機能します。古いバージョンを使用していて、名前にパスが含まれるファイルを検索したい場合は、このパラメータを true にする必要があります。 PHP 6 以降では、代わりに FILE_USE_INCLUDE_PATH フラグを使用する必要があります。
フラグ値は、バイナリ演算子または ( | ) 演算子によって追加された、次のフラグの任意の組み合わせ (いくつかの制限付き) にすることができます。
国旗の説明
FILE_USE_INCLUDE_PATH は、ファイル名に含まれるディレクトリを検索します。詳細については、「include_path」を参照してください。
FILE_TEXT PHP 6 以降、データ読み取りのデフォルトのエンコーディングは UTF-8 です。 stream_default_encoding() を使用して、別のエンコーディングを指定したり、カスタム範囲を作成したり、デフォルトを変更したりできます。このフラグは FILE_BINARY では使用できません。
FILE_BINARY このフラグを使用すると、ファイルは読み取り専用バイナリ モードになります。これはデフォルト設定であり、FILE_TEXT では使用できません。
背景
リソースの有効なスコープ内で stream_context_create() を確立します。カスタムケースを使用する必要がない場合は、このパラメータをスキップして null のままにすることができます。
オフセット
読み取り開始時のオフセット。
マックスレン
読み取られるデータの最大長。
戻り値
この関数はデータの読み取り失敗または FALSE を返します。
例
例 #1 ソースページ、Web サイトを取得して出力します
$homepage = file_get_contents('http://www.example.com/');
$homepage をエコー;
?>
例 #2 include_path 内での検索
//
$file = file_get_contents('./people.txt', true);
// > PHP 5
$file = file_get_contents('./people.txt', FILE_USE_INCLUDE_PATH);
?>