php file 函數
file
( PHP 4中, PHP 5中)
file-讀取整個file到一個數組
描述
一系列file(字符串$file[摘要$國旗= 0 [ ,資源$背景] ] )
讀取整個file到一個數組。
注:您可以使用file_get_contents ( )返回file內容作為一個字符串。
參數
file名
file路徑。
提示
網址可以用來作為file名與此功能,如果打開包裝已啟用。見fopen ( )函數的更多細節關於如何指定file名和列表支持的協議/封裝協議的列表,支持的URL協議。
旗幟
可選參數可以是一個標志,或以上,以下常數:
FILE_USE_INCLUDE_PATH
搜索該file中的include_path中。
FILE_IGNORE_NEW_LINES
不添加新行結束時,每個數組元素
FILE_SKIP_EMPTY_LINES
跳過空行
FILE_TEXT
返回的內容是在UTF - 8編碼。您可以指定一個不同的編碼,建立一個自定義的范圍內。此標志不能用於FILE_BINARY 。此標志只適用於自PHP 6 。
FILE_BINARY
內容改為二進制數據。這是默認設置,並不能用於FILE_TEXT 。此標志只適用於自PHP 6 。
背景
背景資源創建的stream_context_create ( )函數。
注:情況下,支持加用PHP 5.0.0 。為說明情況,請參閱流功能。
返回值
返回file中的數組。每個元素的數組對應行中的file,仍與換行符重視。一旦失敗,file( )返回FALSE 。
注意:每行中所產生的陣列將包括行結尾,除非FILE_IGNORE_NEW_LINES使用,所以你仍然需要使用rtrim ( )如果你不想結束本線。
注:如果PHP沒有正確認識到行結尾時,無論是閱讀file或創建的Macintosh電腦,使auto_detect_line_endings運行時配置選項可能有助於解決這個問題。
修改
版本說明
6.0.0新增了支援FILE_TEXT和FILE_BINARY旗幟。
5.0.0背景參數增加
5.0.0到PHP 5.0.0之前的旗幟參數只覆蓋include_path中,並啟用了1
4.3.0file( )成為二進制安全
實例
例如1號file( )的例子
// 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 #{$line_num} : " . htmlspecialchars($line) . "
n";
}
// Another example, let's get a web page into a string. See also file_get_contents().
$html = implode('', file('http://www.example.com/'));
// Using the optional flags parameter since PHP 5
$trimmed = file('somefile.txt', FILE_IGNORE_NEW_LINES | FILE_SKIP_EMPTY_LINES);
?>