file_get_contents
そふぃのPHP入門 >> PHP関数リファレンス >> ファイルシステム関数 >> file_get_contents

file_get_contents

解説 ファイルの内容を全て取得する
書式 string file_get_contents( string filename [, bool use_include_path ] )
string file_get_contents( string ファイル名 [, bool インクルードパス ] )
引数 filename ファイル名
use_include_path インクルードパスを検索するかどうか
返値 ファイルの内容が格納された文字列／FALSE（失敗した場合）

PHPマニュアル：file_get_contents file_get_contents()

file_get_contents()関数：概略解説

file_get_contents()は指定したファイルの内容を全て取得する関数です。file()と違い、取得する内容は文字列となります。

file_get_contents()関数：返り値解説

指定したファイルの内容を全て読み込んで文字列として返します。失敗した場合はFALSEを返します。

file_get_contents()関数：引数解説

filenameファイル名
ファイル名をパスで指定します。
use_include_pathインクルードパス
インクルードファイルを検索するかどうかのオプションで省略可能です。検索する場合はTRUEもしくは1を指定します。省略した場合は0またはFALSEが指定されたとみなし、検索しません。

file_get_contents()関数：補足解説

fopen_wrappersが有効の場合には、この関数のファイル名としてURLを使用する事ができます。ファイル名の指定方法に関する詳細はfopen()関数を参照して下さい。

file_get_contents()関数：その他

file_get_contents()関数に対して、file()関数ではファイルの内容を配列として返します。readfile()関数はファイルの内容を返すのではなく、内容をそのまま出力します。

参考関数

  • fgets() ---- ファイルから１行取得する
  • file() ---- ファイルの内容を全て取得して配列に格納する
  • fread() ---- ファイルをバイナリ・モードで読み込む
  • readfile() ---- ファイルを出力する

サンプルスクリプト

簡単な利用例

  1. <?php
  2. $contents = @file_get_contents("somefile.html");
  3. echo $contents;
  4. ?>

このサンプルなら実際はreadfile()を使った方が効率的かもしれません。

PHP辞典
PHP辞典 PHP5の関数にも対応したリファレンスですが、関数ごとにバージョンが表示されているのでPHP4ユーザにも安心。簡単なサンプルが全ての関数についている事と目的別検索が魅力です。
PHPポケットリファレンス
PHPポケットリファレンス 携帯用でもOKの小さめの本。関数本にありがちな分厚い・重い・見るのがおっくうという欠点をコンパクト化で解消してます。小さいながらも関数の掲載量・内容は共に十分充実しており、関数ごとのサンプルや目的別検索もあります。