这部分信息主要出现在安装程序的第三步“数据库配置”或修改 /data/common.inc.php 文件时。

(图片来源网络,侵删)
核心参数详解
你需要了解这几个参数是什么意思,以及它们通常从哪里获取。
| 参数名 | 中文名 | 说明 | 常见值/填写示例 |
|---|---|---|---|
$cfg_dbhost |
数据库主机地址 | 运行数据库服务器的计算机地址,对于99%的虚拟主机或云服务器,这通常是 localhost。 |
localhost |
$cfg_dbuser |
数据库用户名 | 你用来连接和操作数据库的账户名,由你的主机服务商提供,或者在本地环境中自行创建。 | dede_admin 或 root (本地) |
$cfg_dbpwd |
数据库密码 | 对应用户名的登录密码,同样由服务商提供或自行设置。 | your_password_123 |
$cfg_dbname |
数据库名称 | 你为这个织梦网站创建的一个专门的数据库。 | my_website_db |
$cfg_dbprefix |
数据库表前缀 | 为了防止多个网站共用一个数据库时表名冲突,给所有表名加一个统一的前缀。 | dede_ (默认) 或 wp_ (如果你用WordPress) |
$cfg_db_language |
数据库连接字符集 | 定义PHP与数据库通信时使用的字符集。强烈建议使用 utf8 或 utf8mb4(推荐,支持emoji)。 |
utf8mb4 |
如何获取这些信息?
这些信息主要来源于你的虚拟主机控制面板或云服务器控制台。
-
数据库主机地址:
- 绝大多数情况下是
localhost,如果你的主机商特别说明,才填写IP地址或域名(如mysql.example.com)。
- 绝大多数情况下是
-
数据库名、用户名、密码:
(图片来源网络,侵删)- 登录你的主机控制面板(如 cPanel、Plesk、宝塔面板等)。
- 找到“数据库管理”或“MySQL数据库”等类似选项。
- 你需要创建一个新的数据库,并创建一个新的数据库用户,然后将这个用户授权(添加权限)到你刚创建的数据库上。
- 注意: 很多主机商在创建用户时会自动将用户名加上你的主机名前缀,
username_dbuser,请务必使用完整的用户名。 - 创建完成后,记录下数据库名、用户名和密码。
填写场景与示例
全新安装织梦CMS
这是最常见的情况,你按照安装向导一步步操作。
- 进入安装向导第三步,你会看到数据库配置表单。
- 填写信息:
- 数据库服务器: 填写
localhost。 - 数据库用户名: 填写你在主机面板创建的数据库用户名(
yourhost_dede_user)。 - 数据库密码: 填写你为该用户设置的密码。
- 数据库名: 填写你在主机面板创建的数据库名(
yourhost_website_db)。 - 数据库前缀: 保持默认的
dede_即可,如果你打算在同一数据库里安装多个织梦程序,可以修改为不同的前缀,如dede_v1_,dede_v2_。 - 数据库连接字符集: 选择
utf8mb4,这是目前最推荐、兼容性最好的设置。
- 数据库服务器: 填写
- 点击“继续”或“下一步”,如果信息正确,安装程序会开始创建数据表并导入初始数据。
修改已有站点的数据库配置
当你需要更换服务器、或者修改了数据库信息时,需要手动修改配置文件。
-
找到配置文件:
- 使用FTP或文件管理器,登录你的网站服务器。
- 进入网站根目录(通常是
public_html或www)。 - 找到
/data目录,里面的common.inc.php文件就是核心配置文件。
-
编辑配置文件:
- 下载
common.inc.php文件到本地电脑。 - 用代码编辑器(如 VS Code, Sublime Text, Notepad++)打开它。
- 找到类似下面这段代码,并修改对应的值:
//数据库连接信息 $cfg_dbhost = 'localhost'; // 数据库服务器 $cfg_dbname = 'my_website_db'; // 数据库名 $cfg_dbuser = 'dede_admin'; // 数据库用户名 $cfg_dbpwd = 'your_password_123'; // 数据库密码 $cfg_dbprefix = 'dede_'; // 数据库表前缀 $cfg_db_language = 'utf8mb4'; // 数据库连接字符集
- 下载
-
保存并上传:
- 修改完毕后,保存文件。
- 将修改后的
common.inc.php文件重新上传到服务器,覆盖原文件。注意:上传时请保持文件名不变,并确保权限设置正确(通常是644)。
常见问题与解决方法
问题1:$cfg_dbhost 不确定是什么?
- 解决方案:首选
localhost,如果连接失败,请联系你的主机服务商,他们会告诉你正确的地址。不要随意填写IP地址,除非服务商明确告知。
问题2:提示“数据库用户名或密码错误”
- 解决方案:
- 仔细检查用户名和密码是否输入正确,注意大小写和特殊字符。
- 确认你是否在主机面板中成功创建了用户,并且该用户已经被授权访问指定的数据库。
- 如果密码包含特殊字符(如 , , ),在某些情况下可能会导致问题,可以尝试修改一个纯字母数字的密码测试。
问题3:提示“无法连接到数据库,请确认数据库服务器信息是否正确”
- 解决方案:
- 检查
$cfg_dbhost是否正确。 - 检查数据库服务是否正在运行(对于自己搭建的服务器)。
- 检查服务器的防火墙是否阻止了3306端口(MySQL默认端口)。
- 联系主机商,确认数据库服务器是否正常。
- 检查
问题4:安装后网站出现乱码
- 解决方案:
- 检查
$cfg_db_language是否设置为utf8mb4。 - 确认你在安装时选择的是“UTF-8编码”。
- 如果已经安装并出现乱码,可以尝试登录织梦后台的“系统” -> “SQL命令运行工具”,执行
ALTER TABLE你的表名DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;来修复表字符集(需要逐个表执行,或编写脚本)。
- 检查
问题5:$cfg_dbprefix 为什么要改?
- 应用场景:
- 安全: 防止黑客利用已知的默认前缀(如
dede_)进行SQL注入攻击。 - 共存: 如果你想在一个数据库里安装多个织梦程序,必须使用不同的前缀来区分各自的表,否则会相互覆盖数据,第一个用
site1_,第二个用site2_。
- 安全: 防止黑客利用已知的默认前缀(如
希望这份详细的指南能帮助你顺利完成织梦CMS的数据库配置!
