Tutorial/教程 XenForo 文件哈希值hashes修正方法

[oksgo]

在 XenForo 中，文件的哈希值用于确保文件的完整性，特别是在安装或升级 XenForo 时，系统会检查文件的哈希值是否与官方提供的哈希值一致。如果你手动修改了 XenForo 的文件，系统可能会检测到文件的哈希值与原来的不匹配，进而可能导致警告或功能问题。

要修改 XenForo 文件的哈希值，通常需要更新 XenForo 的文件校验数据。以下是一些方法和步骤：

1.绕过哈希值校验​

如果你只是需要暂时修改文件并希望绕过哈希校验，你可以在配置文件中禁用哈希校验：​

• 打开 src/config.php 文件。
• 添加以下行：

• $config['checkFileHashes'] = false;

• 这样，XenForo 在后台运行时将不再检查文件的哈希值。

2. 更新文件哈希值（手动）

在某些 XenForo 版本中，你可以使用 XenForo 的命令行工具来重新生成或更新文件的哈希值：​

• 通过 SSH 进入 XenForo 安装目录。
• 使用 XenForo 提供的命令行工具重新生成文件的哈希值。这通常是通过 php cmd.php xf:file-check 命令来完成的，但这个命令主要用于检查文件而不是更新哈希。
• 获取文件的新哈希值：使用 PHP 的 md5_file() 函数或类似工具获取文件的新 MD5 哈希值。一下为示例代码：
  

  $hash = md5_file('path/to/your/file.php');
  echo $hash;

• 更新 XenForo 的校验数据：找到保存哈希值的地方，并将新的哈希值替换旧的哈希值。这通常涉及到编辑 XenForo 的文件或数据库，具体取决于版本和设置。

如果 XenForo 使用的是 64 位哈希值（通常为 SHA-256 哈希值），而不是 32 位 MD5 哈希值，那么你需要生成并使用 SHA-256 哈希值。下面是更新和替换哈希值的步骤：

1. 生成 SHA-256 哈希值​

使用 sha256_file() 函数生成文件的 SHA-256 哈希值，以 XF.php 文件为例：

php -r "echo hash_file('sha256', 'src/XF.php');"

这些命令将分别生成每个文件的 SHA-256 哈希值。

确保将每个文件的哈希值记录下来并粘贴写入对应的hashes.json文件。

完成上述步骤后，运行文件检查命令确认问题是否解决：

php cmd.php xf:file-check

如果哈希值更新成功，应该不会再显示文件不一致的警告。

如果你经常需要修改文件并更新哈希值，可以考虑创建一个自定义的脚本或工具，来自动化哈希值的计算和更新。​

注意事项

• 备份：在进行任何操作之前，确保你备份了 XenForo 安装目录和数据库，以防出现问题。
• XenForo 更新：请注意，每次 XenForo 更新或升级时，文件的哈希值可能会重新计算，因此需要重新应用这些修改。

通过这些方法，你可以管理和修改 XenForo 中的文件哈希值，避免系统检测到文件被修改并发出警告。

 

Tutorial/教程  XenForo 2.2 到 XenForo 2.3 升级指南

Version  XenForo 2.3.3 及附加组件发布