标签： 数据库设置

我们无数次编辑过 wp-config.php 文件——设置高级功能、修复数据库连接问题，或者让本地开发更省心。这是那种当你需要深入挖掘 WordPress 运作方式时就会接触到的文件。一旦知道在哪里找，用起来其实很简单。

这个文件控制着你网站一些最重要的设置——比如数据库访问、调试模式和安全密钥。它就像是一个隐藏的控制面板，让你的网站平稳运行。

在本指南中，我们将向你展示如何安全地使用不同工具查找和编辑 wp-config.php 文件。你将能够做出所需的更改，而不必担心搞坏任何东西。

快速回答：如何在 WordPress 中编辑 wp-config.php 文件？

使用 FTP 客户端（如 FileZilla）或你的主机面板的 File Manager 连接到网站。在根目录中找到 wp-config.php，下载它，用纯文本编辑器编辑，然后上传覆盖。务必先做完整备份。

以下是本指南涵盖的主题列表：

• 为什么要编辑 wp-config.php 文件？
• 什么是 wp-config.php 文件？
• 编辑前先备份
• 如何安全地访问和编辑 wp-config.php 文件
• 理解 wp-config.php 文件
• MySQL 设置
• 身份验证唯一密钥和盐值
• WordPress 数据库表前缀
• WordPress 调试模式
• 绝对路径设置
• 实用的 wp-config.php 技巧和设置
• 更改 MySQL 端口和套接字
• 使用 wp-config.php 更改 WordPress 网址
• 使用 wp-config.php 更改上传目录
• 禁用自动更新
• 限制文章修订版本
• 视频教程
• 常见问题
• 下一步提升你的 WordPress 技能

为什么要编辑 wp-config.php 文件？

wp-config.php 文件让你可以直接控制无法从后台仪表盘更改的核心 WordPress 设置。

• 修复连接错误——纠正数据库凭据、更改网址，或者在无法访问后台时进行故障排除。
• 提升安全性和性能——更新安全密钥、限制文章修订版本，或者为开发环境启用调试模式。

什么是 wp-config.php 文件？

wp-config.php 是每个自托管 WordPress 网站的重要部分。它保存着帮助 WordPress 连接数据库并平稳运行的关键设置。

这个文件不包含在默认的 WordPress 下载包中。它是在安装过程中当你输入数据库信息时自动创建的。

如果这个文件中的信息不正确，你的网站将无法连接到数据库。这时你可能会看到可怕的“建立数据库连接时出错”消息。

除了数据库信息，这个文件还可以包含调试、安全密钥、内存限制等设置。我们将在后面介绍这些内容。

大多数人不需要经常触碰这个文件。但了解它的工作原理以及如何安全编辑，能让你更好地控制自己的 WordPress 网站。

既然你来到这里，很可能已经准备好做出更改。我们将带你一步步安全地编辑这个文件，避免任何麻烦。

编辑前先备份

wp-config.php 控制着网站的关键部分，哪怕一个微小的错误（比如缺少分号或多余空格）都可能导致网站离线。因此，我们强烈建议在修改之前先做一次完整的 WordPress 备份。

备份能保护你的内容、设置和文件安全——如果出现问题，你可以轻松恢复。最推荐的方法是使用 Duplicator 插件。它只需几次点击就能备份网站。

注意：Duplicator 也有免费版。需要定时备份和云存储功能的话，建议使用付费计划。

为什么推荐 Duplicator？ 因为我们在自己的网站上（包括猫哥）都使用它。它在安全性和稳定性方面表现出色。详情可查看完整的 Duplicator 评测。

如何安全地访问和编辑 wp-config.php 文件

第一步：通过 FTP 连接到你的网站

wp-config.php 文件位于你的 WordPress 主机服务器上，就在网站根目录中。你可以通过 FTP 客户端（如 FileZilla）或主机面板中的 File Manager 访问它。我们通常更推荐使用 FTP，控制更灵活。Windows 用户可以使用 FileZilla、WinSCP 或 SmartFTP；Mac 用户可以使用 FileZilla、Transmit 或 CyberDuck。

首先用 FTP 客户端连接到你的网站。你需要 FTP 登录信息，这些信息由你的主机提供商提供。如果不知道，可以联系主机支持团队。

第二步：下载并编辑文件

连接成功后，打开根目录。你会看到 wp-content、wp-includes、wp-admin 等文件夹——wp-config.php 就在这里。

右键点击文件，选择“下载”保存到本地电脑。然后用纯文本编辑器（如 Notepad 或 TextEdit）打开。我们一直在用这两种工具，简单编辑完全够用。

第三步：上传并覆盖

完成修改后，回到 FTP 客户端，将文件上传到服务器上相同的目录。FTP 客户端会询问是否覆盖，选择“覆盖”并确定即可。

理解 wp-config.php 文件

在开始之前，我们先看看默认的 wp-config.php 完整代码：

<?php
/**
 * WordPress 基础配置
 *
 * 安装脚本会在安装过程中使用此文件。
 * 你可以直接复制此文件为 wp-config.php 并填写值。
 *
 * 包含以下配置：
 *   * 数据库设置
 *   * 密钥
 *   * 数据库表前缀
 *   * ABSPATH
 *
 * @link https://developer.wordpress.org/advanced-administration/wordpress/wp-config/
 * @package WordPress
 */

