PHPのfile_get_contentsでファイル・URLの情報を取得する

2024年5月6日

侍テック編集部

PHPでWebページの情報を取得したい
ファイルの内容を一括で取得したい

PHPではURLを指定してWebページの内容を取得したり、ファイルの内容を一括で取得できるfile_get_contents関数があります。

この記事では、file_get_contentsの基本的な使い方から、ステータスコードの取得方法、画像を取得する方法など応用的な使い方に関しても解説していきます。

この記事はこんな人のために書きました。

file_get_contents関数でWebページやファイルの内容を取得したい。
file_get_contents関数でステータスコードや画像を取得したい。

今回はそんなfile_get_contents関数の使い方について、わかりやすく解説します！

file_get_contentsとは

URLで指定したWebページの内容やファイルの内容を全て読み込むにはfile_get_contents関数を使用します。

file_get_contents関数は、以下のように記述します。

書き方：

string file_get_contents ( string $パス/ファイル名 [, bool $インクルードパス = false [, $コンテキスト [, int $オフセット値 = 0 [, int $最大バイト数 ]]]] );

引数：

引数	説明
第一引数	読み込むパス/ファイル名
第二引数	インクルードパスを指定 FILE_USE_INCLUDE_PATHを指定すると、インクルードパスからファイルを指定
第三引数	stream_context_create関数で作成したコンテキストリソースを指定
第四引数	読込みを開始するオフセット値
第五引数	読み込むデータの最大バイト数を指定デフォルトではファイルの終端まで読み込み

返り値：
ファイルの内容が格納された文字列を返します。失敗した場合はFALSEを返します。指定したファイルが見つからなかった場合や最大バイト数がゼロよりも小さいなどの場合はE_WARNINGのエラーが発生します。

file_get_contentsの基本的な使い方

Webページの内容を全て読み込む

Webページを読み込む場合はURLをhttpまたはhttpsから指定します。

サンプルプログラム:

<?php
 
$str = file_get_contents('https://www.sejuku.net/blog/');
echo $str;
 
?>

file_get_contents関数でURLを指定してWebページの内容を取得し、echoで取得するとブラウザにWebページが表示されます。

ファイルの内容を全て読み込む

ファイルの内容を全て読み込んで、結果を出力する簡単なサンプルを紹介します。
（読み込むファイルは予め用意しておきます。）

php.txt

AAAAA
BBBBB
CCCCC
DDDDD

サンプルプログラム:

<?php
 
$str = file_get_contents('php.txt');
echo $str;
 
?>

実行結果：

AAAAA
BBBBB
CCCCC
DDDDD

実行結果のとおり、file_get_contents関数を使用すれば、ファイルの内容を改行コード含めて全て取得できることがわかりますね！

ファイルの一部を読み込む

ファイルの一部を読み込むには、file_get_contents関数の第四、第五引数を指定します。

第四引数に開始位置であるオフセット値を指定します。
第五引数に最大バイト数を指定します。

以下にファイルの一部を指定して読み込む方法を記述します。

サンプルプログラム:

<?php
 
$str = file_get_contents('php.txt', NULL, NULL, 6, 5);
echo $str;
 
?>

実行結果：

BBBBB

実行結果のとおりファイルの一部のみ読込みができることがわかりますね！

このようにファイルから読み込みたいデータの位置がわかっている場合は、ファイル位置を指定して読み込むほうが便利です。

file_get_contentsの応用的な使い方

エラー時にステータスコードを取得する

file_get_contents関数を使用すれば、URLを指定したときに存在しないエラーやサーバーのエラーなどのステータスコードを取得することができます。エラーコードを取得することができれば、万が一読込みが失敗したときに適切なエラー処理を記述することができます。

エラーコードを取得するためには、stream_context_create関数を使用してignore_errorsをtrueに指定したコンテキストをfile_get_contents関数の第三引数に指定する必要があります。

以下にステータスコードを取得して、処理を分岐するサンプルを紹介します。

サンプルプログラム:

<?php
 
//コンテキストを設定
$con = stream_context_create(array(
  'http' => array('ignore_errors' => true)));
 
//URLを指定してレスポンスを取得する
$http = file_get_contents('http://www.sejuku.net/aaa', false, $con);
 
//ステータスコードを取得する
$code = substr($http_response_header[0], 9, 3);
 
//ステータスコードによって処理を分岐する
switch ($code){
  case '200':
    echo $code;
    break;
  case '404':
    echo '404 error';
    //エラー処理
    break;
  case '500':
    echo '500 error';
    //エラー処理
    break;
  default:
  break;
}
 
?>

実行結果：

404 error

サンプルでは存在しないURLを指定したため、404エラーが発生します。$http_response_headerは最初の要素にステータスコードが格納されますので、substr関数でステータスコードを取得することができます。

画像を取得する

file_get_contents関数を使用すれば、画像を格納しているパスや画像のあるURLを指定して画像を取得することができます。

サンプルプログラム:

$path = 'test.jpg';

//file_get_contentsで画像のパスを指定
$img = file_get_contents($path);

//タイプをimage/jpegで指定
header('Content-type: image/jpeg') ;

echo $img;

このプログラムを実行すると、ブラウザに取得した画像が表示されます。