定義和用法
file - 把整個文件讀入一個數組中
版本支持
PHP4 | PHP5 | PHP7 |
---|---|---|
支持 | 支持 | 支持 |
5.0.0 增加了參數 context
5.0.0 在PHP 5.0.0之前,flags參數僅包含include_path並已啓用1
4.3.0 file() 開始是二進制安全的
語法
file ( string $filename [, int $flags = 0 [, resource $context ]] )
參數
- FILE_USE_INCLUDE_PATH - 在包含文件夾中查找文件。
- FILE_IGNORE_NEW_LINES - 在數組每個元素的末尾不要添加換行符
- FILE_SKIP_EMPTY_LINES - 跳過空行
參數 | 必需的 | 描述 |
---|---|---|
filename | 是 | 文件的路徑。
如已啓用allow_url_fopen,在此函數中, URL 可作爲文件名。 |
flags | 否 | 可選參數 flags 可以是以下一個或多個常量: |
context | 否 | 使用stream_context_create() 創建的有效上下文資源。 如果您不需要自定義context,可以用NULL來忽略。 |
返回值
返回數組中的文件。 數組的每個元素對應於文件中的一行,並且換行符仍然附加。 失敗時,file()返回FALSE。
// 將一個文件讀入數組。本例中通過 HTTP 從 URL 中取得 HTML 源文件。
$lines = file('http://www.example.com/');
// 在數組中循環,顯示 HTML 的源文件並加上行號。
foreach ($lines as $line_num => $line) {
echo "行號: #<b>{$line_num}</b> : " . htmlspecialchars($line) . "<br />\n";
}
// 另一個例子將 web 頁面讀入字符串。參見 file_get_contents()。
$html = implode('', file('http://www.example.com/'));
// 從 PHP 5 開始可以使用可選標記參數
$trimmed = file('somefile.txt', FILE_IGNORE_NEW_LINES | FILE_SKIP_EMPTY_LINES);
相關函數
readfile() - 輸出文件
fopen() - 打開文件或者 URL
fsockopen() - 打開一個網絡連接或者一個Unix套接字連接
popen() - 打開進程文件指針
file_get_contents() - 將整個文件讀入一個字符串
include - 包含文件