PHP mkdir() 默认不支持创建多级目录,必须显式设置第三个参数 $recursive 为 true 才能递归创建所有缺失父目录;权限 mode 在 Windows 下被忽略,Linux/Unix 下推荐使用 0755;创建前须用 is_dir() 判断存在性并检查返回值确保成功。

可以,但默认不行——mkdir() 必须显式启用递归模式才能创建多级目录。
PHP 的 mkdir() 函数从 5.0.0 版本起支持第三个参数 $recursive,设为 true 后,它就能自动逐级创建路径中所有不存在的父级目录。比如:
mkdir('logs/error/2026/11', 0755, true);
这条语句会依次创建 logs → error → 2026 → 11,只要上级目录缺失,就一并补上。
关键要点
✅ 必须传第三个参数为 true:默认是 false,只建最后一级,父级不存在就报错(Warning: No such file or directory)。
✅ 权限设置在 Linux/Unix 有效,Windows 忽略:`0755` 是推荐值,比 `0777` 更安全;注意实际权限还受系统 umask 影响。
✅ 务必先用 is_dir() 判断是否存在:`file_exists()` 不行,它对文件也返回 true,容易误判;重复创建会返回 false,可能掩盖问题。
✅ 路径要合法、可写:避免含 `../`、未转义空格或非法字符;建议用 `realpath()` 或 `dirname()` 预处理;确保 PHP 进程有父级目录的写权限(尤其是 open_basedir 限制下)。
批量创建多个多级目录
把路径放进数组,循环调用即可:
示例:
$paths = ['uploads/users/1001', 'cache/templates/v2', 'logs/debug'];<br>foreach ($paths as $path) {<br> if (!is_dir($path)) {<br> if (!mkdir($path, 0755, true)) {<br> trigger_error("创建失败:$path", E_USER_WARNING);<br> }<br> }<br>}
错误处理与健壮性建议
- 检查 `mkdir()` 返回值,不要依赖静默成功
- PHP 7.1+ 对中间目录权限更敏感:某一级只读就会整体失败,需提前确认路径可写
- 涉及敏感路径(如
vendor、public/uploads)时,加白名单校验 - 高并发或 NFS 环境下,原生 `mkdir()` 无原子性;生产项目可考虑 Symfony Filesystem 组件替代
中文目录支持
UTF-8 环境下直接创建中文路径通常可行;若遇乱码(尤其 Windows + GBK 系统),可用 iconv 转码:
mkdir(iconv('UTF-8', 'GBK', '用户资料/张三'), 0755, true);
不复杂但容易忽略细节。核心就一条:加 true,判 is_dir(),查返回值。
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!











