file_exists() 是 PHP 原生函数，可同时检查文件或目录是否存在，返回 true/false，语义清晰、性能好；但无法区分“不存在”与“无权限”，且不支持 URL，符号链接默认被跟随。
用 file_exists() 判断文件或目录最直接
file_exists() 是 PHP 原生函数，能同时检查文件和目录是否存在，不用先猜类型再调用不同函数。它返回 true 或 false，语义清晰，性能开销小。
常见错误是以为它只认文件——其实只要路径存在（无论是普通文件、软链接、目录，甚至某些特殊设备节点），它都返回 true。但要注意：如果父目录权限不足导致无法访问，它也会返回 false，不区分“不存在”和“没权限”。
- 路径必须是服务器本地路径，不能是 URL（比如
http://开头的地址） - 符号链接默认会被跟随；若需判断链接本身而非目标，改用
is_link()+lstat() - Windows 下路径大小写不敏感，Linux 下敏感——跨平台时别依赖大小写差异
- 示例：
if (file_exists('/var/log/app.log')) { /* 存在 */ }
is_file() 和 is_dir() 要配合 file_exists() 一起用
单独用 is_file() 或 is_dir() 有陷阱：它们在路径不存在时也返回 false，跟“存在但不是该类型”的结果完全一样。你没法靠一个 false 判断出到底是“没这个路径”，还是“有路径但不是文件/目录”。
所以真实场景中，90% 的情况应该先 file_exists()，再分类型处理：
立即学习“PHP免费学习笔记（深入）”；
- 想确认是普通文件？
if (file_exists($path) && is_file($path)) - 想确认是目录？
if (file_exists($path) && is_dir($path)) - 想排除符号链接干扰？加
&& !is_link($path) - 注意：
is_dir()对末尾带斜杠的路径（如/tmp/）更友好，但对不带斜杠的路径（如/tmp）行为一致，无需刻意补斜杠
遇到权限问题时 file_exists() 返回 false 不代表路径不存在
PHP 进程用户（如 www-data、nginx、apache）可能没有读取父目录的权限，即使目标文件或目录真实存在，file_exists() 仍会返回 false。这是最容易被当成“路径写错”的坑。
排查方法很简单：用命令行切到 PHP 进程用户身份执行 ls -ld /path/to/parent，看是否有 r-x 权限。常见于 /home/user/private/ 类路径或 Docker 容器挂载目录权限配置不当。
- 不要在代码里静默失败——加日志记录实际检查的
$path和getcwd() - 避免用
@file_exists()抑制警告，它掩盖了真正的权限报错 - 开发环境可临时用
var_dump(is_readable(dirname($path)));辅助定位哪一级目录卡住
PHP 8.0+ 中 file_exists() 的行为没变，但注意 realpath() 缓存影响
PHP 8 没改动 file_exists() 的逻辑，但如果你在循环中反复检查同一路径，且启用了 realpath_cache_size（默认 4MB），PHP 会缓存 realpath() 结果——而 file_exists() 内部会调用它做路径归一化。
这意味着：如果路径是相对路径（如 ../config.json），且当前工作目录在运行中被 chdir() 改过，缓存可能导致误判。不过这种情况极少见，除非你在 CLI 脚本里频繁切换目录。
- 绝大多数 Web 场景下不用管这个缓存，性能反而更好
- 真要绕过缓存？加个无意义查询参数骗过解析：
file_exists($path . '?t=' . time())不行——file_exists()不支持 URL 查询参数，这招无效 - 正确做法是：确保路径尽量用绝对路径，或手动清缓存：
clearstatcache(true, $path)
路径是否真实存在，取决于 PHP 进程能不能顺着目录树一层层走进去——中间任何一级没权限，就停住，然后告诉你“不存在”。这点很多人第一次 debug 时会卡很久。
