织梦CMS数据库链接失败怎么办？

核心配置文件

织梦CMS数据库链接信息存储在网站根目录下的一个名为 common.inc.php 的文件中，这个文件是织梦系统的核心配置文件之一。

文件路径： /网站根目录/include/common.inc.php

如何修改数据库链接信息

您会遇到以下两种情况：

全新安装织梦CMS

在安装织梦CMS的过程中,安装程序会引导您填写数据库信息，您填写的信息最终就会被写入到 common.inc.php 文件中，如果您正在安装，只需按照安装向导的提示操作即可。

已安装的网站需要修改数据库信息（更换数据库、修改密码等）

这是最常见的需求,比如您更换了主机、重置了数据库密码等，请按照以下步骤操作：

第1步：找到并打开 common.inc.php 文件

• 通过FTP或文件管理器

  • 使用您的FTP客户端（如FileZilla）或虚拟主机提供的文件管理器登录您的服务器。
  • 进入您的网站根目录。
  • 找到 include 文件夹，并进入它。
  • 找到 common.inc.php 文件，并将其下载到您的本地电脑。

• 通过主机控制面板

  • 登录您的主机控制面板（如cPanel、宝塔面板等）。
  • 找到“文件管理器”工具。
  • 导航到网站根目录下的 /include/ 文件夹。
  • 找到 common.inc.php 文件，点击“编辑”。

第2步：找到数据库配置代码块

打开 common.inc.php 文件后，找到类似下面这样的代码块（通常在文件的开头部分）：

<?php
//数据库连接信息
$cfg_dbhost = 'localhost'; //数据库主机
$cfg_dbname = 'dedecmsv57'; //数据库名
$cfg_dbuser = 'root'; //数据库用户名
$cfg_dbpwd = 'your_password'; //数据库密码
$cfg_dbprefix = 'dede_'; //数据表前缀
$cfg_db_language = 'gbk'; //数据库语言版本
?>

注意： 在一些新版本或特定环境下，您可能会看到 $cfg_dbhost 等变量被定义在一个函数内部，或者使用了常量，但其本质和作用是完全一样的，找到这些变量进行修改即可。

第3步：修改数据库信息

根据您的实际数据库信息,修改上面代码中的每一项：

• $cfg_dbhost = 'localhost';

  • 数据库主机地址：通常是 localhost，如果您的数据库和网站不在同一台服务器上，这里需要填写数据库服务器的IP地址或域名。请务必确认此项是否正确，这是最常见的连接失败原因。

• $cfg_dbname = 'your_database_name';

  • 数据库名称：您在MySQL中创建的数据库名称。my_website_db。

• $cfg_dbuser = 'your_database_user';

  • 数据库用户名：您有权限访问该数据库的用户名。admin_user。

• $cfg_dbpwd = 'your_password';

  • 数据库密码：对应用户的密码。请确保密码准确无误，注意大小写和特殊字符。

• $cfg_dbprefix = 'dede_';

  • 数据表前缀：安装织梦时设置的数据表前缀，如果您在安装时修改过（例如改为 abc_），这里就必须保持一致，如果您不确定，可以登录phpMyAdmin查看您的数据库表，所有表名都以这个前缀开头。

• $cfg_db_language = 'gbk'; 或 $cfg_db_language = 'utf8';

  • 数据库字符集：这必须与您的数据库创建时指定的字符集一致，现在绝大多数新网站都使用 utf8 或 utf8mb4，如果网站出现乱码，很可能是这里设置错误。

第4步：保存文件并上传

• 修改完成后,保存 common.inc.php 文件。
• 如果您是下载到本地修改的,请务必通过FTP或文件管理器将修改后的文件重新上传到服务器原来的位置 (/include/common.inc.php)。
• 重要： 上传时请确保文件权限设置正确（通常是644）。

第5步：测试连接

完成以上步骤后,访问您的网站首页，如果网站能正常打开，并且没有出现“无法连接数据库”之类的错误提示，说明数据库链接配置成功。

如果出现错误,请仔细检查您在 common.inc.php 中填写的每一项信息是否都与您的数据库信息完全一致。

常见问题排查

1. 错误提示：Can't connect to MySQL server on 'localhost' (10061)

   • 原因：数据库服务未启动，或者数据库主机地址 localhost 不正确，尝试将 localhost 改为 0.0.1，如果还是不行，请联系您的空间服务商确认数据库服务状态。

2. 错误提示：Access denied for user 'username'@'localhost' (using password: YES)

   • 原因：数据库用户名或密码错误，请仔细核对 $cfg_dbuser 和 $cfg_dbpwd 的值。

3. 错误提示：Unknown database 'database_name'

   • 原因：数据库名称 $cfg_dbname 错误，或者该数据库尚未在MySQL中创建。

4. 网站出现乱码

   • 原因：网站编码与数据库编码不匹配，请检查 common.inc.php 中的 $cfg_db_language 设置，以及系统后台的“系统参数”中的网站编码设置，确保它们三者统一（全部为 utf8 或全部为 gbk）。

5. 文件 common.inc.php 不存在或无法写入

   • 原因：文件被误删，或者文件权限设置不当导致无法保存，请确保文件存在，并将其权限设置为 644（Linux/Unix系统下）。

安全提示

common.inc.php 文件包含了您网站数据库的“钥匙”，安全性至关重要。

• 设置文件权限：确保 common.inc.php 的文件权限设置为 644，即所有者可读写，组用户和其他用户只读，这可以有效防止被非法篡改。
• 不要泄露：不要将此文件随意上传到公共网盘或通过不安全的方式传输。
• 定期备份：在修改网站前，最好备份一下这个文件，以防误操作导致网站无法访问。

希望这份详细的指南能帮助您成功配置织梦CMS的数据库链接！