跳到主要内容

如何排除和修复 WordPress 核心文件问题

运行 WordPress 网站可能会很棘手,尤其是在遇到问题时。一个常见的问题是 WordPress 核心文件损坏或丢失的错误。那么,这些核心文件是什么,为什么它们很重要?它们对于保持您的网站顺利运行至关重要!

  • 什么是 WordPress 核心文件?
  • 为什么不应该修改核心文件?
  • 您可以在哪里找到 WordPress 核心文件?
  • WordPress 核心文件问题的迹象
  • 排除故障前的准备
  • 如何排除核心文件错误
  • 如何修复 WordPress 核心文件
  • 常见问题解答
  • 总结

什么是 WordPress 核心文件?

WordPress 核心文件是使您的 WordPress 网站运行的基本文件。这些包括 PHP 脚本文件和目录,如:

  • wp-config.php
  • wp-settings.php
  • /wp-includes/
  • /wp-admin/

这些文件处理 WordPress 的操作方式,并且是每个 WordPress 安装的一部分。除非您确切知道自己在做什么,否则不应手动修改它们。

为什么不应该修改核心文件?

修改核心文件可能会导致:

  • 数据完整性问题:更改可能会干扰平台的功能并使故障排除变得复杂。
  • 法律问题:未经授权的修改可能会违反许可协议和道德准则。
  • 证据丢失:核心文件对于诊断错误至关重要;更改可能会抹去有效故障排除所需的重要信息。
  • 可用的调试工具:请使用日志插件和错误报告功能,而不是去修改核心文件。
  • 进一步损坏的风险:在没有适当知识的情况下进行更改可能会引入更多问题。

始终使用插件、主题或 functions.php 文件进行自定义。或者,考虑适合您需求的选项:什么是 WP-Content 上传以及如何在 WordPress 中上传文件。

您可以在哪里找到 WordPress 核心文件?

要找到它们:

  1. 登录到您的主机账户的文件管理器,或通过 FTP 访问您的网站。
  2. 导航到根目录,通常是(/public_html/)。
  3. 查找文件,如
  • /wp-config.php:将 WordPress 安装连接到所需的数据库
  • /wp-admin/:包含 WordPress 管理仪表板所需的文件和资源。
  • /wp-includes/:包含核心 WordPress 文件,如库、函数和类。
  • /wp-content/:虽然严格来说不是核心 WordPress 文件的一部分,但该目录包含用户生成的内容,如主题、插件和上传的媒体。它是 WordPress 功能的重要目录,但不包含核心 WordPress 代码。

您还可以直接从官方 WordPress 存储库 wordpress.org 访问 WordPress 核心文件。这对于下载最新版本的 WordPress 或特定版本以进行安装或开发目的特别有用。

WordPress 核心文件问题的迹象

如果您注意到以下情况,您可能正在处理损坏或丢失的核心文件:

  • 死亡白屏(空白屏幕)
  • “发生了严重错误”消息
  • WordPress 登录问题
  • 布局损坏或页面丢失
  • 网站重定向到奇怪的 URL
  • 500 内部服务器错误

排除故障前的准备

在进行任何更改之前,请务必备份您的网站:

  • 使用 Bluehost 的备份工具或像 UpdraftPlus 这样的插件。
  • 如何创建手动备份
  • 如何备份 MySQL 数据库
  • Jetpack 备份和恢复
  • CodeGuard:如何保护您的网站
  • 保存您的 网站文件数据库。要了解更多关于此过程的信息,请遵循以下任一指南以备份您的网站:为备份设置 CodeGuard 或如何备份我的 WordPress 网站。

此外:

  • 在升级之前,检查您的网站与新版本 PHP 的“兼容性”。使用 WordPress 构建的网站可以使用插件兼容性检查器插件。我们共享主机服务器上的最低 PHP 版本为 8.1。您还可以查看 PHP 手册以回顾 PHP 的新特性和已弃用特性。
  • 暂时停用所有插件。如果您无法访问 WordPress 仪表板,可以在数据库中或通过文件管理器或 FTP 关闭插件。

