运行实例»定义和用法file()函数把整个文件读入一个数组中。">

file()

创建于 2024-12-03 / 28
字体: [默认] [大] [更大]
❮ PHP 文件系统参考手册

实例

将文件读入数组:

<?php
print_r(file("test.txt"));
?> 运行实例 »

定义和用法

file() 函数把整个文件读入一个数组中。

file_get_contents() 类似,不同的是 file() 将文件作为一个数组返回。数组中的每个单元都是文件中相应的一行,包括换行符在内。

如果失败,则返回 false。

语法

file(filename, flag, context)

参数值

context 是一套可以修改流的行为的选项。若使用 null,则忽略。

参数 描述
filename 必需。规定要读取的文件。
flag 可选。 可以是以下一个或多个常量:
  • FILE_USE_INCLUDE_PATH - 在 include_path 中搜索文件(在 php.ini 中)
  • FILE_IGNORE_NEW_LINES - 跳过每个数组元素末尾的换行符
  • FILE_SKIP_EMPTY_LINES - 跳过文件中的空行
context

说明

context 的支持是 PHP 5.0.0 添加的。

返回的数组中每一行都包括了行结束符,因此如果不需要行结束符时还需要使用 rtrim() 函数。


提示和注释

注释:从 PHP 4.3.0 开始,可以用 file_get_contents() 来将文件读入到一个字符串并返回。

注释:从 PHP 4.3.0 开始,file() 可以安全用于二进制文件。

注释:如果碰到 PHP 在读取文件时不能识别 Macintosh 文件的行结束符,可以激活 auto_detect_line_endings 运行时配置选项。



技术细节

返回值: 数组中的整个文件,失败为 FALSE
PHP 版本: 4.0+
Binary Safe: Yes, in PHP 4.3

❮ PHP 文件系统参考手册
0 人点赞过