file

PHP マニュアル
前のページ		次のページ

説明

array file ( string filename [, int flags [, resource context]] )

file_get_contents() と似ていますが、file() はファイルを配列に入れて返すところが異なります。配列の各要素はファイルの各行に対応します。改行記号はついたままとなります。失敗するとfile()はFALSEを返します。

オプションのパラメータ flags は、以下の定数のうちのひとつ、あるいは複数の組み合わせとなります。

FILE_USE_INCLUDE_PATH: include_path のファイルを探します。
FILE_IGNORE_NEW_LINES: 配列の各要素の最後に改行文字を追加しません。
FILE_SKIP_EMPTY_LINES: 空行を読み飛ばします。

注意: PHP 5.0.0 より前のバージョンでは、パラメータ flags でカバーしているのは include_path の設定だけでした。これを有効にするには 1 を指定します。


<?php
// ファイルの内容を配列に取り込みます。
// この例ではHTTPを通してURL上のHTMLソースを取得します。
$lines = file('http://www.example.com/');

// 配列をループしてHTMLをHTMLソースとして表示し、行番号もつけます。
foreach ($lines as $line_num => $line) {
    echo "Line #<b>{$line_num}</b> : " . htmlspecialchars($line) . "<br />\n";
}

// 他の例として、Webページを文字列に取り込みます。file_get_contents()も参照してください。
$html = implode('', file('http://www.example.com/'));
?>

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

注意: FILE_IGNORE_NEW_LINES を指定しない限り、配列に取り込まれた各行は行末文字も含みます。行末文字を取り除きたい場合には rtrim() を使用する必要があります。

注意: マッキントッシュコンピュータ上で作成されたファイルを読み込む際に、 PHP が行末を認識できないという問題が発生した場合、実行時の設定オプションauto_detect_line_endings を有効にする必要が生じるかもしれません。

注意: PHP 4.3.0 以降ではファイルの内容を文字列に取り込むために file_get_contents() を使うことができます。
PHP 4.3.0 で file() はバイナリセーフになりました。

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

警告

IIS のような、いくつかの標準に対応してない Web サーバは、PHP に警告を発生させるような手順でデータを送信します。このようなサーバを使用する場合は、 error_reporting を警告を発生しないレベルまで小さくする必要があります。 PHP 4.3.7 以降では、https:// ラッパーでストリームをオープンする際にバグがある IIS サーバソフトウエアを検出することができ、この警告を抑制することができます。あなたが ssl:// ソケットを作性するために fsockopen() を使用している場合、自らこの警告を検出し、抑制する必要があります。

readfile()、 fopen()、fsockopen()、 popen()、file_get_contents()、 include() および stream_context_create() も参照ください。

前のページ	ホーム	次のページ
file_put_contents	上に戻る	fileatime