is_readable() 返回 false 的常见原因包括文件不存在、路径越界、SELinux 拦截、open_basedir 限制、目录缺 x 权限、符号链接目标不可读及 stat 缓存未更新。
is_readable() 返回 false 的常见原因不是权限问题
直接调用 is_readable() 却返回 false，第一反应常是“chmod 644 不行？”，但真实原因往往更隐蔽。它失败时并不区分「文件不存在」「路径越界」「SELinux 拦截」或「open_basedir 限制」，统一返回 false，且只抛 E_WARNING（默认不显示）。排查时优先检查这些点：
- 用
file_exists($path)先确认路径存在——is_readable()对不存在的路径也返回false - 检查 PHP 进程实际运行用户（如
www-data或nobody），用ps aux | grep apache或id -u -n验证，而非你登录的用户名 - 运行
php -i | grep open_basedir，若输出非no value，说明路径被白名单限制，is_readable()会静默失败 - Linux 下执行
ls -ld /path/to/dir和ls -l /path/to/file，确认目标目录有x权限（否则无法进入）、文件有r权限，且用户属于对应 owner/group
对目录调用 is_readable() 会返回 true，这不是 bug
is_readable() 对目录返回 true 是设计行为：目录“可读”指能列出其内容（即 scandir() 可用），不是说你能读取目录本身。这容易导致逻辑误判，比如你想确保传入的是一个可读的配置文件，却意外接受了某个可列目录。
- 若需严格判断「普通文件且可读」，必须组合使用：
is_file($path) && is_readable($path) - 若只需确认「能访问该路径下的内容」，比如扫描日志目录，则单独用
is_readable($path)就够了 - 注意符号链接：函数检查的是链接指向的目标文件权限，不是链接自身的权限位
缓存导致 is_readable() 结果不实时
is_readable() 的结果会被 PHP 内部 stat 缓存，这意味着文件权限或存在状态变更后，函数可能仍返回旧值。尤其在脚本中反复检查同一路径时（如轮询监控），容易误判。
- 调用前加
clearstatcache(true, $path)可清除指定路径的缓存（PHP 5.3+） - 若检查多个路径，用
clearstatcache()清空全部缓存，但代价略高 - 生产环境慎用无条件清缓存——高频调用会拖慢性能；建议仅在已知权限刚变更后（如部署脚本中 chmod 后）才显式清理
is_readable() 不等于 fopen() 成功，但它是必要前置
返回 true 只表示「此刻可读」，不代表后续 fopen($path, 'r') 一定成功。文件可能被其他进程瞬间删除、改权限、或加 flock 锁。线上关键流程不能只依赖它。
立即学习“PHP免费学习笔记（深入）”；
- 安全做法是两段式：先
if (is_readable($path)) { $fp = @fopen($path, 'r'); }，再检查$fp === false - 用
@抑制fopen()失败时的警告，避免污染错误日志；业务层应根据需要记录或跳过 - 不要用
fileperms($path) & 0400替代——它只看 owner 读位，忽略 group/others、SELinux、Windows ACL 等真实限制，线上几乎必错
is_readable() 是个快速守门员，但不该是唯一裁判。 
