hash_file() 返回 false 的直接原因是文件不可读或路径错误；需检查 file_exists() 和 is_readable()，优先使用绝对路径，注意权限、I/O 阻塞及超时问题。
hash_file() 计算文件哈希时返回 false 是什么情况
直接原因是文件不可读或路径错误，不是函数本身出问题。hash_file() 不会抛异常，只在失败时静默返回 false，容易被忽略。
- 检查
file_exists($path)和is_readable($path)是否都为true，尤其注意 PHP 进程用户（如 www-data）是否有权限读取该文件 - 相对路径容易出错——
hash_file('md5', 'data.zip')依赖当前工作目录（getcwd()），建议一律用绝对路径：hash_file('md5', __DIR__ . '/data.zip') - 大文件不会超内存，但若磁盘 I/O 被阻塞（如 NFS 挂载异常、文件正被其他进程独占写入），也可能返回
false
MD5 和 SHA1 在 hash_file() 中的性能与安全性差异
两者调用方式完全一样，但用途和风险完全不同：SHA1 已不推荐用于安全校验，MD5 更快但更不安全。
-
hash_file('md5', $path)比hash_file('sha1', $path)快约 10%–15%，差别主要来自算法轮数，对百 MB 级文件影响不到 100ms - 不要用
md5或sha1校验下载完整性——碰撞攻击早已实用化；生产环境请改用sha256或sha384 - 如果只是做快速去重（比如判断两个上传文件内容是否相同），
md5仍可接受，但需确认场景无恶意输入
校验大文件时内存占用和超时问题
hash_file() 内部是流式读取，内存占用恒定（约几 KB），但执行时间可能触发 PHP 超时。
- 默认
max_execution_time是 30 秒，1GB 文件在机械硬盘上可能跑满；可在脚本开头加set_time_limit(0)（仅 CLI 或未启用安全模式时有效） - Web 服务器（如 Nginx）也有自己的超时设置（
fastcgi_read_timeout），光调 PHP 不够，得同步检查 - 不需要一次性算完整哈希？可用
hash_init()+hash_update_stream()分块处理，便于加进度回调或中断控制
为什么 file_get_contents() + hash() 组合不如 hash_file()
有人图方便写 hash('md5', file_get_contents($path))，这在小文件上能跑通，但实际是危险操作。
立即学习“PHP免费学习笔记（深入）”；
-
file_get_contents()会把整个文件加载进内存，1GB 文件直接 OOM，而hash_file()始终只用固定缓冲区 - 二进制文件（如 ZIP、PDF）可能含
\0字节，file_get_contents()在某些老版本 PHP 中会截断（已修复，但兼容性难保） - 多了一次内存拷贝，纯性能损失，没任何好处
false，得靠日志+权限双查才定位得准。 
