phpファイルの関数
ファイル
(PHP 4、PHP 5)
file - ファイル全体を配列に読み取ります
説明
ファイルのリスト (文字列 $file[abstract$flag=0[,resource$background]])
ファイル全体を配列に読み取ります。
注: file_get_contents() を使用すると、ファイルの内容を文字列として返すことができます。
パラメータ
ファイル名
ファイルパス。
ヒント
オープンパッケージが有効な場合、この機能では URL をファイル名として使用できます。ファイル名の指定方法の詳細については fopen() 関数を、サポートされる URL プロトコルのリストについてはサポートされるプロトコル/カプセル化プロトコルのリストを参照してください。
旗
オプションの引数には、フラグ、またはそれ以上の次の定数を指定できます:
FILE_USE_INCLUDE_PATH
このファイルで include_path を検索します。
FILE_IGNORE_NEW_LINES
各配列要素の末尾に新しい行を追加しない
FILE_SKIP_EMPTY_LINES
空行をスキップ
ファイルテキスト
返されるコンテンツは UTF-8 エンコードです。別のエンコードを指定してカスタム範囲を作成できます。このフラグは FILE_BINARY では使用できません。このフラグは PHP 6 以降でのみ機能します。
ファイル_バイナリ
内容はバイナリデータに変更されます。これはデフォルト設定であり、FILE_TEXT では使用できません。このフラグは PHP 6 以降でのみ機能します。
背景
バックグラウンドリソースを作成するための stream_context_create() 関数。
注: この場合、PHP 5.0.0 がサポートされます。説明するには、ストリーム関数を参照してください。
戻り値
ファイル内の配列を返します。配列の各要素は、改行が付加されたままのファイル内の行に対応します。失敗すると、file() は FALSE を返します。
注: FILE_IGNORE_NEW_LINES が使用されない限り、結果の配列の各行には行の終わりが含まれるため、行を終了したくない場合でも rtrim() を使用する必要があります。
注: ファイルの読み取り時または Macintosh の作成時に PHP が行末を正しく認識しない場合は、auto_detect_line_endings ランタイム構成オプションを有効にすると、この問題の解決に役立つ可能性があります。
変更
リリースノート
6.0.0 では、FILE_TEXT フラグと FILE_BINARY フラグのサポートが追加されています。
5.0.0 背景パラメーターが追加されました
5.0.0 から 5.0.0 より前の PHP では、フラグ パラメーターは include_path でのみオーバーライドされ、1 が有効になりました
4.3.0file() がバイナリセーフになります
例
例えば、ファイルNo.1( )の例
// ファイルを配列に取得します。この例では、HTTP を介して get
を実行します。
// URL の HTML ソース
$lines = file('http://www.example.com/');
// 配列をループし、HTML ソースを HTML ソースとして表示し、行番号も表示します。
foreach ($lines as $line_num => $line) {
echo "行番号{$line_num}: " .htmlspecialchars($line) "
ん」;
}
// 別の例として、Web ページを文字列に取得してみましょう。 file_get_contents() も参照してください。
$html = implode('', file('http://www.example.com/'));
$trimmed = file('somefile.txt', FILE_IGNORE_NEW_LINES | FILE_SKIP_EMPTY_LINES);
?>