mkdir() 返回 false 不代表失败，需先用 is_dir() 检查是否存在，再调用 mkdir()；常见原因包括目录已存在、权限不足或父路径缺失，应结合前置校验与日志处理而非依赖返回值判断。
PHP 的 mkdir() 函数在目标目录已存在时，**不会返回 true，而是直接返回 false 并触发 E_WARNING 警告**。这不是报错，但容易被误判为“创建失败”，进而引发逻辑错误或重复尝试。关键不是“怎么让它返回 true”，而是**提前检查 + 合理判断**。
先用 is_dir() 或 file_exists() 判断是否存在
这是最稳妥、最推荐的第一步。不要依赖 mkdir() 的返回值来判断“是否成功创建”，而应把它当作“尝试创建”的动作。
-
用
is_dir()：专门检测是否为目录（比file_exists()更精准，排除同名文件干扰） -
用
file_exists()：通用，但需注意路径下若存在同名普通文件，也会返回 true，导致 mkdir 失败 - 检查通过后再调用
mkdir()，可避免警告；即使已存在，也能明确走“跳过”逻辑
mkdir() 返回 false 不一定代表失败
它可能因为以下任一原因返回 false：
- 目录已存在（最常见）
- 父级路径缺失且未启用递归（
$recursive = false） - 权限不足（如 Web 用户无写入权限）
- 路径含非法字符或超出系统限制（如长度、../ 路径遍历）
所以不能单靠 if (!mkdir(...)) { echo '失败'; } 下结论。必须结合前置检查和上下文判断。
立即学习“PHP免费学习笔记（深入）”；
安全写法示例（带递归 + 权限 + 存在性校验）
下面是一个生产环境可用的封装逻辑：
$path = '/var/www/uploads/users/1001/avatar';
$mode = 0755;
if (!is_dir($path)) {
// 尝试递归创建，忽略已存在的警告（@ 可选，建议配合日志）
if (mkdir($path, $mode, true)) {
echo "目录创建成功";
} else {
// 创建失败：可能是权限问题、磁盘满、路径不可写等
error_log("mkdir failed for: {$path}");
throw new RuntimeException("无法创建目录：{$path}");
}
} else {
echo "目录已存在，跳过创建";
}
补充建议：避免 suppress 错误但掩盖问题
有人会写 @mkdir(...) 来屏蔽警告，但这会隐藏真实问题（比如权限错误），不推荐用于正式环境。
- 开发阶段应开启
error_reporting(E_ALL)，让警告可见 - 线上环境可通过
error_log()记录失败详情，而不是静默吞掉 - 对敏感路径（如上传目录），创建后可用
is_writable()再验证是否真能写入
