file_put_contents返回false即写入失败，必须用=== false判断并立即调用error_get_last()查具体错误；常见原因包括SELinux拦截、父目录不存在或不可写、磁盘满、挂载只读及大文件内存溢出。
file_put_contents 返回 false 就是写入失败，别猜原因，先看返回值
调用 file_put_contents() 后必须检查返回值：if (file_put_contents($path, $data) === false)。它不抛异常，也不自动报错，返回 false 是唯一明确的失败信号。此时立刻调用 error_get_last() 查具体错误信息，比如 "Permission denied" 或 "No such file or directory"，这两个字符串直接指向排查方向。
“Permission denied” 多半不是 chmod 没设好，而是 SELinux 在拦路
在 CentOS/RHEL 7+、AlmaLinux 等系统上，即使 /var/www/html/ 目录已 chown apache:apache 且 chmod 775，file_put_contents() 仍可能报权限拒绝——这是 SELinux 的 httpd_can_write 策略默认关闭导致的。它和传统文件权限完全独立：
- 临时验证：运行
setenforce 0（禁用 SELinux），再试写入；若成功，100% 是 SELinux 问题 - 永久修复：执行
chcon -R -t httpd_sys_rw_content_t /var/www/html/uploads/（仅对需写的子目录赋权） - 更稳妥：用
semanage fcontext -a -t httpd_sys_rw_content_t "/var/www/html/uploads(/.*)?"+restorecon -Rv /var/www/html/uploads - 切勿用
chmod 777，它既不能绕过 SELinux，又破坏最小权限原则
“No such file or directory” 不一定路径写错了，可能是父目录不存在或不可写
这个错误常被误判为“文件路径不对”，其实 file_put_contents() 只负责写文件，不创建目录。如果 /var/log/app/2026/04/ 这整条路径里任意一级不存在，就会报此错：
- 写入前务必确保父目录存在：用
is_dir(dirname($path)) || mkdir(dirname($path), 0755, true) - 注意
mkdir()的第三个参数true表示递归创建，否则只建最后一级 - 即使目录存在，PHP 进程用户（如
www-data或apache）也必须对**该目录有写权限**，而不仅是目标文件 - Windows 下含中文路径失败，大概率是脚本保存编码（UTF-8 BOM）与系统代码页（GBK）不匹配，建议路径全用 ASCII 字符
磁盘满、配额超限、挂载只读也会让 file_put_contents 静默失败
这些底层限制不会触发明显报错，但会让 file_put_contents() 返回 false，且 error_get_last() 可能只显示模糊的 "Cannot allocate memory" 或空数组：
- 查磁盘：运行
df -h，重点关注目标路径所在分区是否 100% 占用 - 查用户配额（尤其虚拟主机环境）：用
quota -u $(whoami)或联系运维确认 - 查挂载状态：运行
mount | grep "$(dirname $path)"，确认不是ro（只读）挂载 - 大文件写入慎用：
file_put_contents()会把全部内容载入内存，写 500MB 文件极易 OOM；应改用fopen()+fwrite()流式写入
实际调试时，最易被忽略的是：SELinux 状态和父目录可写性这两项，它们不报具体路径错误，也不提示“请检查磁盘”，却高频导致 false 返回。别跳过 error_get_last()，也别假设目录“应该存在”。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
