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 的第三个参数常被忽略，但它直接影响“是否追加”“是否原子写入”等行为，进而影响结果含义：
立即学习“PHP免费学习笔记（深入）”；
-
FILE_APPEND：追加写入，返回值是本次追加的字节数，不是文件总大小 -
LOCK_EX：加独占锁，避免并发写乱序；但若锁失败（如 NFS 挂载），可能返回false，而错误信息不明显 - 同时用
FILE_APPEND | LOCK_EX是安全追加的标配，但注意 Windows 下对网络路径支持不稳定 - 没指定
FILE_USE_INCLUDE_PATH时，路径必须是绝对路径或相对当前工作目录（getcwd()），不是相对于脚本位置
写入后验证结果的必要场景
仅靠 file_put_contents 返回值还不够，某些关键存储需二次确认：
- 写入配置文件后，立刻
include或json_decode(file_get_contents(...))验证格式是否合法 - 写入缓存文件后，用
is_readable()+filesize() > 0排除“写入了空内容”的静默失败 -
敏感数据落盘后，建议调用
clearstatcache(true, $path)避免因文件系统缓存导致file_exists()判断滞后 - PHP 8.1+ 中，若启用了
opcache.enable_file_override=1，file_put_contents可能触发 opcache 自动清除，但不保证立即生效——此时读取刚写入的内容仍可能命中旧缓存
file_put_contents 的返回值只是第一道防线，真正可靠的“写入成功”，往往得结合路径可写性预检、内容合法性验证、以及必要时的读回校验。 
