is_dir() 返回 false 不代表目录一定不存在，可能是权限不足、路径错误、SELinux限制、open_basedir 限制或文件系统异常等导致；应结合 file_exists() 和系统命令综合判断。
is_dir() 返回 false 并不等于“文件夹一定不存在”，它只说明 当前 PHP 进程无法确认该路径是一个有效目录。常见原因不是代码写错了，而是底层环境或权限链出了问题。
目录路径本身不真实或不可达
- 路径是相对路径（如
'uploads'），但在 CLI 和 Web 环境下工作目录不同，导致解析结果不一致；建议统一用__DIR__ . '/uploads'或realpath()拼接绝对路径。 - 路径含符号链接，而链接目标被删除或权限不足，
is_dir()会直接返回false（不会报错，也不提示链接失效）。 - Windows 下路径使用反斜杠
\但未正确转义，或混用/和\导致解析失败（尤其在拼接变量时）。
权限或安全策略阻止访问
- 目录存在，但 PHP 运行用户（如
www-data、nginx或apache）对父目录没有执行（x）权限——Linux/Unix 中，要进入一个目录，必须对其有x权限；缺x就无法stat()，is_dir()就会失败。 - SELinux 或 AppArmor 启用时，可能禁止 Web 进程读取特定路径（即使权限
755也无效），此时is_dir()静默返回false。可用ls -Z /path查看 SELinux 上下文，或临时用setenforce 0测试是否为 SELinux 所致。 -
open_basedir限制开启后，若路径不在允许范围内，is_dir()一律返回false，且不触发警告（除非开启错误报告并查日志）。
文件系统或配置异常
- 目录所在分区已满、只读挂载（如
mount -o remount,ro /var/www），或 NFS 挂载中断，都可能导致is_dir()失效。 - PHP 的
disable_functions中禁用了is_dir（极少见，但需确认phpinfo()输出中该函数未被屏蔽）。 - 使用了自定义流包装器（如
phar://、zip://），但协议不支持目录判断，is_dir()不适用。
验证是否真“不存在”的可靠做法
别只信 is_dir()，组合检查更准：
- 先用
file_exists($path)看路径是否存在（返回false才基本确定没了）； - 若
file_exists()为true但is_dir()为false，大概率是权限或安全策略问题； - 手动执行
ls -ld $path（Linux）或dir $path（Windows）对比 PHP 用户能否看到； - 在脚本开头加：
error_reporting(E_ALL); ini_set('display_errors', '1'); // 然后调用 is_dir()，再立刻看 error_get_last() if (!is_dir($path)) { $err = error_get_last(); if ($err) error_log("is_dir failed: {$path} — {$err['message']}"); }
不复杂但容易忽略
