安全遍历目录需先用is_dir()和is_readable()双重校验路径,再检查opendir()返回值,循环中跳过.和..,最后closedir();创建多级目录用mkdir($path, 0755, true),删非空目录需先清空再rmdir()。

直接用 opendir() + readdir() 遍历目录,比先背函数列表更可靠;但不校验路径是否存在、不处理权限失败、不关闭句柄,代码跑两三次就会卡死或报错。
怎么安全打开并遍历一个目录
别一上来就写 opendir("uploads") 然后循环读——如果 uploads 不存在或没读权限,opendir() 返回 false,后续 readdir() 直接报 Warning 并中断。
- 必须先用
is_dir($path)和is_readable($path)双重判断,缺一不可 -
opendir()的返回值要显式检查:$dh = opendir($path); if ($dh === false) { die("无法打开目录: $path"); } -
readdir()会返回.和..,实际业务中通常要跳过:if ($file === '.' || $file === '..') continue; - 循环结束后必须调用
closedir($dh),否则句柄泄漏,Linux 下最多打开 1024 个目录后就再也打不开新目录
创建和删除目录时权限和递归的坑
mkdir() 默认不支持创建多级嵌套路径,mkdir("a/b/c") 在 a/b 不存在时必然失败;而 rmdir() 只能删空目录,删 uploads/2026/05 前得先清空里面所有文件。
- 创建多级目录必须加第三个参数
true:mkdir("a/b/c", 0755, true) - 权限码
0755要用八进制写法(前面带0),写成755就是十进制,等效于01143,权限完全不对 - 删非空目录得自己递归:
array_map('unlink', glob("$dir/*"));清空内容,再rmdir($dir) - Windows 下路径分隔符用
\,但 PHP 函数统一接受/,建议全用/写路径,避免拼接出C:\xampp/htdocs这种混合格式
获取目录信息时别混淆 dirname() 和 basename()
这两个函数看似简单,但传入相对路径、末尾带斜杠、或包含查询参数时行为反直觉。比如 dirname("images/photo.jpg") 返回 images,但 dirname("images/") 返回 images(不是 .),而 basename("images/?v=1") 返回 images(不是 images/)。
-
dirname($path)返回的是“上级路径”,不是“目录名”;要取纯目录名,得再套一层basename(dirname($path)) -
basename($path, ".php")第二个参数可去掉扩展名,但只匹配末尾,basename("v1.2.3.txt", ".txt")→v1.2.3,而basename("file.php.bak", ".php")→file.php.bak(没匹配上) - 真实项目里,路径处理优先用
realpath($path)标准化,它能展开../、补全末尾斜杠、转绝对路径,避免因软链或相对路径导致is_dir()判断失败
用 scandir() 替代手写循环读取更省事
比起 opendir()+readdir() 三步走,scandir() 一行返回完整数组,适合快速列出、过滤、排序,且自动跳过 . 和 ..(PHP 5.4+ 默认行为)。
-
$files = scandir($dir);返回按字母升序排列的数组,含.和..;加SCANDIR_SORT_NONE参数可取消排序 - 想排除隐藏文件(以
.开头),用array_filter($files, fn($f) => $f[0] !== '.'); - 注意
scandir()不检查目录是否可读,失败时直接返回false,仍需前置is_readable()校验 - 大目录下
scandir()比循环读取稍慢(一次性加载全部条目),但代码简洁度和可维护性高得多,除非目录真有上万文件,否则不用优化
真正容易被忽略的是路径的“真实性”:你写的 "./uploads" 在 CLI 下是相对于当前终端路径,在 Web 下是相对于 $_SERVER['DOCUMENT_ROOT'],而 __DIR__ . "/uploads" 才是稳定可靠的。别让路径变成调试时最花时间的那一环。
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!











