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>