如何排除核心文件错误

  1. 启用 WordPress 调试模式。
  2. 再次打开网站以生成错误,然后检查结果。
  3. 检查您的网站是否有 PHP 错误。如果有 PHP 错误,请查看文件路径是否包含对 WordPress 核心文件或文件夹的引用。 这些错误通常指向 wp-admin 或 wp-includes 文件夹中的文件。 以下是一个示例: ```

致命错误:require(): 无法打开所需的 '/home/user/public_html/wp-includes/class-wp.php'


* 如果错误的文件路径包含对核心文件或文件夹的引用,您可以继续解决问题。
* 如果错误在您的网站上不可见,请查看错误日志。
* 如果您在日志或详细错误中看到与核心文件相关的 PHP 错误,您可以开始修复它。

4. 在 wp-config.php 文件中将 WP DEBUG 从 **true** 更改为 **false** 以禁用 WordPress 调试模式。

## 如何修复 WordPress 核心文件
WordPress 网站管理员可以通过导航到 ** _/wp-admin/update-core.php_** 来验证其 WP 安装的状态并检查主应用程序或任何相关插件是否有可用更新。
大多数用户可以使用 WordPress 内置的自动更新功能,通过单击一次安装最新的稳定版本。在这种情况下,WP 将自动进入维护模式,在后台下载并应用核心更新,然后确认过程的成功。然而,如果 WordPress 配置错误或以不正确的文件权限转移,自动更新功能可能会失败,网站可能会停留在维护模式中。
* 选项 1:使用 Bluehost 扫描和修复
* 选项 2:通过管理面板更新 WordPress
* 选项 3:手动替换核心文件

### 选项 1:使用 Bluehost 扫描和修复
1. 登录到您的 Bluehost 账户管理器。
2. 在左侧菜单中,点击 **网站**。
3. 点击您要管理的网站旁边的 **管理** 按钮。
![Bluehost 账户管理器 - 网站管理按钮](https://content.bluehost.com/bluehost/img/bh-portal/websites_tab/bh-am-websites-tab-manage-button.png)

1. 转到 **安全** 标签。
![网站 - 安全标签](img/core-files-warning-in-wordpress-tools_00_606e94fd.png)
2. 滚动到 **检查核心 WordPress 文件** 瓦片,点击 **扫描核心文件** 以扫描和修复核心文件。
![Bluehost 主机标签 - 扫描核心文件](img/core-files-warning-in-wordpress-tools_01_5aef3894.png)
* 如果未发现问题,您将看到一个弹出窗口:“_您的 example.com 的 WordPress 核心文件已被扫描,未检测到任何修改。_”
* 如果发现问题,请选择 **修复**。

### 选项 2:通过管理面板更新 WordPress
如果您的仪表板可以访问:
1. 登录到您的 Bluehost 账户管理器。
2. 在左侧菜单中,点击 **网站**。
3. 点击您要管理的网站旁边的 **WORDPRESS ADMIN** 按钮。
![Bluehost 账户管理器 - 网站 WordPress 管理按钮](https://content.bluehost.com/bluehost/img/bh-portal/websites_tab/bh-am-websites-tab-wordpress-admin-button.png)

1. 转到 **仪表板 > 更新**。
![Bluehost WP 管理仪表板更新](img/core-files-warning-in-wordpress-tools_02_5cbbfc8b.png)
2. 点击 **重新安装版本 x.x**。此操作将替换所有核心文件,而不会影响您的内容。
![Bluehost WP 管理仪表板更新重新安装版本](img/core-files-warning-in-wordpress-tools_03_5c72dfa3.png)
3. 等待更新完成。

### 选项 3:手动替换核心文件
**重要:** 请勿删除 `wp-content/` 或 `wp-config.php`。
1. 从 wordpress.org 下载最新的 WordPress 版本。
2. 在您的计算机上解压缩 ZIP 文件。
3. 使用 FTP 或文件管理器,将以下内容上传到您网站的根目录:
* `/wp-admin/`
* `/wp-includes/`
* 根目录中的所有文件(除了 `wp-content` 和 `wp-config.php`)
4. 在提示时覆盖。

## 常见问题解答
* **这会影响我的帖子或图片吗?**
不,只要您不删除 `wp-content/` 或数据库。

* **我怎么知道问题是否是插件造成的?**
停用所有插件并检查问题是否解决。如果解决了,请逐个重新启用它们。

* **如果我根本无法访问仪表板怎么办?**
使用 FTP 或文件管理器手动更新或恢复备份。

## 总结
WordPress 核心文件错误可能会破坏您的网站,但通常是可以修复的。按照本指南安全地诊断和修复问题,使用 Bluehost 内置的工具或手动恢复文件。在开始之前,始终备份!