PHP文件写入失败时，须先启用错误报告并用=== false判断返回值，再调用error_get_last()获取真实错误；若为“Permission denied”，需检查目录属主/权限及SELinux；若为“No such file or directory”，则需递归创建父目录并验证可写性；还需排查磁盘空间、open_basedir、upload_tmp_dir及Windows路径编码问题。
PHP 7.3 文件写入失败时，代码在本地能跑通但服务器上静默返回 false、无文件生成、也无明确报错，这种现象必须通过系统级检查定位真实原因，不能仅靠重试或改用 file_put_contents。
第一步：强制暴露错误，确认失败类型
在脚本最开头插入三行，绕过生产环境默认关闭错误显示的限制：
error_reporting(E_ALL);
ini_set('display_errors', 1);
ini_set('log_errors', 1);
紧接着，在 fopen 或 file_put_contents 调用后立即判断返回值——【file_put_contents() 必须用 === false 判断，不能用 != true 或 !empty()】。若为 false，立刻执行 error_get_last() 获取原始系统错误字符串，比如 “Permission denied” 或 “No such file or directory”。
立即学习“PHP免费学习笔记（深入）”；
这一步跳过就等于蒙眼排障。很多开发者以为加了 or die() 就够了，其实 PHP 7.3 在某些 SAPI 模式下会抑制 die 输出，而 error_get_last() 总是可靠的。
第二步：区分两类核心错误并针对性处理
根据上一步拿到的 error message，走不同路径：
方法一：“Permission denied”
这不是 chmod 没设好那么简单。先确认 Web 进程用户（如 www-data 或 apache）是否真正拥有对目标父目录的 wx 权限——注意是目录，不是文件。运行 ls -ld /path/to/dir，看第三列（属主）和第四列（属组）是否匹配，且权限位中对应位置有 w 和 x（例如 drwxr-x--- 中属主位的 w 和 x 都要有）。
若属主不匹配，用 chown www-data:www-data /path/to/dir；若属组匹配但缺 w 权限，用 chmod g+w /path/to/dir。切勿 chmod -R 777，它在 PHP 7.3+ 下可能触发 open_basedir 保护机制拦截。
CentOS/RHEL/AlmaLinux 系统还必须检查 SELinux：临时执行 setenforce 0 后重试，若成功即证实是 SELinux 拦截。永久修复需运行：
semanage fcontext -a -t httpd_sys_rw_content_t "/path/to/dir(/.*)?" && restorecon -Rv /path/to/dir
方法二：“No such file or directory”
这个错误 90% 不是路径写错，而是父目录根本不存在。file_put_contents 不创建目录，只写文件。必须在写入前确保整条路径存在：
mkdir(dirname($filepath), 0755, true);
第三个参数 true 表示递归创建，否则 mkdir 只建最后一级，前面缺失的层级仍会报错。同时要验证该目录对 PHP 进程用户是否可写：is_writable(dirname($filepath)) 必须返回 true，否则即使目录存在也无法写入。
第三步：排查隐藏系统限制
① 检查磁盘空间：运行 disk_free_space('/var/www')，若返回值 ≤ 0，说明分区已满。PHP 7.3 在磁盘满时可能返回 false 且 error_get_last() 为空数组，必须主动检测。
② 检查 upload_tmp_dir 是否可用：如果写入操作源于文件上传（$_FILES），错误码 7（UPLOAD_ERR_CANT_WRITE）表示临时文件无法落盘。查看 phpinfo() 中 upload_tmp_dir 值，确认该路径存在、有写权限、且不在只读挂载分区上。
③ 检查 open_basedir 是否限制路径：phpinfo() 中搜索 open_basedir，若其值非空且不包含你要写入的目录绝对路径，就会被拒绝。修改 php.ini 中 open_basedir 配置，加入对应路径，多个路径用冒号分隔（Linux）或分号分隔（Windows）。
④ Windows 下特别注意路径编码：若路径含中文，且 PHP 脚本保存为 UTF-8 with BOM，而系统代码页为 GBK，fopen 会静默失败。解决方法是路径全用 ASCII 字符，或改用 realpath() 标准化路径后再传入。
