PHP mkdir() 默认不支持多级目录创建，需设第三个参数为 true 启用递归模式，如 mkdir($path, 0755, true)；路径须合法、预先判断是否存在（用 is_dir），Windows 下兼容正斜杠但需注意盘符与权限无效性。
mkdir() 一次只能建一层，多级目录得用递归或内置参数
PHP 的 mkdir() 默认不创建父级不存在的路径，比如 mkdir('a/b/c') 在 a 不存在时会失败并报 Warning: mkdir(): No such file or directory。必须显式启用递归模式，或自己写循环/递归逻辑。
推荐直接用 mkdir($path, 0755, true) —— 第三个参数 true 表示递归创建所有缺失的父级目录。这是最简方案，无需手动拆分路径。
-
0755是权限掩码，注意在 Windows 下会被忽略 - 如果目标已存在，
mkdir()会返回false（除非加@抑制警告） - 路径中不能含非法字符（如
../、空格未转义等），建议用realpath()或dirname()预处理
批量建目录：用 foreach 遍历路径数组 + mkdir(..., ..., true)
要一次性生成多个不同路径（如按年月日、用户 ID、分类名），把路径存进数组，再逐个调用 mkdir() 即可。关键点是确保每个路径都走递归创建，且提前判断是否已存在，避免重复警告。
示例：
立即学习“PHP免费学习笔记（深入）”；
$paths = ['uploads/2024/06', 'logs/error', 'cache/templates'];
foreach ($paths as $path) {
if (!is_dir($path)) {
mkdir($path, 0755, true);
}
}
- 务必用
is_dir()判断，而不是file_exists()，因为后者对文件也返回 true - 权限
0755中的前导0不可省略，否则会被当十进制解析 - 若路径含变量（如
"uploads/{$uid}/avatar"），需确保变量已定义且安全（无路径遍历风险）
Windows 下要注意反斜杠和盘符路径
Windows 系统下，路径分隔符是反斜杠 \，但 PHP 大部分函数（包括 mkdir()）能自动兼容正斜杠 /。所以统一用 / 更稳妥，例如 'C:/temp/foo/bar' 可以直接传给 mkdir()。
- 不要拼接
$_SERVER['DOCUMENT_ROOT'] . '\sub\dir'这种混合写法，易出错 - 检查盘符是否存在（如
C:）再操作，否则mkdir()可能静默失败 - 权限参数在 Windows 下无效，但保留不影响运行
更健壮的做法：封装成函数并捕获错误
生产环境建议封装一个带错误反馈的批量建目录函数，避免因某一个路径失败导致后续中断，同时记录哪些路径实际新建成功。
示例：
立即学习“PHP免费学习笔记（深入）”；
function batchMkdir(array $paths, int $mode = 0755): array {
$result = ['created' => [], 'failed' => []];
foreach ($paths as $path) {
if (is_dir($path)) {
continue;
}
if (mkdir($path, $mode, true) === true) {
$result['created'][] = $path;
} else {
$result['failed'][] = $path;
}
}
return $result;
}
- 返回结构化结果，方便后续做日志或重试
- 不依赖
@抑制错误，而是靠返回值判断成败 - 如果需要原子性（全成功或全失败），就去掉
continue并在首次失败时break或抛异常
mkdir('data') 会建在脚本所在目录而非 Web 根目录；还有 SELinux 或 Docker 容器内挂载卷的权限限制，此时 mkdir() 可能返回 true 但目录不可写。这些得结合具体部署环境验证。 
