在 DedeCMS 中,数据库连接信息主要存储在一个核心配置文件中,这个文件对于网站的正常运行至关重要。

(图片来源网络,侵删)
核心数据库连接文件
文件路径: /data/common.inc.php
这是 DedeCMS V5.7 及之后版本(包括目前最新的 DedeCMS V7)使用的主要数据库连接配置文件。
解析
打开 /data/common.inc.php 文件,你会看到类似下面的内容:
<?php //数据库连接信息 $cfg_dbhost = 'localhost'; // 数据库服务器 $cfg_dbname = 'dedecms_v57'; // 数据库名称 $cfg_dbuser = 'root'; // 数据库用户名 $cfg_dbpwd = 'your_password'; // 数据库密码 $cfg_dbprefix = 'dede_'; // 数据库表前缀 $cfg_db_language = 'gbk'; // 数据库语言版本 ?>
各参数详解:
-
$cfg_dbhost
(图片来源网络,侵删)- 含义: 数据库主机地址。
- 默认值:
localhost - 说明: 通常情况下,如果你的数据库和网站在同一台服务器上,就使用
localhost,如果数据库在另一台服务器上,你需要填写服务器的 IP 地址或域名。
-
$cfg_dbname- 含义: 你要连接的数据库名称。
- 说明: 这是在你的 MySQL/MariaDB 服务器上创建的数据库的名称。
dedecms_v57。
-
$cfg_dbuser- 含义: 连接数据库的用户名。
- 说明: 这是用于登录
$cfg_dbname数据库的用户名,通常是你创建数据库时分配的用户,如root或你自定义的其他用户。
-
$cfg_dbpwd- 含义: 连接数据库的密码。
- 说明: 对应用户的登录密码。这个文件的安全性非常重要,因为它直接包含了你的数据库密码。
/data目录的权限通常被设置为755或750,以确保除了网站运行用户外,其他用户无法读取该目录下的文件。
-
$cfg_dbprefix- 含义: 数据库表前缀。
- 默认值:
dede_ - 说明: DedeCMS 的所有数据表都会以此前缀开头(
dede_archives,dede_arctype等),使用前缀的好处是,你可以在同一个数据库中安装多个 DedeCMS 程序而不会产生表名冲突,如果你在安装时修改了前缀,这里也需要同步修改。
-
$cfg_db_language- 含义: 数据库的字符集。
- 默认值:
gbk - 说明: 这个参数用于告诉 PHP 程序与数据库通信时使用的字符集,常见的值有
gbk和utf8。这个值必须与你的数据库实际字符集一致,否则会出现乱码问题,现在的新版本 DedeCMS 默认安装时通常会选择utf8。
如何修改数据库连接信息?
当你需要修改数据库连接信息时(例如更换服务器、修改密码等),直接编辑 /data/common.inc.php 文件即可。
操作步骤:
- 通过 FTP/SFTP 连接: 使用你的 FTP 客户端(如 FileZilla)登录到你的网站服务器。
- 定位文件: 找到并下载
/data/common.inc.php文件到你的本地电脑。 - 编辑文件: 使用任何文本编辑器(如 VS Code, Sublime Text, Notepad++ 等)打开下载的文件。
- 修改参数: 根据你的新数据库信息,修改
$cfg_dbhost,$cfg_dbname,$cfg_dbuser,$cfg_dbpwd等变量的值。 - 保存文件: 保存修改后的文件。
- 上传文件: 将修改后的
common.inc.php文件上传回服务器的/data目录,覆盖原文件。
重要注意事项
文件权限
/data 目录和 common.inc.php 文件的权限设置至关重要。
- 目录
/data: 建议权限设置为755(所有者可读写执行,组用户和其他用户可读和执行)。 - 文件
common.inc.php: 建议权限设置为644(所有者可读写,组用户和其他用户只读)。
错误的权限可能导致网站无法连接数据库,甚至带来安全风险。
文件不存在或无法读取
如果你访问网站时出现类似 “无法连接到数据库” 或 “Include/common.inc.php.php line 34” 的错误,通常是因为:
- 文件丢失:
common.inc.php文件被误删。 - 路径错误: 文件不在正确的
/data目录下。 - 权限问题: Web 服务器(如 Apache, Nginx)的运行用户没有读取该文件的权限。
- 安装不完整: DedeCMS 安装过程没有完成,导致该文件没有被正确生成。
旧版本 DedeCMS
对于非常老的 DedeCMS V5.6 版本,数据库配置文件可能位于 /include/config_base.php,但自 V5.7 版本起,官方统一将其移至 /data/common.inc.php,以提高安全性和管理便捷性,如果你在使用旧版本,请检查该旧路径。
记住这个核心要点:
- 文件名:
common.inc.php - 路径:
/data/目录下 - 作用: 存储网站连接数据库所需的所有信息(主机、用户名、密码、数据库名、表前缀等)。
- 重要性: 这是 DedeCMS 网站能够正常运行的核心配置文件之一,修改时务必小心。
