is_dir()返回false不一定表示不是目录，常见原因包括权限不足、相对路径依赖错误工作目录、CIFS/NFS挂载异常、stat缓存未更新或路径不存在；应优先使用绝对路径并按需调用clearstatcache()。
is_dir 返回 false 不一定代表不是目录
常见现象是路径明明存在且是目录，is_dir() 却返回 false。原因通常有三个：权限不足、路径为相对路径但当前工作目录（getcwd()）不对、或目标是 CIFS/NFS 挂载点且内核启用了 serverino（尤其在 Linux 2.6.31+ 上 Windows 共享挂载时）。
解决思路优先用绝对路径：is_dir($_SERVER['DOCUMENT_ROOT'] . '/uploads') 比 is_dir('uploads') 更可靠；若必须用相对路径，先确认当前目录：var_dump(getcwd())，必要时用 chdir() 切换。
- Linux 下检查父目录是否对运行 PHP 的用户设置了
+x权限（无执行权限则无法进入目录，is_dir()必然失败） - 挂载 CIFS 时加
noserverino参数可绕过 inode 异常问题 - 符号链接默认按目标判断，不关心链接本身——若目标不可达，也会返回
false
缓存导致 is_dir 结果“滞后”
is_dir() 的结果会被 PHP 内部 stat 缓存，比如你刚用 mkdir() 创建了一个目录，紧接着调用 is_dir() 仍可能返回 false，因为缓存还没更新。
必须手动清缓存才能拿到实时状态：clearstatcache(true, $path)（第二个参数指定具体路径，比无参的 clearstatcache() 更精准、开销更小）。
立即学习“PHP免费学习笔记（深入）”；
- 只在目录创建/删除后立即检测时才需要清理，日常使用无需每次都加
- 传入相对路径时，
$path必须和is_dir()中的一致（即也得是相对路径），否则无效 - Windows 下缓存行为较弱，但跨平台代码仍建议统一处理
is_dir 和 is_file 不是互斥开关
很多人误以为 !is_dir($p) 就等于 is_file($p)，这是错的。两者都返回 false 的情况很常见：
- 路径不存在（
file_exists($p) === false） - 路径存在但权限被拒绝（如父目录无
x权限） - 路径是符号链接，而目标不可访问或被
open_basedir限制 - 路径是设备文件、socket 或 FIFO
真正安全的判断逻辑是：先用 file_exists($p) 确认存在性，再分别调用 is_dir() 和 is_file()；若都为 false，可用 filetype($p) 查看原始类型（如 link、char、block）。
替代方案：用 fileperms 判断目录位（绕过权限/缓存限制）
当 is_dir() 因权限或挂载限制持续失败，又无法改环境时，可退而求其次——直接读取文件系统权限位判断是否为目录。Linux/macOS 下目录的 mode 值恒有高位 0x4000（即八进制 040000）：
function quick_is_dir($path) {
return (@fileperms($path) & 0x4000) === 0x4000;
}
这个函数不依赖 stat() 系统调用，不受 open_basedir 或缓存影响，也不检查可访问性，只看 inode 类型位。但它在 Windows 下不可靠（NTFS 无此位定义），且对符号链接返回的是链接自身的类型（而非目标），使用前需明确场景约束。
最易被忽略的是：is_dir() 的行为高度依赖底层文件系统语义和 PHP 运行上下文，不是纯逻辑函数——同一段代码，在本地开发机、Docker 容器、CIFS 挂载的 NAS 上可能表现完全不同。
