hash_file() 是流式计算文件哈希的最优方案，既准确又高效；需注意路径编码、超时设置和严格比较（===），避免中文路径失败、超时中断或松散比较引发的碰撞误判。
用 hash_file() 做快速一致性比对
直接比文件内容字节最准，但大文件读取慢；hash_file() 绕过读取、由 PHP 底层用流式计算哈希，既准又快。它默认用 md5 算法，兼容性好，PHP 5.1.2+ 都支持。
常见错误是传错路径或忽略返回值类型：它返回的是十六进制字符串（如 "d41d8cd98f00b204e9800998ecf8427e"），不是二进制，别拿 === 去跟 file_get_contents() 结果硬比。
- 确保两个路径都存在且可读，否则返回
false，不抛异常 - 算法选
sha256更安全（防碰撞），但校验值更长，小文件差异不大 - 不要用
md5_file()—— 它只是hash_file("md5", ……)的别名，无实质区别
遇到中文路径或特殊字符打不开文件？
hash_file() 内部调用 fopen()，在 Windows 或某些 Linux 环境下，如果路径含中文、空格或 Unicode 字符，可能因编码不一致失败。PHP 本身不自动转码，得自己处理。
- 用
mb_convert_encoding($path, "UTF-8", "auto")强制统一编码（仅限 PHP 环境能识别该编码） - 更稳妥的做法是先
realpath($path)，再传给hash_file()，避免相对路径 / 符号链接干扰 - Linux 下注意 SELinux 或 AppArmor 限制，
stat()都失败时，hash_file()必然报错
大文件（>1GB）校验卡住或内存爆掉？
hash_file() 是流式计算，理论上不占大量内存，但实际卡顿往往来自磁盘 I/O 或 PHP 的 max_execution_time 超时，而非算法本身。
立即学习 “PHP 免费学习笔记（深入）”；
- 调大超时：
set_time_limit(300)（单位秒），别依赖默认 30 秒 - 避免在 Web 请求中校验超大文件——改用 CLI 模式运行，绕过超时和输出缓冲限制
- 不用
file_get_contents()+md5()，那会把整个文件读进内存，1GB 文件直接 OOM
为什么 == 比较哈希值有时出错？
哈希结果是字符串，但 PHP 的松散比较 == 可能触发类型转换：比如哈希以 "0e123……" 开头，会被当成科学计数法解析为 0，导致不同文件“相等”。这是真实发生过的线上事故。
- 必须用严格比较：
===，确认类型和值完全一致 - 校验前先判断是否为
false，防止一个成功一个失败却误判为“相同” - 如果要记录差异，建议同时输出两个哈希值，而不是只返回布尔结果
哈希校验看着简单，但路径编码、超时控制、比较方式这三点，任何一个没兜住，就会在上线后某个冷门场景里突然失效。
