PHP文件读写需按场景选函数:小文件用file_get_contents()/file_put_contents();大文件用fopen()配合fgets()/fwrite();权限/锁/二进制操作用底层指针函数;须注意路径安全、权限控制与编码问题。

PHP 文件读写操作核心在于选择合适的函数匹配具体需求:小文件用 file_get_contents() 和 file_put_contents() 最简洁;大文件或需逐行处理时用 fopen() 配合 fgets()、fwrite();需要精确控制权限、锁机制或二进制操作时,必须使用底层文件指针函数。
快速读写小文本文件(推荐新手)
适用于配置文件、日志片段、JSON 数据等几 MB 以内的文本内容。
-
读取整个文件:
file_get_contents('data.txt')直接返回字符串,失败返回false;支持远程 URL(需开启allow_url_fopen) -
写入/覆盖文件:
file_put_contents('log.txt', "新增一行\n", FILE_APPEND)第三个参数可选FILE_APPEND追加,或LOCK_EX加写锁防并发冲突 - 注意:这两个函数不支持部分写入或指定偏移,也不适合处理超大文件(易内存溢出)
按行或分块处理大文件(避免内存爆掉)
处理日志分析、CSV 导入、超大日志轮转等场景,必须流式操作。
-
逐行读取:
$fp = fopen('access.log', 'r'); while (($line = fgets($fp)) !== false) { echo $line; } fclose($fp); -
读取指定字节数:
fread($fp, 8192)每次读 8KB,适合二进制或自定义分隔解析 -
写入时控制位置:
fseek($fp, 0, SEEK_END)移动到末尾再写,或ftruncate($fp, 0)清空文件
安全与权限控制要点
生产环境务必检查路径合法性、权限和编码,否则易引发路径遍历、乱码或写入失败。
立即学习“PHP免费学习笔记(深入)”;
-
防止目录穿越:用
realpath()规范路径,再判断是否在允许目录内,例如:if (strpos(realpath($file), '/var/www/data') !== 0) die('非法路径'); -
写入前检测权限:
is_writable(dirname($file))确保父目录可写;创建文件后建议用chmod($file, 0644)设定合理权限 -
中文内容注意编码:PHP 默认按字节操作,含中文时确保源文件与脚本同为 UTF-8,必要时用
mb_convert_encoding()转换
常见错误与避坑提示
很多问题不是函数不会用,而是忽略了上下文约束。
- Warning: file_get_contents(): failed to open stream → 检查文件路径是否存在、Web 用户(如 www-data)是否有读权限、SELinux 是否拦截
-
写入内容为空或乱码 → 查看文件打开模式(
'w'会清空,'a'才追加);确认输出是否被ob_start()缓存未 flush -
fgets() 卡住或返回 false → 可能文件已被其他进程独占写入,或磁盘已满;建议配合
stream_set_timeout($fp, 5)设置超时
基本上就这些。掌握这四类用法,90% 的 PHP 文件处理需求都能稳稳拿下。关键不是记函数名,而是理解“什么场景该用什么方式”。











