file_get_contents()适合读取≤1MB的小文件(如配置文件、JSON)、需简洁获取完整字符串的场景,支持远程URL和context参数定制,但会整块加载内存,不适用于大文件。

直接说结论:小文件用 file_get_contents(),大文件或需逐行处理时用 fopen() + fgets() 或 file()(慎用内存)。
file_get_contents() 适合什么场景?
这是最常用、最简洁的读取方式,一次性把整个文件内容作为字符串返回。它底层封装了 fopen/fread,自动处理编码和错误,适合配置文件、JSON、小文本(一般 ≤ 1MB)。
- 支持远程 URL(如
file_get_contents('https://api.example.com/data.json')),但需开启allow_url_fopen - 可传入
context参数控制超时、User-Agent 等,比如设置 5 秒超时:$ctx = stream_context_create(['http' => ['timeout' => 5]]); file_get_contents('https://example.com', false, $ctx); - 不支持边读边处理——整块加载进内存,文件太大容易触发
Allowed memory size exhausted
file() 和 file_get_contents() 有什么关键区别?
file() 返回的是按行切分的数组(每行末尾含换行符 \n),而 file_get_contents() 返回原始字符串。别以为 file() 更“轻量”,它其实也是一次性全载入内存,且额外做了 explode("\n") 操作,内存占用通常更高。
- 想快速获取某一行?
file()可以直接用索引:$lines = file('log.txt'); echo $lines[0];,但不如file_get_contents()+explode()灵活 - 读 CSV 或日志时若需跳过首行,用
file()后array_shift($lines)很直观;但若文件超 10MB,file()极易 OOM -
file()默认会忽略空行和末尾换行,行为受FILE_IGNORE_NEW_LINES和FILE_SKIP_EMPTY_LINES标志影响,容易误判格式
fopen() + fgets() 是大文件唯一靠谱方案
当文件几十 MB 甚至上 GB(如访问日志、导出数据),必须流式读取。核心是:打开句柄 → 循环 fgets() → 处理单行 → 关闭句柄。内存只保留当前行,完全可控。
立即学习“PHP免费学习笔记(深入)”;
-
fgets()默认最多读 1024 字节/行,超长行会被截断;安全做法是显式指定长度:fgets($fp, 8192) - 注意检测
false判断 EOF,别用!feof($fp)做 while 条件,否则可能多读一次空行 - 示例片段:
$fp = fopen('huge.log', 'r'); if ($fp) { while (($line = fgets($fp, 4096)) !== false) { // 处理 $line,比如匹配关键字或写入数据库 if (strpos($line, 'ERROR') !== false) { error_log($line); } } fclose($fp); }
容易被忽略的细节和坑
编码问题、权限、路径、BOM 头、换行符差异这些看似基础的问题,在真实项目里高频出错。
- Windows 写的文件在 Linux 下读取,
\r\n可能导致trim()失效,建议统一用str_replace(["\r\n", "\r"], "\n", $line) -
file_get_contents()读取 UTF-8 BOM 文件时,开头三个字节\xEF\xBB\xBF会混入字符串,造成 JSON 解析失败,需手动去除:ltrim($content, "\xEF\xBB\xBF") - 相对路径基于当前工作目录(
getcwd()),不是脚本所在目录,推荐用__DIR__ . '/data/config.json' - Apache/Nginx 下 PHP 进程用户(如
www-data)可能无权读取某些路径,报错failed to open stream: Permission denied,别只查文件权限,也要查父目录执行权限(x)











