file_put_contents()是创建并写入文件的首选函数，它自动创建文件、覆盖写入、安全释放资源、支持原子操作且返回写入字节数；但需手动创建父目录、检查路径可写性及编码兼容性。
直接用 file_put_contents()，它就是专为“创建+写入”这一动作设计的，比 fopen()+fwrite()+fclose() 组合更安全、更简洁。
为什么 file_put_contents() 是首选
这个函数默认会在文件不存在时自动创建，存在时直接覆盖写入，一步到位。它内部已处理好资源释放和错误边界，不容易因忘记 fclose() 导致句柄泄漏或内容未刷入磁盘。
- 不需手动判断文件是否存在，也不用分三步开/写/关
- 支持原子写入（配合
FILE_APPEND或LOCK_EX标志可避免并发写乱序） - 返回实际写入字节数，便于快速校验是否写入成功（返回
false表示失败） - 对路径中父目录不存在的情况无自动创建能力——这点常被忽略，需额外处理
file_put_contents() 的常见误用场景
最典型的错误是传入了不可写的路径，或者父目录根本不存在，结果函数静默失败（返回 false），但没检查返回值就以为写进去了。
- 路径含中文或特殊字符？确保 PHP 运行环境支持对应编码（如 UTF-8），否则可能生成乱码文件名或写入失败
- 写入大文件（比如 >2MB）？默认会把整个内容载入内存再写，可能触发
memory_limit错误；此时应改用fopen()+stream_copy_to_stream()分块处理 - 想追加内容却忘了加
FILE_APPEND标志，结果旧内容被清空重写 - 权限问题：Web 服务器用户（如
www-data或_www）必须对目标目录有w权限；用is_writable()提前检测比靠报错更可靠
带目录自动创建的安全写法
如果目标路径的父目录可能不存在（例如写入 /var/log/myapp/2024/06/report.txt），file_put_contents() 本身不会建目录，得自己补上：
立即学习“PHP免费学习笔记（深入）”；
// 确保目录存在，递归创建，权限设为 0755
$dir = dirname($filepath);
if (!is_dir($dir)) {
mkdir($dir, 0755, true);
}
// 再写入文件，加上 LOCK_EX 防并发冲突
$result = file_put_contents($filepath, $content, LOCK_EX);
if ($result === false) {
error_log("Failed to write to {$filepath}");
}
-
mkdir(..., true)的第三个参数true表示递归创建，缺了它遇到多层缺失目录就会失败 -
0755是较稳妥的目录权限，太宽松（如0777）在共享主机或严格安全策略下会被拒绝 - Windows 下路径分隔符用
/或\均可，但统一用/更兼容
替代方案：什么时候不该用 file_put_contents()
当你要控制写入偏移位置、复用文件句柄、或需要精细的错误分类（比如区分“磁盘满”和“权限拒绝”）时，它就不够用了。
- 需要从指定字节位置开始写？用
fopen()+fseek()+fwrite() - 要边下载边写入大文件（如上传流）？用
fopen('php://input', 'r')配合stream_copy_to_stream() - 写入后需立即
chmod()改权限？file_put_contents()不提供该能力，得后续调用 - 日志类高频小写入？考虑先缓冲再批量落盘，否则频繁调用
file_put_contents()会拖慢性能
真正容易出问题的不是函数选错，而是路径合法性、目录可写性、并发控制这三点没兜底。哪怕只写一行，也建议包一层简单封装，把 mkdir 和 is_writable 检查固化进去。
