PHP读取文件首选file_get_contents()处理小中型文本,大文件用fopen()+fgets()逐行读取,file()适合小文件按行拆分;需注意BOM、编码、权限、路径及错误检查。

PHP 读取文件最常用的是 file_get_contents()
它适合小到中等大小的文本文件(比如配置、JSON、HTML 片段),一行代码就能拿到全部内容,不用手动打开/关闭流。
echo file_get_contents('config.json');注意:file_get_contents() 默认以二进制安全方式读取,但不会自动处理编码。如果文件是 UTF-8 BOM 开头,json_decode() 可能报 JSON_ERROR_UTF8;建议先用 trim($content, "\xEF\xBB\xBF") 去 BOM。
大文件或需要逐行处理时用 fopen() + fgets()
避免内存爆炸,尤其读日志、CSV 或超 10MB 的文本。
$fp = fopen('access.log', 'r');
while (($line = fgets($fp)) !== false) {
echo trim($line) . "\n";
}
fclose($fp);常见坑:
- 忘记检查
fopen()返回值是否为false(路径错、权限不足都会导致) - 没调用
fclose(),长期运行脚本可能耗尽系统文件描述符 -
fgets()保留换行符,trim()很有必要
file() 函数返回数组,适合按行切分后处理
和 file_get_contents() 不同,它自动按换行符拆成数组,每行一个元素,末尾带 \n(可用 FILE_IGNORE_NEW_LINES 去掉):
$lines = file('data.txt', FILE_IGNORE_NEW_LINES | FILE_SKIP_EMPTY_LINES);
foreach ($lines as $i => $line) {
echo "第{$i}行:{$line}\n";
}注意:file() 会把整个文件加载进内存,和 file_get_contents() 一样不适合大文件;但它比手动 fgets() 简洁,适合几百行以内的配置或列表。
读取失败时一定要检查错误原因
PHP 默认不报错,但实际常遇到:
-
Warning: file_get_contents(abc.txt): failed to open stream: No such file or directory→ 路径写错,或当前工作目录不是你认为的那个(用getcwd()确认) -
failed to open stream: Permission denied→ Web 服务器用户(如 www-data)无读权限,别只 chmod 755 目录,还要确认文件本身可读(644) - 返回空字符串但没报错 → 文件存在但为空,或被其他进程锁住(少见但 Linux 下
flock()场景会出现)
is_readable('path') 和 file_exists('path') 分步验证,比直接读更稳。











