应先用 file_exists() 确认路径存在且可访问，再调用 is_file() 或 is_dir() 判断类型；二者仅适用于本地文件系统，不支持远程协议、封装协议及超出 open_basedir 限制的路径。
直接用 is_file() 和 is_dir() 判断，但必须确保路径存在且可访问
这两个函数不是“智能识别”，而是基于当前 PHP 进程的权限和文件系统状态做判断。如果路径不存在、权限不足、符号链接指向无效目标，is_file() 和 is_dir() 都会返回 false —— 注意，这不等于“是另一个类型”，而更可能是“查不到”。所以不能单靠 false 反推结果。
常见错误现象：
– 对一个刚 mkdir() 创建但未设权限的目录调用 is_dir() 返回 false
– 对一个被 unlink() 后又未检查就继续用 is_file()，结果误判为“不是文件”（其实是已删除）
- 先用
file_exists()确认路径存在，再分情况调用is_file()或is_dir() - 注意符号链接：默认情况下
is_file()和is_dir()跟随符号链接（即判断目标文件/目录），如需判断链接本身，用is_link()+readlink() - Windows 下大小写不敏感，Linux 下严格区分，路径拼写错误会导致两个函数都返回
false
is_file() 与 is_dir() 在 FTP 或远程流中完全不可用
它们只作用于本地文件系统（包括挂载的 NFS/Samba，前提是 PHP 进程有对应挂载点权限）。对 ftp://、sftp://、http:// 等协议路径，一律返回 false，哪怕 URL 可访问。
使用场景：
– 处理 $_FILES['xxx']['tmp_name'] 时可用（这是本地临时路径）
– 解析 scandir() 结果时可用（前提是目录已打开且路径拼接正确）
– 但处理用户上传的“远程 URL 字符串”或配置里的 https://cdn.example.com/logo.png 时，必须换思路
立即学习“PHP免费学习笔记（深入）”；
- 远程路径需用
curl或file_get_contents()+get_headers()检查Content-Type和响应码，无法靠is_file() - FTP 目录判断得用
ftp_nlist()或ftp_rawlist()，再解析返回内容，不能传路径给is_dir() -
phar://、zip://等封装协议路径也不支持，会返回false
性能差异极小，但反复调用前建议缓存结果
单次调用 is_file() 或 is_dir() 开销几乎可忽略（底层是 stat() 系统调用），但若在循环里对同一路径高频调用（比如遍历目录时对每个条目都重复判断类型），就会变成 I/O 瓶颈。
参数差异：
– 两者都只接受一个 string 参数，不支持资源、对象或数组
– 不接受相对路径别名（如 @vendor），必须是真实可解析路径，__DIR__ . '/config' 是安全的，'config' 则依赖当前工作目录（getcwd()），易出错
- 用
realpath()或dirname(__FILE__) . '/xxx'拼出绝对路径再判断，避免工作目录变动影响 - 对固定路径，把判断结果存到变量里复用，而不是写
if (is_dir($p) && is_file($p)) { ... }这种逻辑（永远为false，但还调了两次系统调用） - PHP 8.0+ 中可配合
match表达式 +scandir()一次性获取类型，减少重复 stat
遇到 open_basedir restriction 错误时，函数失效且不报异常
当路径超出 open_basedir 限制范围，is_file() 和 is_dir() 会静默返回 false，不会触发警告或异常。这是最隐蔽的坑——你可能以为路径不存在，其实是被 PHP 安全策略拦住了。
容易踩的坑：
– 本地开发没开 open_basedir，测试正常；上线后因共享主机限制突然全部返回 false
– 使用 chroot 或容器时，/var/www 映射后路径实际是 /app，但代码里硬写 /var/www/html 就会越界
- 调试时加一句
echo 'realpath: ' . realpath($path) . "\n";，确认解析后的路径是否在open_basedir列表内 - 用
ini_get('open_basedir')打印当前限制，比猜更快 - 某些托管环境（如 cPanel）会为每个站点自动设置
open_basedir，且不允许修改，此时只能调整路径写法适配
file_exists() 判断，加一次 realpath() 校验，比事后排查诡异的 false 省太多时间。 
