函数名:file()
适用版本:PHP 4, PHP 5, PHP 7
用法:file() 函数将整个文件读入一个数组中。每个数组元素对应文件中的一行,包括换行符。
语法:file(string $filename, int $flags = 0, resource $context = null): array|false
参数:
- $filename:要读取的文件名,可以是本地文件或远程文件的URL。
- $flags(可选):用于指定文件读取模式的标志。默认为 0,表示以普通的文本模式读取文件。
- $context(可选):用于指定上下文的资源句柄,可以在函数调用中指定更多的参数。
返回值:返回包含文件内容的数组,每个数组元素对应文件中的一行。如果读取文件失败,则返回 false。
示例:
- 读取本地文件并输出每一行的内容:
$lines = file("example.txt");
foreach ($lines as $line) {
echo $line;
}
- 读取远程文件并将内容存储在数组中:
$lines = file("http://example.com/file.txt");
print_r($lines);
- 读取文件时指定读取模式和上下文:
$lines = file("example.txt", FILE_IGNORE_NEW_LINES | FILE_SKIP_EMPTY_LINES, $context);
print_r($lines);
注意事项:
- 如果要读取大型文件,建议使用逐行读取的方式,而不是将整个文件读入数组中,以避免内存占用过大。
- 如果文件读取失败,可通过检查返回值是否为 false 来进行错误处理。
- 在读取远程文件时,确保 PHP 配置中启用了相关的网络函数和选项。