中文(繁體)
中文(繁體)
在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
