file_put_contents()写入失败典型原因有三：路径不存在、权限不足、磁盘满；必须检查返回值是否为false，而非仅依赖警告。
file_put_contents() 写入失败的典型报错
直接看到 PHP Warning: file_put_contents(): failed to open stream，基本就是三类问题：路径不存在、权限不够、磁盘满了。它不是语法错误，脚本不会中断，但数据确实没写进去——你得确认 file_put_contents() 返回值是否为 false，而不是只靠有没有警告来判断成败。
路径必须存在且可写，不能只靠拼接
用相对路径（比如 'logs/app.log'）时，PHP 是以当前执行脚本所在目录为基准，不是 Web 根目录或项目根目录。常见坑是：__DIR__ 比 dirname(__FILE__) 更可靠；realpath() 可帮你验证路径是否真实可达。
- 别写
file_put_contents('data/cache.txt', $data)—— 如果data/目录根本不存在，函数会直接报错 - 先建目录：
if (!is_dir('data')) { mkdir('data', 0755, true); } - 再检查写入能力：
if (!is_writable('data')) { die('data 目录不可写'); }
权限设置要分清用户和组，尤其在 Linux 上
Web 服务器（如 Apache 的 www-data 或 Nginx 的 nginx 用户）必须对目标文件或其父目录有写权限。设成 777 能临时绕过问题，但不安全；更稳妥的是让目录属主为 Web 用户，并设 755（目录）或 644（文件），再加 setgid 保证新建文件继承组权限。
- 查当前运行用户：
echo exec('whoami'); - 改目录权限：
chown -R www-data:www-data /var/www/myapp/data - 改目录权限：
chmod -R 755 /var/www/myapp/data - 注意：
file_put_contents()默认不会创建父级目录，mkdir(..., true)才支持递归创建
别用 error_reporting 屏蔽警告来“解决”问题
把 error_reporting(E_ALL & ~E_WARNING) 加到代码开头，只是让警告不显示，file_put_contents() 还是会失败，数据照样丢。真要容错，得主动处理返回值或用 try/catch（需配合 stream_context_set_default() 或自定义错误处理器，因为 file_put_contents() 不抛异常）。
立即学习“PHP免费学习笔记（深入）”；
- 正确检查：
$bytes = file_put_contents($path, $data); if ($bytes === false) { /* 处理失败 */ } - 想统一捕获所有文件操作警告，可用
set_error_handler()拦截E_WARNING并记录日志 - PHP 8.5.5 仍不改变该函数行为：失败返回
false，不抛Exception
最常被忽略的一点：文件被其他进程锁定（比如 Windows 下记事本正编辑着，或 Linux 下另一个 PHP 进程正在 fopen(..., 'a') 写入），file_put_contents() 也会失败，且错误信息和“路径不存在”一样——得靠 is_writable() + clearstatcache() + 实际写入测试才能交叉验证。
