mkdir() 创建目录失败的常见原因是未启用递归参数且父级目录不存在；PHP 默认只建一层，需显式传入 true 并确保上级目录有写权限。
mkdir() 创建目录失败的常见原因
PHP 写文件前目录不存在，直接 fopen() 会报 Warning: failed to open stream: No such file or directory。这不是文件权限问题，而是父级路径压根没创建。PHP 不会自动补全中间缺失的目录层级，mkdir() 默认只建一层，且不递归。
用 mkdir() 的 recursive 参数一次性建完整路径
PHP 5.0+ 支持 mkdir() 第三个参数 $recursive = true，能自动创建多级目录（如 logs/2024/06/15）。但要注意两点：一是必须显式传入该参数；二是需确保上级目录有写权限，否则中间某层卡住就停。
- 正确写法：
mkdir('/var/www/app/cache/user/123', 0755, true) - 错误写法：
mkdir('/var/www/app/cache/user/123')（缺true，只建123这一层，若user不存在则失败） - 权限建议：生产环境慎用
0777，优先用0755或按用户组配合适当 umask
file_put_contents() 自动建目录的替代方案
如果只是想安全写一个文件，不想手动调 mkdir()，可以用封装逻辑：先取目录路径，再建再写。但注意 file_put_contents() 本身不建目录，必须自己处理。推荐用 dirname() + is_dir() + mkdir() 组合：
$file = '/var/www/app/data/config.json';
$dir = dirname($file);
if (!is_dir($dir)) {
mkdir($dir, 0755, true);
}
file_put_contents($file, json_encode($data));
这个模式比裸写 fopen() 更健壮，也避免了重复判断。
立即学习“PHP免费学习笔记（深入）”；
Windows 下路径分隔符和权限的特殊点
Windows 不区分 / 和 \，但 PHP 函数内部统一转为 / 处理，所以用 dirname('C:/a/b/c.txt') 没问题。真正容易出错的是权限：Windows 下 mkdir() 的 mode 参数被忽略，建出来的目录默认可写；但若目标盘是 NTFS 且启用了 ACL，仍可能因用户权限不足失败——此时错误不是 “Permission denied”，而是 “Access is denied”，需检查运行 PHP 的用户（如 IIS 的 IUSR、Apache 的 daemon 用户）是否对父目录有“创建子目录”权限。
