fopen() 写入失败时返回 false，不抛异常；需手动检查返回值，配合 error_get_last() 调试，并确保父目录存在且可写。
PHP fopen() 写入失败时返回什么
直接说结论：fopen() 在写入模式（如 'w'、'a'）下打开失败时，**不抛异常，只返回 false** —— 这是 PHP 文件函数的默认行为，不是 bug，是设计如此。
常见错误现象包括：Warning: fopen(...): failed to open stream: Permission denied、No such file or directory、Read-only filesystem。这些 warning 会输出到错误日志或页面（取决于 error_reporting 和 display_errors），但不会中断执行，更不会自动转成 Exception。
- 必须手动检查返回值：
if (($fp = fopen($path, 'w')) === false) { /* 处理失败 */ } - 路径不存在时，
'w'模式不会自动创建父目录，只会在最后一级目录存在前提下创建文件 -
'a'和'w'都要求**父目录可写**，而不仅是目标文件路径可写
用 set_error_handler() 捕获文件操作 warning
PHP 的 warning 级别错误（比如 fopen 权限失败）默认不可被 try/catch 捕获，因为它们不是 Exception。想统一处理，得靠错误处理器把 warning 转成异常。
注意：这个转换只对当前请求有效，且需配合 error_reporting 设置（否则 warning 根本不会触发 handler）。
立即学习“PHP免费学习笔记（深入）”；
- 必须在调用
fopen前注册：set_error_handler(function($severity, $msg, $file, $line) { throw new ErrorException($msg, 0, $severity, $file, $line); }); - 记得恢复默认 handler（尤其在长生命周期脚本中），否则后续 warning 全部变异常，可能误伤其他逻辑
- 该方式无法捕获
open_basedir或disable_functions导致的静默失败（此时连 warning 都没有，fopen直接返回false）
file_put_contents() 失败时怎么判断和调试
file_put_contents() 是封装了 fopen+fwrite+fclose 的快捷函数，失败时也返回 false（成功返回写入字节数）。但它有个关键优势：支持原子写入（通过 FILE_APPEND | LOCK_EX）和错误上下文。
容易踩的坑是忽略它的返回值，或误以为它会自动创建目录。
- 检查返回值比依赖 warning 更可靠：
if (file_put_contents($path, $data) === false) { /* 记录 $path 和 error_get_last() */ } - 用
error_get_last()获取最后一次错误详情（注意：它只返回最近一次 error，且会被后续 PHP 错误覆盖） - 父目录不存在？
file_put_contents不会报错，只会返回false—— 此时要先用is_dir(dirname($path))或mkdir(..., 0755, true)确保路径存在
为什么 try/catch 抓不到 fopen 失败
因为 fopen 属于传统 PHP 扩展函数，遵循「返回 false + 触发 warning」模型，而非现代面向对象风格的异常机制。除非你主动开启 throw_exception 上下文（极少见）或用 set_error_handler 中转，否则它永远不会进入 catch 分支。
这点和 PDO、mysqli 的异常模式完全不同——后者可通过构造参数强制抛异常，而文件系统函数没有这种开关。
- 不要写：
try { fopen(...); } catch (Exception $e) { ... }—— 它永远不执行 - 真实场景中，混合使用返回值检查 +
error_get_last()+ 日志记录，比强求统一异常更稳妥 - 如果项目已全面启用
Throwable捕获，仍需意识到：warning → exception 的转换是人工干预结果，不是语言默认行为
最常被忽略的一点：权限问题往往卡在**父目录**，而不是文件本身；而错误信息里通常只提“failed to open”，不会明确说“无法进入 /var/www/html/logs/”。查的时候得一层层 ls -ld 往上翻。