// ** 数据库设置 - 请从你的主机商获取这些信息 ** //
/** 数据库名称 */
define( 'DB_NAME', 'database_name_here' );
/** 数据库用户名 */
define( 'DB_USER', 'username_here' );
/** 数据库密码 */
define( 'DB_PASSWORD', 'password_here' );
/** 数据库主机 */
define( 'DB_HOST', 'localhost' );
/** 数据库字符集 */
define( 'DB_CHARSET', 'utf8' );
/** 数据库排序规则 */
define( 'DB_COLLATE', '' );

/**#@+
 * 身份验证唯一密钥和盐值。
 *
 * 请修改为不同的唯一短语！你可以使用 WordPress.org 密钥生成服务生成。
 * 任何时候都可以更改，使所有现有 cookie 失效，强制所有用户重新登录。
 * @since 2.6.0
 */
define( 'AUTH_KEY',         'put your unique phrase here' );
define( 'SECURE_AUTH_KEY',  'put your unique phrase here' );
define( 'LOGGED_IN_KEY',    'put your unique phrase here' );
define( 'NONCE_KEY',        'put your unique phrase here' );
define( 'AUTH_SALT',        'put your unique phrase here' );
define( 'SECURE_AUTH_SALT', 'put your unique phrase here' );
define( 'LOGGED_IN_SALT',   'put your unique phrase here' );
define( 'NONCE_SALT',       'put your unique phrase here' );
/**#@-*/

/**
 * WordPress 数据库表前缀。
 * 如果在一个数据库中安装多个 WordPress，可以给每个网站设置唯一前缀。
 * 只允许使用数字、字母和下划线。
 */
$table_prefix = 'wp_';

/**
 * 开发者调试模式。
 * 在开发环境中设置为 true 可显示通知。
 * 强烈建议主题和插件开发者在开发环境使用 WP_DEBUG。
 * 更多调试常量请参考文档。
 */
define( 'WP_DEBUG', false );

/* 在此行和“停止编辑”行之间添加任何自定义值。 */

/* 到此为止，停止编辑！祝你发布愉快。 */

/** WordPress 目录的绝对路径。 */
if ( ! defined( 'ABSPATH' ) ) {
    define( 'ABSPATH', __DIR__ . '/' );
}
/** 设置 WordPress 变量和包含文件。 */
require_once ABSPATH . 'wp-settings.php';

文件中每个部分都有清晰的注释。几乎所有设置都使用 PHP 常量定义：define( 'CONSTANT_NAME', 'value' );

MySQL 设置

数据库连接设置位于“数据库设置”部分。你需要提供 MySQL 主机、数据库名称、用户名和密码。

// ** 数据库设置 - 请从你的主机商获取这些信息 ** //
define( 'DB_NAME', 'database_name_here' );
define( 'DB_USER', 'username_here' );
define( 'DB_PASSWORD', 'password_here' );
define( 'DB_HOST', 'localhost' );
define( 'DB_CHARSET', 'utf8' );
define( 'DB_COLLATE', '' );

常量名	说明
DB_NAME	WordPress 数据库名称
DB_USER	数据库用户名
DB_PASSWORD	数据库密码
DB_HOST	数据库主机（通常是 localhost）
DB_CHARSET	数据库字符集（默认 utf8）
DB_COLLATE	数据库排序规则（通常留空）

要填写这些值，你需要从主机面板获取数据库信息。以 Bluehost 为例，登录后点击网站下的“Settings”，切换到 Advanced 选项卡，点击“Manage”进入 cPanel，找到“Databases”下的“MySQL Databases”，即可看到数据库列表、用户名和密码。如果找不到，请联系你的主机商。

DB_CHARSET 和 DB_COLLATE 是什么？ DB_CHARSET 指定数据库表的字符集，默认是 utf8，但 WordPress 会在支持的服务器上自动升级为 utf8mb4（支持表情符号）。DB_COLLATE 定义排序和比较方式，建议留空，让 MySQL 使用默认排序规则。

身份验证唯一密钥和盐值

这些是安全特性，通过加强用户 cookie 的加密来保护你的网站。

define( 'AUTH_KEY',         'put your unique phrase here' );
define( 'SECURE_AUTH_KEY',  'put your unique phrase here' );
define( 'LOGGED_IN_KEY',    'put your unique phrase here' );
define( 'NONCE_KEY',        'put your unique phrase here' );
define( 'AUTH_SALT',        'put your unique phrase here' );
define( 'SECURE_AUTH_SALT', 'put your unique phrase here' );
define( 'LOGGED_IN_SALT',   'put your unique phrase here' );
define( 'NONCE_SALT',       'put your unique phrase here' );

常量名	说明
AUTH_KEY	验证 cookie 并确保数据完整性
SECURE_AUTH_KEY	在使用 SSL 时保护验证 cookie
LOGGED_IN_KEY	验证登录 cookie
NONCE_KEY	保护一次性随机数不被猜测
AUTH_SALT	为验证过程增加额外安全
SECURE_AUTH_SALT	为 SSL 验证过程增加额外安全
LOGGED_IN_SALT	为登录验证过程增加额外安全
NONCE_SALT	为一次性随机数创建和验证增加额外安全

