定義和用法

file() 函數(shù)把整個(gè)文件讀入一個(gè)數(shù)組中。

與 file_get_contents() 類(lèi)似，不同的是 file() 將文件作為一個(gè)數(shù)組返回。數(shù)組中的每個(gè)單元都是文件中相應(yīng)的一行，包括換行符在內(nèi)。

如果失敗，則返回 false。

語(yǔ)法

file(path,include_path,context)

參數(shù)	描述
path	必需。規(guī)定要讀取的文件。
include_path	可選。如果也想在 include_path 中搜尋文件的話(huà)，可以將該參數(shù)設(shè)為 "1"。
context	可選。規(guī)定文件句柄的環(huán)境。 context 是一套可以修改流的行為的選項(xiàng)。若使用 null，則忽略。

說(shuō)明

對(duì) context 的支持是 PHP 5.0.0 添加的。

返回的數(shù)組中每一行都包括了行結(jié)束符，因此如果不需要行結(jié)束符時(shí)還需要使用 rtrim() 函數(shù)。

提示和注釋

注釋?zhuān)?/span>從 PHP 4.3.0 開(kāi)始，可以用 file_get_contents() 來(lái)將文件讀入到一個(gè)字符串并返回。

注釋?zhuān)?/span>從 PHP 4.3.0 開(kāi)始，file() 可以安全用于二進(jìn)制文件。

注釋?zhuān)?/span>如果碰到 PHP 在讀取文件時(shí)不能識(shí)別 Macintosh 文件的行結(jié)束符，可以激活 auto_detect_line_endings 運(yùn)行時(shí)配置選項(xiàng)。

例子

<?php
print_r(file("test.txt"));
?> 

輸出：

Array
(
[0] => Hello World. Testing testing!
[1] => Another day, another line.
[2] => If the array picks up this line,
[3] => then is it a pickup line?
)