hash_hmac_file() 報錯“File not found”時該怎麼處理？詳細排查和解決方法

gitbox 2025-07-09

1. 文件路徑錯誤

最常見的原因之一是文件路徑錯誤。在調用hash_hmac_file()時，文件路徑必須準確無誤。 PHP 在執行時是基於當前工作目錄來解析文件路徑的，因此如果傳入的路徑不正確，或者相對路徑相對於當前腳本的路徑不正確，就會導致“File not found”錯誤。

解決方法：

確認文件的絕對路徑是否正確。如果使用相對路徑，確保它是相對於PHP 腳本當前所在的目錄的正確路徑。
使用realpath()函數獲取文件的絕對路徑，確保路徑解析正確。

 <span><span><span class="hljs-variable">$file_path</span></span><span> = </span><span><span class="hljs-string">'path/to/your/file.txt'</span></span><span>;
</span><span><span class="hljs-variable">$absolute_path</span></span><span> = </span><span><span class="hljs-title function_ invoke__">realpath</span></span><span>(</span><span><span class="hljs-variable">$file_path</span></span><span>);
</span><span><span class="hljs-keyword">if</span></span><span> (</span><span><span class="hljs-variable">$absolute_path</span></span><span> === </span><span><span class="hljs-literal">false</span></span><span>) {
    </span><span><span class="hljs-keyword">echo</span></span><span> </span><span><span class="hljs-string">"文件未找到"</span></span><span>;
} </span><span><span class="hljs-keyword">else</span></span><span> {
    </span><span><span class="hljs-keyword">echo</span></span><span> </span><span><span class="hljs-string">"文件的絕對路徑是： "</span></span><span> . </span><span><span class="hljs-variable">$absolute_path</span></span><span>;
}
</span></span>

2. 文件權限問題

即使文件路徑正確，PHP 進程也需要有足夠的權限來訪問該文件。如果文件的權限設置不當，PHP 可能無法讀取文件內容，從而導致“File not found”錯誤。

解決方法：

檢查文件是否對PHP 用戶具有可讀權限。
使用chmod命令修改文件的權限，使得PHP 用戶能夠讀取文件。

 <span><span><span class="hljs-built_in">chmod</span></span><span> 644 path/to/your/file.txt
</span></span>

如果PHP 正在以Web 服務器用戶身份運行，確保該用戶對文件具有讀取權限。通常，Web 服務器用戶為www-data或apache ，可以通過以下命令查看當前文件的權限：

 <span><span><span class="hljs-built_in">ls</span></span><span> -l path/to/your/file.txt
</span></span>

3. PHP 配置文件路徑限制

PHP 的配置文件php.ini中可能存在對文件訪問路徑的限制。例如， open_basedir指令限制了PHP 可以訪問的文件路徑。如果open_basedir被設置了限制，那麼PHP 將無法訪問在該限制範圍之外的文件。

解決方法：

檢查php.ini文件中是否存在open_basedir設置。
如果存在限制，修改php.ini文件，增加需要訪問的目錄路徑，或者禁用open_basedir限制。

 <span><span><span class="hljs-attr">open_basedir</span></span><span> = /var/www:/tmp:/usr/share/php:/path/to/your/files
</span></span>

修改完後，記得重啟Web 服務器或PHP-FPM 服務。

4. 文件是否存在

在執行hash_hmac_file()前，首先確認文件確實存在。如果文件不存在，PHP 會返回“File not found”錯誤。

解決方法：

在調用hash_hmac_file()前，使用file_exists()函數檢查文件是否存在。

 <span><span><span class="hljs-variable">$file_path</span></span><span> = </span><span><span class="hljs-string">'path/to/your/file.txt'</span></span><span>;
</span><span><span class="hljs-keyword">if</span></span><span> (!</span><span><span class="hljs-title function_ invoke__">file_exists</span></span><span>(</span><span><span class="hljs-variable">$file_path</span></span><span>)) {
    </span><span><span class="hljs-keyword">echo</span></span><span> </span><span><span class="hljs-string">"文件不存在"</span></span><span>;
} </span><span><span class="hljs-keyword">else</span></span><span> {
    </span><span><span class="hljs-keyword">echo</span></span><span> </span><span><span class="hljs-string">"文件存在，繼續處理"</span></span><span>;
}
</span></span>

如果文件不存在，需要確認文件路徑是否正確，或者文件是否被刪除、移動或者重命名。

5. 文件編碼問題

如果文件名中包含特殊字符或者非ASCII 字符，PHP 可能會在某些環境下無法正確識別文件路徑，從而導致無法找到文件。

解決方法：

確保文件路徑中沒有非法字符。如果有特殊字符或非ASCII 字符，可以嘗試使用mb_convert_encoding()或utf8_encode()等函數來轉換文件路徑的編碼。

 <span><span><span class="hljs-variable">$file_path</span></span><span> = </span><span><span class="hljs-string">'路徑/含有/特殊字符.txt'</span></span><span>;
</span><span><span class="hljs-variable">$encoded_path</span></span><span> = </span><span><span class="hljs-title function_ invoke__">mb_convert_encoding</span></span><span>(</span><span><span class="hljs-variable">$file_path</span></span><span>, </span><span><span class="hljs-string">'UTF-8'</span></span><span>, </span><span><span class="hljs-string">'GB2312'</span></span><span>);
</span></span>

6. 使用絕對路徑避免相對路徑錯誤

如果你確定文件在某個固定位置，最安全的做法是使用絕對路徑而不是相對路徑。這將避免因為PHP 當前的工作目錄不同而導致路徑解析錯誤。

解決方法：

使用__DIR__常量來獲取當前文件的絕對路徑，並結合相對路徑來確保正確性。

 <span><span><span class="hljs-variable">$file_path</span></span><span> = </span><span><span class="hljs-keyword">__DIR__</span></span><span> . </span><span><span class="hljs-string">'/path/to/your/file.txt'</span></span><span>;
</span></span>