realpath() 返回 false 的常见原因包括路径不存在、中间目录缺少执行权限、符号链接目标不可达、路径格式异常（如多余斜杠或Windows反斜杠错误）；需逐级用 file_exists() 和 is_executable() 检查权限与存在性。
realpath() 返回 false 的常见原因
它不是“出错了”，而是明确告诉你：这个路径无法被解析为一个真实存在的、可访问的目标。返回 false 是正常行为，不是 bug。
- 目标文件或目录根本不存在（最常见）
- 路径中某一级目录权限不足 —— 当前 PHP 进程对中间任意父目录缺少执行（
x）权限，realpath()就会卡住并返回false - 路径指向一个符号链接，但链接目标不可达（比如目标被删了、权限不对、跨文件系统且挂载异常）
- 路径里有连续斜杠（如
/var/www//config/）或结尾多余斜杠（如/tmp/），在某些配置下（尤其是启用了open_basedir时）可能触发校验失败 - Windows 下路径用了反斜杠且拼接错误，导致解析器误判（虽然 PHP 多数函数兼容
\，但realpath()对格式更敏感）
怎么快速定位是哪一层出了问题
别只盯着最终路径，要逐级检查。用 file_exists() 和 is_readable() 拆解验证：
$path = '/var/www/app/../storage/logs/app.log'; var_dump(file_exists(dirname($path))); // 先看上一级存不存在 var_dump(is_executable(dirname($path))); // 再看有没有执行权限（关键！） var_dump(file_exists($path)); // 最后看目标本身
注意：is_executable() 在目录上表示“能否进入”，不是“能否执行文件”。缺这个权限，realpath() 必然失败。
为什么 file_exists() 返回 true，realpath() 却返回 false
这是权限问题的典型表现。两者检查逻辑不同：
-
file_exists()只需对**目标所在目录**有读或执行权限（取决于系统），就能确认目标是否存在 -
realpath()必须对**路径中每一级目录**都有执行权限，才能“走进去”并解析完整路径 - 例如：
/a/b/c.txt，如果 PHP 进程对/a有读权限但无执行权限，file_exists('/a/b/c.txt')可能返回true（靠目录列表推断），但realpath('/a/b/c.txt')一定返回false
realpath() 在 Windows 上的特殊表现
它不展开多级符号链接 —— 只展开第一层。如果链接 A → B，B 又是链接 → C，realpath() 只走到 B 就停了，不会继续追到 C。此时若 B 不存在或不可访问，就直接返回 false。
另外，Windows 下用 __DIR__ . '\sub\file.php' 拼接再传给 realpath()，比用 __DIR__ . DIRECTORY_SEPARATOR . 'sub' . DIRECTORY_SEPARATOR . 'file.php' 更容易因反斜杠转义或双写导致解析失败。统一用正斜杠 / 更稳。
真正容易被忽略的是：即使路径语法完全正确，只要中间任一环节权限缺失，realpath() 就静默失败。它不报错、不抛异常，只返回 false —— 所以你得主动检查，不能默认它“应该成功”。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
