日常写文件优先用 file_put_contents()；需流式写入、追加控制、权限精细设置或大文件分块处理时才用 fopen()+fwrite()。前者简洁适合日志、配置、缓存等轻量操作，后者灵活可控但需手动管理资源。
直接说结论：日常写文件优先用 file_put_contents()；需要流式写入、追加控制、权限精细设置或大文件分块处理时，才上 fopen() + fwrite()。
file_put_contents() 适合什么场景
它是一次性把字符串写进文件的“快捷函数”，底层自动处理打开、写入、关闭三步。常见于日志记录、配置生成、缓存写入等轻量操作。
- 默认覆盖写入，加
FILE_APPEND标志可追加（但注意并发下可能错位） - 支持原子写入：
FILE_ATOMIC_WRITE（仅 Linux，需临时文件支持，避免写到一半被读） - 权限控制弱：只能靠 umask 或后续
chmod()补救，不支持直接设 mode 参数（PHP 8.1+ 才在第三个参数加context间接影响） - 内存敏感：整个内容必须加载进内存，写 GB 级文件会爆内存
示例：file_put_contents('log.txt', "error: timeout\n", FILE_APPEND | LOCK_EX); —— 加 LOCK_EX 能缓解并发追加冲突，但不是万能锁。
fopen() + fwrite() 的控制力在哪
这是底层流操作，自由度高，但也意味着你要自己管好每一步：打开是否成功、写入是否完整、是否要 flush、最后是否 fclose。
立即学习“PHP免费学习笔记（深入）”；
- 可指定打开模式：
'a'（追加）、'c'（截断前检查是否存在）、'x'（只新建，存在即失败），比file_put_contents()的标志更明确 - 能逐段写入：
fwrite($fp, $chunk)配合循环，处理大文件或网络流数据无压力 - 权限可精确控制：
fopen('data.bin', 'wb', false, stream_context_create(['http' => ['timeout' => 5]]))可传 context，还能用chmod()紧跟设置 - 错误反馈更细：返回 resource 或
false，可用ferror()查具体 IO 错误
示例：$fp = fopen('cache.json', 'c'); if ($fp && fwrite($fp, json_encode($data))) { fclose($fp); } —— 'c' 模式确保不会意外覆盖正在被读的旧文件。
容易踩的坑：LOCK_EX 不等于线程安全
两个函数都支持 LOCK_EX，但它只是对当前进程起作用的 advisory lock（建议性锁），Linux 下依赖 flock，Windows 下是 byte-range lock。如果另一段代码用 fopen() 但没加锁，或者用 shell 命令直接 touch 文件，锁就形同虚设。
-
file_put_contents(..., LOCK_EX)是阻塞锁，写不完其他进程会卡住 -
flock($fp, LOCK_EX)可设非阻塞：flock($fp, LOCK_EX | LOCK_NB)，失败立即返回 false - PHP-FPM 多 worker 场景下，
LOCK_EX有效；但 CLI 多进程或跨语言调用时，得换 Redis 分布式锁或文件系统级机制
性能与兼容性差异
小文件（fopen() 的流式写法内存稳定，而 file_put_contents() 可能触发 GC 压力。
- PHP 5.4+
file_put_contents()支持数组作为数据源（自动 implode("\n")），fopen()不支持，得自己处理 - Windows 下
file_put_contents()对 \r\n 换行处理更一致；fwrite()写文本时若没设二进制模式，可能被 PHP 自动转换 - 某些容器环境（如 OpenShift）禁用
flock()，此时LOCK_EX失效，得退回到重命名原子提交方案
真正复杂的是权限继承、NFS 挂载点上的锁行为、以及 SELinux 上下文限制——这些没法靠函数选型解决，得查 ls -Z 和 audit.log。
