PHP file() 関数

定義と用法

file() 関数は、ファイル全体を読み込んで配列に格納します。

および file_get_contents() 同様ですが、file() はファイルを配列として返します。配列の各要素は、ファイルの対応する行(改行符も含めます)です。

失敗した場合、false を返します。

语法

文法説明file(必須。読み込むファイルを指定します。file(context)
, パラメータ
説明 path
必須。読み込むファイルを指定します。 include_path
context

オプション。include_path内でファイルを検索する場合は、このパラメータを"1"に設定します。

context オプション。ファイルハンドルの環境を指定します。

流の動作を変更できるオプションのセットです。nullを使用すると、無視されます。

説明 context のサポートはPHP 5.0.0で追加されました。

返される配列の各行には行終端記号が含まれていますので、行終端記号が必要でない場合は、rtrim()関数を使用する必要があります。

ヒントとコメント

注釈:PHP 4.3.0から、以下のように使用できます。 file_get_contents() ファイルを文字列に読み込んで返します。

注釈:PHP 4.3.0から、file()はバイナリファイルに安全に使用できます。

注釈:PHPがMacintoshファイルの行終端記号を認識できない場合、auto_detect_line_endings実行時オプションを有効にすることができます。

<?php
print_r(file("test.txt"));
?>

出力:

配列
(
[0] => こんにちは、世界。テストテスト!
[1] => また別の日に、また別のライン。
[2] => 配列がこのラインを拾う場合、
[3] => それがピックアップラインでしょうか?
)