WordPress 配置文件 wp-config.php 详细解说

老魏记得学习 WordPress建站初期经常遇到下面这类情况，使用虚拟主机，按照网上教程一步步填写数据库名、用户名、密码、数据库主机，点击下一步的时候，突然出现了“无法写入 wp-config.php 文件”的错误提示。那么什么是 wp-config.php 文件？为什么要把数据库信息写入到这个文件中去呢？

wp-config.php文件是 WordPress配置文件，主要用于连接 MySQL 数据库配置信息，以及其他用途。从 WordPress下载的安装包里面是没有这个文件的，wp-config.php文件会在安装 WordPress时自动生成，生成后包含了当前网站的 MySQL 设置信息、数据库表前缀、账号、密钥等。

仔细观察 WordPress安装目录会发现，默认有一个 wp-config-sample.php文件，遇到本文开头无法写入 wp-config.php 文件的情况时，可以使用 ftp软件手动下载 wp-config-sample.php文件，去掉 sample改名为 wp-config.php，再手动添加相关数据库信息，上传至服务器根目录即可。

提示：老魏曾经编辑 WordPress文件出错，所以不要用文本文档、Word文档去修改 WordPress文件，建议使用常用网站文件编辑软件 Dreamweaver、Notepad++、Editplus等编辑器操作。

1、wp-config.php文件内容讲解

数据库信息填写

当我们下载到一份全新 WordPress压缩包之后，里面的 wp-config-sample.php文件中，关于数据库信息的部分如下：

/** WordPress数据库名 */
define( 'DB_NAME', 'database_name_here' ); 

/** MySQL 数据库用户名 */
define( 'DB_USER', 'username_here' );

/** MySQL 数据库密码 */
define( 'DB_PASSWORD', 'password_here' );

/** MySQL 主机 */
define( 'DB_HOST', 'localhost' );

/** 创建数据库的默认文字编码. */
define( 'DB_CHARSET', 'utf8' );

/** 数据库整理类型，勿改. */
define( 'DB_COLLATE', '' );

当我们使用宝塔面板建站时，系统会自动生成数据库信息，我们只需要把信息手动填入即可。

• DB_NAME：把“database_name_here”替换成网站数据库名称。这里看清楚是数据库名称而不是登录数据库的用户名（MySQL中允许有多个数据库存在）。实际上除了虚拟主机之外，宝塔面板生成的数据库名和用户名都是相同的，这里搞明白数据库名和数据库用户名的区别及使用环境即可。
• DB_USER和DB_PASSWORD：数据库用户名和密码。把“username_here”与“password_here”换成用户名和密码。
• DB_HOST：localhost是默认数据库主机，如果提示主机名不对，尝试改成“127.0.0.1”就可以了（遇到这种情况的几率不高）。
• utf8 这种数据库文字编码是国际标准化，兼容多国语言无需更改。
• 数据库整理类型，如果用不到、不懂就不要改。
• 我们手动编辑填入的数据库信息，主要是上面 1和2的信息。

安全密钥

接下来是安全密钥，由 WordPress自动生成，无需更改。

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' );

2、数据库表格前缀

$table_prefix  = 'wp_';

数据库表格前缀是数据库表的记号，每个数据库表的都有属于自己的表前缀。

• 如果数据库中有多个网站，那么老魏建议修改 WordPrses数据库默认 wp_ 为不同的表前缀。好处如下：
• 非默认表前缀降低数据库受攻击的可能性，也等于提高了网站安全性。
• 多个WordPress数据库都使用默认表前缀“wp_”，后期编辑数据库表的时候不容易分辨清楚哪个是哪个，对应的是哪个网站。

3、开发者调试

define('WP_DEBUG', false);

WP_DEBUG：查看 WordPress错误提示，默认关闭，把  false 修改成  true 就能打开错误提示功能。

其他 wp-config.php 文件内容我们不需要了解也不要去碰了。

4、与wp-config.php文件相关的问题

解决“不能写入wp-config.php文件”

现在来回答本文开头的问题，安装WordPress 出现“抱歉，不能写入wp-config.php文件”的主要原因是该文件没有写入权限。解决方法有多种如下：

• 网站根目录先把数据库信息填写进 wp-config-sample.php文件，然后改名为 wp-config.php并上传到网站根目录。
• 服务器修改权限文件权限到 755 或者 777看能否解决问题。

无法正确连接数据库

安装 WordPress的默认数据库主机地址是 localhost，偶尔会遇到报错无法正确连接数据库，出现这种情况把localhost改成127.0.0.1 差不多就能解决了。

/** MySQL主机 */
define('DB_HOST', 'localhost');

/** MySQL主机 */
define('DB_HOST', '127.0.0.1');

当然也不排除有别的可能性导致无法连接数据库，这就需要了解WordPress提示建立数据库连接出错的解决办法。

有时候老魏也会遇到一些比较意外的 wp-config.php文件错误，比如wordpress 后台提示 define(‘WP_ALLOW_REPAIR’, true)的解决办法。

wp-config.php 文件还有一些其他作用，禁用文章修订、修改自动保存间隔、指定文章修订的数量、设置Cookie域、启用多站点/网络能力、增加分配给PHP的内存等， 用的比较少这里就不说了。

魏艾斯总结

wp-config.php 文件主要是用于链接数据库的，里面填入数据库名、数据库用户名、密码之后就可以自动连接到 MySQL数据库开始工作。对于大部分 WordPress建站的站长来说，能够通过本文的讲解，去解决 WordPress安装过程中无法写入 wp-config.php文件等一系列小问题，了解到这个程度就可以了。那些太过于晦涩难懂的技术语言留给开发者去学习吧。