你可以访问 WordPress.org 密钥生成器 生成新密钥。如果怀疑有人试图访问后台，也可以随时更改它们。更多信息请参考 WordPress 安全密钥 指南。

数据库表前缀

默认情况下，WordPress 使用 wp_ 前缀。建议在安装时改为随机前缀，以增加安全性，防止 SQL 注入攻击。

$table_prefix = 'wp_';

重要： 对于已有网站，不能直接修改这个值。要更改现有网站的前缀，请参考 如何更改 WordPress 数据库前缀 的教程。

调试模式

这个设置对学习 WordPress 开发或排查错误非常有用。默认情况下，WordPress 隐藏 PHP 通知。设置为 true 可以显示它们，帮助开发者定位 bug。

define( 'WP_DEBUG', false );

你还可以选择将错误记录到日志中。详细教程请参考 如何在 WordPress 中启用调试模式。

绝对路径设置

文件的最后部分定义了绝对路径，告诉 WordPress 在哪里找到核心文件，然后加载 wp-settings.php。

if ( ! defined( 'ABSPATH' ) ) {
    define( 'ABSPATH', __DIR__ . '/' );
}
require_once ABSPATH . 'wp-settings.php';

这两个设置通常不需要修改。想了解 WordPress 如何加载文件，可以查看 WordPress 后台工作原理 的解释。

实用的 wp-config.php 技巧和设置

下面介绍一些可选但非常有用的设置，可以帮助你解决常见错误。

更改 MySQL 端口和套接字

如果你的主机商使用非标准端口，需要修改 DB_HOST 值，添加端口号：

define( 'DB_HOST', 'localhost:5067' );

如果使用套接字，则写成：

define( 'DB_HOST', 'localhost:/var/run/mysqld/mysqld.sock' );

使用 wp-config.php 更改 WordPress 网址

迁移网站到新域名时，你可能需要更改网址。虽然可以在后台设置中修改，但如果你无法访问后台（例如遇到“重定向过多”错误），可以通过添加以下两行代码来解决：

define('WP_HOME','http://example.com');
define('WP_SITEURL','http://example.com');

注意：www.example.com 和 example.com 被视为不同位置，请根据你的实际情况填写。

使用 wp-config.php 更改上传目录

默认上传目录是 /wp-content/uploads/。如果想存储到其他位置，可以添加：

define( 'UPLOADS', 'wp-content/media' );

注意：路径是相对于 ABSPATH 的，不要使用绝对路径。

禁用自动更新

WordPress 默认启用自动更新，当有安全更新时会自动安装。如果你担心自动更新导致网站出问题，可以添加以下代码禁用所有自动更新：

define( 'WP_AUTO_UPDATE_CORE', false );

更多信息请参考 如何禁用 WordPress 自动更新。

限制文章修订版本

WordPress 默认保存所有修订版本，可能占用大量数据库空间。你可以限制保留的修订版本数量：

define( 'WP_POST_REVISIONS', 3 );

将 3 替换为你希望保留的数量。注意，这只会限制新修订版本，旧版本仍然存在。你可以使用插件或 SQL 查询清除旧版本。

视频教程

想看更直观的演示？可以观看我们的 YouTube 视频教程：

别忘了 订阅猫哥的 YouTube 频道 获取更多 WordPress 视频教程。

常见问题

wp-config.php 文件在哪里？

它位于 WordPress 根目录（与 wp-admin、wp-content、wp-includes 同级的文件夹）。你可以通过 FTP 或主机面板的 File Manager 访问。

能否从 WordPress 后台编辑 wp-config.php？

不能。你必须使用 FTP 或主机面板的 File Manager 直接编辑服务器上的文件。

如果编辑出错会怎样？

哪怕一个微小的错误（如缺少分号）都可能导致整个网站离线。所以修改前一定要备份原始文件。

如何重置安全密钥和盐值？

访问 WordPress.org 密钥生成器 获取新密钥，替换 wp-config.php 中的对应值。这会使所有用户重新登录。

是否应该更改默认数据库前缀？

是的，在安装时改为随机前缀可以增加一层安全防护。但不要在已有网站上直接修改，需要按照正确指南操作，否则会破坏数据库连接。

下一步提升你的 WordPress 技能

现在你已经学会编辑 wp-config.php 了，也许还想了解其他优化技巧。我们为你整理了几个实用的教程：

• 如何在 wp-config 中设置 WordPress 错误日志
• 最受欢迎的 WordPress 技巧、窍门和黑客
• 最实用的 .htaccess 技巧
• 最省时的 WordPress 键盘快捷键

如果你喜欢这篇文章，请订阅我们的 YouTube 频道，或在 Twitter 和 Facebook 上关注我们。另外，如果你在寻找可靠的主机服务，推荐你试试 Hostinger 主机，性价比高且速度优秀。关于 SEO 优化方面，可以了解 GEO 搜索引擎优化技巧。