file

(PHP 3, PHP 4 )

file -- Reads entire file into an array

Description

array file ( string filename [, int use_include_path])

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.

注: Each line in the resulting array will include the line ending, so you still need to use trim() if you do not want the line ending present.

注: 如果遇到 PHP讀取麥金塔電腦格式檔案時 無法辨識行結束的問題, 可能可以試著起動執行時期組態選項的auto_detect_line_endings

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/'));
? 


注: 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.

提示: 如果fopen wrappers已啟動,則可藉此函數把檔名當成URL使用。 參考fopen()有更多關於如何指定檔名的細節 和附錄 I支援URL協定的列表。

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