file_put_contents写入失败主因是路径不存在、权限不足或编码问题；需手动创建父目录、统一utf-8编码并去除bom，高并发或大文件场景应换用fopen等替代方案。
file_put_contents 写入失败的常见原因
直接用 file_put_contents 却没生成文件或内容为空，大概率不是函数写错了，而是路径、权限或编码惹的祸。它默认以 FILE_TEXT 模式写入，不自动创建父目录，也不处理 BOM 或换行符差异。
- 路径是相对路径时，当前工作目录（
getcwd()）决定实际位置，不是脚本所在目录 - 目标目录不存在会直接失败，返回
false，不会报错但静默失败 - Linux 下若 Web 用户（如
www-data）无写权限，或 SELinux 限制，也会失败 - Windows 下用
\n写入文本，在记事本里可能显示为一行——得用\r\n
正确写入带目录创建的文件
别硬扛，先确保路径存在。PHP 8.0+ 可用 dirname($path) + mkdir(..., 0755, true)；老版本也一样，关键是第三个参数 true 启用递归创建。
$path = '/var/log/app/output.log';
$dir = dirname($path);
if (!is_dir($dir) && !mkdir($dir, 0755, true) && !is_dir($dir)) {
throw new RuntimeException("Cannot create directory: $dir");
}
file_put_contents($path, "log entry at " . date('c') . "\n", FILE_APPEND | LOCK_EX);
注意：FILE_APPEND 避免覆盖，LOCK_EX 防止并发写乱序——尤其在 CLI 多进程或高并发 Web 场景下不能省。
中文内容写入乱码或 BOM 问题
如果写入中文后用记事本打开显示乱码，大概率是源文件是 UTF-8 无 BOM，但你用的编辑器/终端默认当 GBK 解码；更隐蔽的是，有些框架或 IDE 会在文件头偷偷加 BOM，导致 file_put_contents 写出带 BOM 的文件，后续 JSON 解析或 include 就会出错。
- 写入前用
mb_convert_encoding($content, 'UTF-8', 'auto')统一编码 - 坚决不用
utf8_encode()——它只把 ISO-8859-1 转 UTF-8，对 GBK/GB2312 无效 - 若需排除 BOM，可手动截掉开头三字节：
ltrim($content, "\xEF\xBB\xBF") - 写日志类文本推荐加
FILE_TEXT标志（PHP 7.4+），它会禁用二进制模式，避免某些系统下换行异常
替代方案：什么时候不该用 file_put_contents
单次写入小文本没问题，但以下情况建议换方式：
- 要频繁追加（比如每秒多次写日志），
file_put_contents每次都 open-write-close，开销大；改用fopen+fwrite+fflush复用句柄 - 写入超大字符串（>2MB），可能触发内存限制或超时；应分块写或用
stream_copy_to_stream - 需要原子写入（防止读到半截内容），
file_put_contents($tmp, $data); rename($tmp, $real)是唯一可靠方式 - 写入远程路径（如
sftp://或ftp://），该函数不支持，得用 cURL 或 SSH 扩展
最常被忽略的一点：它不校验磁盘空间。写入前用 disk_free_space() 粗略判断，比写崩了再查日志强得多。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
