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, "xEFxBBxBF") 去 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') 分步验证,比直接读更稳。