PHP8.0环境下file_exists函数始终返回false问题排查
PHP8.0 环境下
file_exists 始终返回 false 排查方案 - 优先校验逐级父目录权限,而非仅调整文件本身权限
绝大多数看似“权限不对但改了没用”的问题,根源是路径中间的某一级父目录,缺少PHP运行用户的可执行(x)权限。哪怕文件本身被设置为777、属主与PHP运行用户完全匹配,只要上层目录不允许PHP用户穿透访问,file_exists就会静默返回false。
可在PHP脚本中执行shell_exec('namei -l /home/user/projects/test_project/test.txt'),逐行核对每一级目录的属主、权限,定位到权限不足的目录层调整即可。 - 检查open_basedir 白名单限制
PHP8.0中,若目标路径不在open_basedir配置的允许访问范围内,函数不会抛出任何显性报错,只会直接返回false,非常容易被误判为权限类故障。
可在脚本内直接输出var_dump(ini_get('open_basedir')),检查返回的白名单范围是否覆盖目标文件路径。如果是通过服务器面板部署的站点,需要同时核对站点独立配置的open_basedir规则,不要仅依赖全局php.ini的设置。 - 清除PHP realpath缓存重试
PHP默认开启realpath缓存机制,如果之前在文件尚未创建/移动到目标路径时,提前执行过file_exists校验,缓存会记录该路径“不存在”的状态,后续哪怕文件已经正常落位,在默认120秒的缓存有效期内,函数依然会持续返回false。
执行校验前先调用clearstatcache(true, '/home/user/projects/test_project/test.txt')清除指定路径的缓存后再测试,若返回值恢复正常,即为旧缓存导致的异常。 - 排查路径字符串的隐形非法字符
如果目标路径是从终端复制粘贴到代码中的,很容易带入换行符、零宽空格、不可见控制字符,这类字符肉眼无法识别,但会导致路径完全匹配失败。
可在调用file_exists前执行var_dump(bin2hex($目标路径变量), strlen($目标路径变量)),和正常路径的十六进制输出做对比,定位是否存在多余的隐形字符。 - 确认PHP运行环境的路径映射一致性
如果PHP运行在容器、chroot沙箱、独立应用运行环境中,宿主机上通过readlink -f得到的物理路径,不一定和PHP运行时可访问的路径完全对应。可在PHP脚本内执行shell_exec('ls -la /home/user/projects/test_project/test.txt'),如果命令无输出,说明该路径在PHP的运行命名空间内根本不存在,自然无法被校验识别。
内容的提问来源于stack exchange,提问作者Roman
相关产品推荐
相关产品推荐

