PHP fopen() 和 file_put_contents() 不会自动创建父目录，仅操作最后一级路径，若任一中间目录缺失则报错；需用 mkdir($dir, 0755, true) 配合 dirname() 手动创建多级目录。
PHP fopen() 或 file_put_contents() 会自动创建父目录吗
不会。PHP 所有原生文件写入函数（包括 fopen()、file_put_contents()、copy()）都只操作「最后一级路径」，如果父目录不存在，直接报错 Warning: failed to open stream: No such file or directory。
这不是权限问题，是路径根本不存在——就像你试图往一个还没建好的楼里送快递，快递员只会说“这栋楼不存在”，不会帮你先盖楼。
-
file_put_contents('/var/log/app/2024/06/error.log', $msg)：若/var/log/app/2024/06/任一中间目录缺失，就失败 -
fopen('data/cache/user_123.json', 'w')：即使data/存在但cache/不存在，也会失败 - Windows 下路径分隔符用
/或\都行，但mkdir()对斜杠兼容性更好，建议统一用/
最稳妥的目录创建方式：mkdir() + recursive 参数
用 mkdir() 手动补全路径是最可控、最通用的做法。关键在第三个参数 $recursive = true，它允许一次性创建多级不存在的目录。
注意：PHP 5.0+ 支持该参数，但默认权限是 0777（实际生效受 umask 影响），生产环境建议显式指定权限并检查返回值。
立即学习“PHP免费学习笔记（深入）”；
- 必须先调用
dirname($filepath)提取父目录路径，再传给mkdir() - 推荐加
is_dir()判断前置检查，避免重复创建或权限冲突警告 - 示例：
$path = '/var/log/app/2024/06/error.log'; $dir = dirname($path); if (!is_dir($dir) && !mkdir($dir, 0755, true)) { throw new RuntimeException("Failed to create directory: $dir"); } file_put_contents($path, $log);
为什么不用 touch() 或 file_put_contents() 的 FILE_APPEND | LOCK_EX 来绕过
touch() 只能创建空文件，不能创建目录；file_put_contents() 加标志位也解决不了路径不存在的问题——它连打开文件流这一步都卡住，标志位根本没机会生效。
有人试过先写临时文件再 rename()，但同样依赖目标目录存在，且引入原子性、并发、清理等额外复杂度，纯属绕远路。
-
touch('missing/dir/file.txt')→ 报错No such file or directory，不是静默忽略 -
file_put_contents('a/b/c.txt', 'x', FILE_APPEND | LOCK_EX)→ 如果a/b/不存在，照样失败 - 用
exec('mkdir -p ...')看似简单，但依赖 shell、跨平台差、有安全风险（路径拼接不严谨时可能命令注入）
实际项目中容易被忽略的三个细节
很多线上故障不是因为不会创建目录，而是忽略了运行时上下文差异。比如本地测试通过，上线就报错。
- Web 服务器用户（如
www-data或nginx）可能没有上级目录的写权限，mkdir()成功但后续file_put_contents()失败，需检查整个路径的write权限链 -
open_basedir限制下，即使目录存在且权限正确，mkdir()也可能被拦截，错误信息仍是“no such file”，容易误判 - Windows 下长路径（超 260 字符）或包含保留名（如
CON、AUX）会导致mkdir()静默失败，务必用is_dir()或file_exists()验证结果
路径不存在本身不难处理，难的是在不同部署环境里稳定识别「是真不存在」还是「权限/配置拦住了」——别只盯着 mkdir() 写没写对，先确认它有没有执行权。
