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（ ）的例子

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

// Using the optional flags parameter since PHP 5
$trimmed = file('somefile.txt', FILE_IGNORE_NEW_LINES | FILE_SKIP_EMPTY_LINES);
?>