文件读写:三个函数覆盖九成场景
file_get_contents 与 file_put_contents 的适用边界、fopen 逐行读大文件、追加写入与文件锁、编码与换行符问题。
PHP 读写文件有两套 API:一套是一句话搞定的小文件操作,一套是打开句柄逐块处理的大文件操作。选错会影响内存和并发安全。
小文件:一句话
<?php
$text = file_get_contents('data.txt');
file_put_contents('data.txt', $text . "\n新的一行");
// 追加 + 加锁,防止并发写乱
file_put_contents('log.txt', $line . "\n", FILE_APPEND | LOCK_EX);file_get_contents 会把整个文件读进内存。读几十 KB 的配置、模板没问题,读几百 MB 的日志就会把内存打满。file_put_contents 同理。
FILE_APPEND 表示追加而不是覆盖,LOCK_EX 表示写入时加排他锁。多个进程同时写同一个日志文件时,不加锁会互相覆盖。
大文件:逐行读
$fh = fopen('big.log', 'r');
if ($fh === false) {
throw new RuntimeException('打不开文件');
}
while (($line = fgets($fh)) !== false) {
// 逐行处理,内存恒定
}
fclose($fh);fgets 一次读一行,内存占用稳定。判断结束必须用 !== false,因为读到空行时返回的是 "\n",用 if (!$line) 会提前退出。
写大文件用 fwrite 分块写,配合 fflush 控制刷盘频率。别在循环里反复 fopen/fclose,开销很大。
编码与换行
Windows 的文本文件换行是 \r\n,Linux 是 \n。读取时用 rtrim($line, "\r\n") 统一去掉,写 CSV 时用 \n 更通用。
UTF-8 文件不要带 BOM。BOM 会在输出前多三个字节,导致 header() 报「headers already sent」。用编辑器的「UTF-8 无 BOM」保存。
路径与权限
拼接路径用 __DIR__ 而不是相对路径。相对路径依赖当前工作目录,在 CLI 和 FPM 下可能不一样。写文件前确认目录存在且 Web 用户有写权限,否则会静默失败或只报一个警告。
安全提醒:任何用用户输入拼出来的文件路径都必须校验。用 basename() 去掉目录部分,再和白名单比对,防止 ../../etc/passwd 这类路径穿越。