is_dir() 是判断路径是否为目录最直接可靠的方式,仅当路径存在、有读取权限且确为目录时返回 true,否则一律 false;不依赖扩展名或内容,隐含存在性检查,符号链接按目标判断。

用 is_dir() 判断路径是否为目录
最直接可靠的方式就是调用 is_dir(),它只关心「这个路径是否存在且是目录」,不依赖扩展名或内容。只要传入的路径存在、有读取权限、且确实是目录,就返回 true;否则一律 false(包括路径不存在、是文件、或权限不足)。
常见错误是先用 file_exists() 再判断类型,其实多余:is_dir() 本身已隐含存在性检查。
-
is_dir('/var/www')→true(假设该路径存在且为目录) -
is_dir('/var/www/index.php')→false(是文件) -
is_dir('/nonexistent')→false(路径不存在,不报错) - 注意:符号链接需配合
is_link()单独处理,is_dir()对软链默认按目标判断,不是链接本身
is_file() 和 is_dir() 不是互斥的“二选一”
它们各自独立判断,不能靠一个为 false 就推断另一个为 true。比如路径不存在时,两者都返回 false;路径是符号链接但目标不可访问时,也可能同时为 false。
真正安全的区分逻辑是:
立即学习“PHP免费学习笔记(深入)”;
- 先用
file_exists()确认路径存在(可选,取决于你是否需要区分“不存在”和“存在但非目录/文件”) - 再分别用
is_dir()和is_file()明确判断类型 - 若两者都为
false,可能是符号链接、设备文件、socket 或权限问题,需进一步用filetype()查看原始类型
filetype() 返回更底层的类型信息
当需要明确知道路径的底层类型(比如区分 dir、file、link、char、block 等),用 filetype() 更合适。它不判断“是否可读”,只返回文件系统层面的类型标识符。
-
filetype('/tmp')→"dir" -
filetype('/etc/passwd')→"file" -
filetype('/usr/bin/php')→"link"(如果是软链) - 如果路径不存在或无权限访问,
filetype()会触发警告并返回false,这点比is_dir()更敏感
Windows 下的路径分隔符和大小写问题
PHP 的 is_dir() 和 is_file() 在 Windows 上自动兼容反斜杠 \ 和正斜杠 /,无需手动转换。但要注意:Windows 文件系统默认不区分大小写,而 PHP 函数行为与系统一致——is_dir('C:\MyFolder') 和 is_dir('c:\myfolder') 结果相同。这在跨平台代码中容易引发预期外的一致性问题,尤其当路径来自用户输入或配置时。
建议统一用 realpath() 规范路径后再判断,既能消除 ./、../,也能标准化大小写和分隔符:
if (is_dir(realpath($path))) { ... }
不过 realpath() 对不存在的路径返回 false,所以要确保路径大概率存在,或提前兜底处理。
真正容易被忽略的是:权限变化、挂载点失效、NFS 超时等运行时因素,会让 is_dir() 突然返回 false,而不是抛异常——这意味着你要在业务逻辑里始终把它当作可能失败的操作来对待,而不是一次判断终身信任。











