file

(PHP 3, PHP 4 )

file --  Liest eine Datei komplett in einen Array

Beschreibung

array file ( string filename [, int use_include_path])

Die Funktion file() ist identisch mit readfile(), außer dass die eingelesene Datei als Array zurückgegeben wird. Jedes Feld des Arrays korrespondiert mit einer Zeile der Datei. Der Zeilenumbruch bleibt erhalten.

Anmerkung: Jede Zeile in dem resultierenden Array enthält das Zeilenende ('\0'), weshalb Sie trim() verwenden müssen, falls Sie dieses Zeichen nicht vorhanden sein soll.

Optional kann der zweite Parameter benutzt und auf '1' gesetzt werden, wenn in dem include_path ebenfalls nach der Datei gesucht werden soll.

<?php
// liest eine Webseite in einen Array und gibt das Ergebnis aus
$fcontents = file ('http://www.example.com/');
while (list ($line_num, $line) = each ($fcontents)) {
    echo "<b>Line $line_num:</b>; ", htmlspecialchars ($line), "<br>\n";
}

// liefert eine Webseite in einen String
$fcontents = implode ('', file ('http://www.example.com/'));
?>

Anmerkung: Ab PHP 4.3.0 können Sie file_get_contents() verwenden, um den Inhalt einer Datei als binären String zu bekommen.

Warnung

Diese Funktion ist (bis jetzt) nicht binary safe!

Tipp: Mit dieser Funktion können Sie eine URL als Dateinamen verwenden, falls Sie "fopen wrappers" ermöglicht haben. Für mehr Details siehe fopen().

Siehe auch readfile(), fopen(), fsockopen() und popen().