PHP mkdir() 默认不递归创建多级目录，需显式设置第三个参数 $recursive 为 true 才能逐层建立；权限值必须用八进制（如 0755），否则会被误解析；现代 PHP 中原生递归已足够健壮，无需手动实现。
PHP mkdir() 创建多级目录时为什么只建了一层？
因为默认情况下 mkdir() 不递归创建父级目录。比如执行 mkdir('a/b/c')，若 a 和 a/b 不存在，会直接报错：Warning: mkdir(): No such file or directory。
解决方法是启用它的第三个参数 $recursive，设为 true：
mkdir('a/b/c', 0755, true);
注意权限 0755 是八进制写法，必须带前导 0；漏掉会导致权限被解释成十进制，实际效果异常（如 755 变成 01143 八进制，等效于 0613）。
用 is_dir() + mkdir() 手动递归创建是否更安全？
不必要。现代 PHP（≥5.0.0）的 mkdir(..., ..., true) 已足够健壮，且底层调用系统 mkdir -p 行为，效率更高。
立即学习“PHP免费学习笔记（深入）”；
手动拆解路径再逐层判断反而容易出错，比如：
- 忽略 Windows 路径分隔符
\导致explode('/', $path)失效 - 没处理开头的
/或./，导致第一层目录名为空 - 权限设置未传递到每一层，深层目录继承了错误 umask
除非你需对某一层做特殊操作（如记录日志、跳过已存在目录），否则别绕开 mkdir() 的原生递归支持。
创建目录失败的常见原因和排查点
即使加了 true，仍可能失败。重点检查以下几项：
-
error_get_last()返回的错误信息，常是"Permission denied"—— 父级目录不可写，或 Web 服务器用户（如www-data）无权在目标位置创建子目录 - 目标路径含中文或特殊字符，但脚本文件编码与运行环境不一致（如 UTF-8 脚本写入 GBK 文件系统）
- 使用相对路径时，当前工作目录（
getcwd()）非预期位置 —— 建议统一用绝对路径：mkdir(__DIR__ . '/uploads/temp/2024/06', 0755, true) - SELinux 或容器挂载限制（如 Docker 中宿主机目录未配置
z或Z标签）
需要自动创建目录的典型场景及建议
上传文件前确保 $_FILES['file']['tmp_name'] 对应的目标路径存在；生成日志时按日期分目录（如 logs/2024/06/15/）；缓存文件写入前准备层级结构。
关键实践建议：
- 始终用
is_writable()检查最外层父目录是否可写，比依赖mkdir()返回值更可靠 - 避免硬编码权限，改用
umask()统一控制（例如先umask(0)，再调用mkdir($path, 0755, true)） - 如果目录结构固定，考虑在部署阶段用 shell 脚本一次性创建，而非每次请求都调用
mkdir()
多级目录创建本身不复杂，但失败时的上下文（权限、路径、环境）往往比函数调用本身更难定位。
