php写小文件慢通常不是fopen/fwrite本身问题,而是磁盘i/o、文件系统或误用导致;应先用microtime确认耗时,复用文件句柄或改用file_put_contents,避免冗余flock和is_file检查,并排查底层存储性能。

PHP fopen() + fwrite() 写小文件太慢?先确认是不是真慢
很多开发者一遇到“创建文件慢”,就急着加缓存或换方案,但实际可能是误判。PHP 创建一个空文件(fopen('a.txt', 'w') + fclose())本身只要几微秒;真正拖慢的往往是磁盘 I/O 模式、文件系统特性或错误的调用方式。先用 microtime(true) 包裹关键段,确认耗时是否真在写入环节——比如日志中单次 fwrite() 耗时超过 1ms,才值得深挖。
避免频繁打开/关闭文件:复用 resource 或改用 file_put_contents()
反复调用 fopen()/fclose() 会触发多次系统调用和元数据更新,尤其在 NFS 或某些容器挂载卷上更明显。如果需连续写多段内容,优先保持句柄打开:
$fp = fopen('log.txt', 'a');
fwrite($fp, "line1\n");
fwrite($fp, "line2\n");
fwrite($fp, "line3\n");
fclose($fp); // 仅一次 close
若只是单次写入,file_put_contents() 比手动 fopen/fwrite 更快,它内部做了优化(如自动使用 O_WRONLY | O_APPEND | O_CREAT 标志),且支持原子写入(配合 FILE_APPEND 和 LOCK_EX):
- 不用自己处理
flock()就能安全追加:file_put_contents('log.txt', "data\n", FILE_APPEND | LOCK_EX) - 写入前不检查文件是否存在,省去
is_file()开销 - 注意:不要在循环里反复调用它写小数据,那反而比复用句柄慢
禁用 flock() 或改用进程级锁,除非真需要跨进程同步
默认情况下,file_put_contents() 加 LOCK_EX 会触发 flock() 系统调用,而某些文件系统(如 ext4 的某些 mount 选项、NFSv3)对 flock() 支持不佳,可能阻塞数百毫秒。如果你的写操作是单进程内串行(比如 CLI 脚本逐条处理),根本不需要文件锁:
立即学习“PHP免费学习笔记(深入)”;
- 去掉
LOCK_EX:直接file_put_contents('x.txt', $data) - 若需并发安全但不想依赖
flock(),可用sem_acquire()做内存锁(前提是 PHP 启用了 sysvsem 扩展) - 日志类场景可考虑先写到内存(
ob_start()+ob_get_clean()),再批量落盘
检查底层存储和 PHP 配置:opcache.enable 不影响写入,但 output_buffering 可能干扰
写入性能瓶颈几乎从不来自 PHP 解释器本身,而在于存储层。几个关键排查点:
- 确认不是写到了低速设备:比如 Docker 容器把
/var/www挂载为 VirtualBox Shared Folder,实测写入速度可能只有 1MB/s 以下 - 检查磁盘是否满或 inodes 耗尽:
df -h和df -i -
output_buffering是输出缓冲,和文件写入无关;但如果你在echo后立刻file_put_contents(),且启用了implicit_flush,可能引发意外 flush 行为 - PHP-FPM 场景下,确保不是因
slowlog或request_terminate_timeout导致写入被中断
最常被忽略的是:你以为在写 SSD,其实代码跑在 CI/CD 的临时 VM 里,根盘是机械硬盘还开了全盘加密。











