mkdir()用于创建目录，关键参数为路径、权限（八进制，受umask影响）和递归标志；需先用is_dir()检查，配合true递归创建多级目录，并注意Windows忽略权限设置。
PHP mkdir() 函数用于创建新目录，核心是路径、权限和递归控制三个关键点。它不是“一写就成”，用错参数或忽略环境限制（比如 umask、Windows 权限忽略、父目录缺失）很容易返回 false 却不知原因。
基本语法与必需参数
函数完整签名如下：
bool mkdir(string $directory, int $mode = 0777, bool $recursive = false, ?resource $context = null)
其中只有 $directory 是强制项，其余均可省略，但实际使用中建议显式传参以避免意外：
立即学习“PHP免费学习笔记（深入）”；
-
$directory：要创建的目录路径，支持相对路径（如
'uploads/avatar'）或绝对路径（如'/var/www/site/cache'）；注意路径末尾不加斜杠也能创建成功，但加斜杠更符合语义习惯。 -
$mode：八进制权限值，默认
0777；必须以0开头（如0755），否则会被解释为十进制数；在 Windows 下该参数被完全忽略。 -
$recursive：设为
true才能一次性创建多级不存在的父目录（例如'a/b/c'中a和b都不存在时仍可成功）；PHP 5.0.0+ 才支持，旧版本需自行封装递归逻辑。 - $context：极少使用，用于自定义流上下文（如远程 FTP 目录创建），普通 Web 场景可忽略。
权限设置的实际效果
$mode 并非最终生效权限，它会受系统 umask 值影响。例如默认 umask 是 0022，那么即使你传 0777，实际创建的目录权限也是 0755（即 0777 & ~0022）。
常见安全推荐写法：
-
0755：所有者可读写执行，组和其他人仅读+执行（适合 Web 可访问目录） -
0700：仅所有者完全控制（适合含敏感配置的私有目录） - 若需绕过 umask，可临时修改：
$old = umask(0); mkdir($path, 0777, true); umask($old);
必须配合的检查逻辑
mkdir() 遇到目录已存在时直接返回 false 并触发 E_WARNING，所以不能裸调用。标准做法是先判断再创建：
if (!is_dir($path) && !mkdir($path, 0755, true)) {<br> throw new RuntimeException("无法创建目录: $path");<br>}
注意：file_exists($path) 也可用，但 is_dir() 更精准，避免同名文件干扰判断。
多级目录创建的典型场景
比如要保存用户头像到 uploads/users/123/avatar.jpg，对应目录结构是 uploads/users/123/：
- 错误写法：
mkdir('uploads/users/123')—— 若uploads或users不存在，失败 - 正确写法：
mkdir('uploads/users/123', 0755, true)—— 自动补全所有上级目录 - 补充建议：创建后可用
chmod()再微调权限，或用clearstatcache()防止缓存导致is_dir()判断不准
