简体中文
简体中文
在 PHP 中，md5_file() 是一个非常实用的函数，用于计算指定文件内容的 MD5 散列值。其基本语法如下：
md5_file(string $filename, bool $binary = false): string|false
这个函数在处理文件校验、缓存机制、文件完整性验证等场景中非常常见。然而，在实际使用过程中，开发者可能会遇到一个令人困惑的问题：明明文件存在，路径也正确，但 md5_file() 却返回 false。这通常是由于文件权限问题引起的。本文将详细解析其原因、常见场景以及解决方案。
md5_file() 在内部会尝试读取整个文件内容，以便对其执行 MD5 运算。因此，如果 PHP 脚本运行时的权限不足以读取目标文件，该函数就会返回 false。
对于 md5_file() 来说，文件必须具备“可读权限”。这包括以下几个维度：
文件本身必须对当前执行用户（如 www-data）可读。
所有上层目录必须具备“执行权限”（也就是能被“进入”）以便 PHP 能访问该路径。
SELinux、AppArmor 等系统安全模块可能也会影响访问权限。
当文件权限为 600（所有者可读写）时，若 PHP 执行用户不是文件的所有者，就会无法读取该文件。
-rw------- 1 root root 1024 May 28 10:00 secret.txt
如果 PHP 是以 www-data 用户运行，那么它将无法读取上述文件，md5_file() 会失败。
即便文件本身有读权限，但如果目录权限不允许 PHP 进入，也无法访问文件。
drwx------ 2 user user 4096 May 28 10:00 /var/private/
这种情况下，即使文件设置成 644，PHP 也无法访问 /var/private/secret.txt。
某些 Linux 系统启用了 SELinux 或 AppArmor，哪怕文件权限看起来“正常”，也可能被系统策略限制。
可以使用如下命令检查 SELinux 的限制：
ls -Z /path/to/file
确保目标文件对 PHP 用户具有读取权限。最简单的办法是将文件权限设为 644，并且确保 PHP 用户对目录也有权限：
chmod 644 /path/to/file.txt
chown www-data:www-data /path/to/file.txt
可以通过以下 PHP 代码临时调试查看当前执行用户：
echo get_current_user(); // 或者使用 posix_geteuid()
确保该用户有权限访问目标文件和目录。
在调用 md5_file() 之前，先检测文件是否可读，以避免直接出错：
$file = '/var/data/file.txt';
if (is_readable($file)) {
$hash = md5_file($file);
echo "Hash: $hash";
} else {
echo "文件不可读，请检查权限";
}
如果是在启用 SELinux 的系统上，可能需要通过 chcon 命令修改上下文：
chcon -t httpd_sys_content_t /path/to/file.txt
或者暂时关闭 SELinux 测试（不建议用于生产环境）：
setenforce 0
如果你使用的是 CDN 或类似 https://m66.net/files/check.txt 这样的远程地址，md5_file() 也会失败。因为它只能处理本地文件路径，不能处理 URL。远程文件可以使用如下方法先下载再处理：
error_reporting = E_ALL
display_errors = On
