file

(PHP 3, PHP 4 , PHP 5)

file -- Reads entire file into an array

Description

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

Identical to readfile(), except that file() returns the file in an array. Each element of the array corresponds to a line in the file, with the newline still attached. Upon failure, file() returns FALSE.

You can use the optional use_include_path parameter and set it to "1", if you want to search for the file in the include_path, too.

<?php
// Get a file into an array.  In this example we'll go through HTTP to get
// the HTML source of a URL.
$lines = file('http://www.example.com/');

// Loop through our array, show HTML source as HTML source; and line numbers too.
foreach ($lines as $line_num => $line) {
    echo
"Line #<b>{$line_num}</b> : " . htmlspecialchars($line) . "<br />\n";
}

// Another example, let's get a web page into a string.  See also file_get_contents().
$html = implode('', file('http://www.example.com/'));
?>

Υπόδειξη: Μπορείτε να χρησιμοποιήσετε ένα URL σαν ένα όνομα αρχείου με αυτή τη συνάρτηση αν τα fopen wrappers έχουν ενεργοποιηθεί. Δείτε την fopen() για πιο πολλές λεπτομέρειες στο πώς να ορίσετε το όνομα του αρχείου και για ένα Παράρτημα J κατάλογο των υποστηριζόμενων URL προτοκόλλων.

Σημείωση: Each line in the resulting array will include the line ending, so you still need to use rtrim() if you do not want the line ending present.

Σημείωση: Αν έχετε προβλήματα με την PHP να μην αναγνωρίζει τα τέλη γραμμών όταν διαβάζει αρχεία σε, ή δημιουργημένα από, ένα Macintosh ηλεκτρονικό υπολογιστή, μπορεί να θέλετε να ενεργοποιήσετε την run-time επιλογή ρύθμισης auto_detect_line_endings.

Σημείωση: As of PHP 4.3.0 you can use file_get_contents() to return the contents of a file as a string.

In PHP 4.3.0 file() became binary safe.

Σημείωση: Context support was added with PHP 5.0.0.

Προειδοποίηση

Some non-standard compliant webservers, such as IIS, send data in a way that causes PHP to raise warnings. When working with such servers you should lower your error_reporting level not to include warnings.

See also readfile(), fopen(), fsockopen(), popen(), file_get_contents(), and include().