file_put_contents写入失败时返回false，成功时返回非负整数（含0），应使用=== false严格判断；常见失败原因包括目录不存在、权限不足、磁盘满等。
file_put_contents 写入失败时怎么知道结果
file_put_contents 不会抛出异常，它直接返回写入的字节数（成功）或 false（失败）。这是判断成败最直接的方式，而不是靠“有没有报错”或“文件是否存在”来推测。
- 返回非负整数（如
12、0）→ 成功，数字是实际写入的字节数（空字符串也会返回0） - 返回
false→ 失败（常见原因：目录不存在、权限不足、磁盘满、路径含非法字符） - 不要用
=== true判断，因为成功时返回的是整数，不是布尔值
正确检查写入结果的写法示例
别写成 if (file_put_contents(...)) { ... } —— 这在写入 0 字节时会误判为失败。
if (false === file_put_contents('/tmp/log.txt', $data)) {
error_log('写入失败：' . error_get_last()['message']);
} else {
// 成功，无需额外处理
}
更稳妥的做法是捕获返回值：
$bytes = file_put_contents('/tmp/data.json', json_encode($data));
if ($bytes === false) {
throw new RuntimeException('无法保存数据到 /tmp/data.json');
}
// $bytes 是实际写入字节数，可用于日志或调试
error_log("已写入 {$bytes} 字节");
影响写入结果的几个关键参数和坑
file_put_contents 的第三个参数常被忽略，但它直接影响“是否追加”“是否原子写入”等行为，进而影响结果含义：
