织梦数据库连接文件如何配置与使用？

核心文件位置

织梦CMS的数据库连接信息主要存储在以下两个文件中：

1. 主配置文件 (推荐修改): /data/common.inc.php

2. 旧版配置文件 (不推荐修改): /include/common.inc.php

重要提示：对于绝大多数情况，你只需要修改 /data/common.inc.php 这个文件。/include/common.inc.php 在新版中通常是主配置文件的引用,直接修改它可能会导致问题。

解析

打开 /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 = 'utf8'; //数据库语言版本
//将你数据库的信息填入上面的变量中
?>

让我们逐行解释这些变量的含义：

如何修改数据库连接信息

当你需要更换服务器、修改数据库信息或进行网站迁移时,就需要修改这个文件。

步骤 1：获取新的数据库信息

在开始之前,请确保你已经从你的虚拟主机提供商或服务器管理员处获得了以下信息：

• 数据库主机地址
• 数据库名称
• 数据库用户名
• 数据库密码
• （可选）新的数据表前缀

步骤 2：编辑 common.inc.php 文件

1. 通过FTP/SFTP连接：使用你的FTP工具（如FileZilla、Xftp等）连接到你的网站服务器。
2. 定位文件：进入网站的根目录，然后进入 data 文件夹，找到 common.inc.php 文件。
3. 下载并备份：在修改之前，务必先下载这个文件到本地进行备份,以防修改出错时可以恢复。
4. ：使用代码编辑器（如VS Code、Notepad++、Sublime Text等）打开 common.inc.php 文件。
5. 更新变量值：将文件中的 $cfg_dbhost, $cfg_dbname, $cfg_dbuser, $cfg_dbpwd 等变量的值,替换成你新的数据库信息。
6. 保存文件：保存修改后的文件。
7. 上传回服务器：将修改后的文件通过FTP上传回服务器的 /data/ 目录,覆盖原文件。

步骤 3：设置文件权限（非常重要！）

为了网站安全，common.inc.php 文件不应该对所有人可写，上传后,请确保其权限设置正确。

• Linux服务器：通常设置为 644 (所有者可读写，组和其他用户只读)。
• Windows服务器：确保 "Authenticated Users" 和 "Users" 组没有 "修改" 或 "完全控制" 权限。

如何设置权限（以FileZilla为例）： 右键点击 common.inc.php 文件 -> 文件权限 -> 勾选 Owner 的 Read 和 Write，勾选 Group 和 Others 的 Read -> 点击 "OK"。

常见问题与解决方法

问题：网站无法打开，提示 "无法连接数据库" 或 "Database Error"

• 原因：

  1. 数据库信息（用户名、密码、数据库名）填写错误。
  2. 数据库主机地址不是 localhost（例如是 0.0.1 或一个IP）。
  3. 数据库用户没有访问指定数据库的权限。
  4. 数据库服务本身未启动。
  5. common.inc.php 文件权限不正确（例如被设置为777，可能导致被篡改或读取失败）。
  6. data 目录权限不正确，导致Web服务器无法读取 common.inc.php 文件。

• 解决方法：

  1. 仔细核对所有数据库信息,确保没有拼写错误。
  2. 联系主机商确认正确的数据库主机地址。
  3. 在phpMyAdmin中检查用户权限，确保该用户有对 $cfg_dbname 数据库的 "所有权限"。
  4. 检查服务器状态，确保MySQL/MariaDB服务正在运行。
  5. 将 common.inc.php 和 data 目录的权限设置为安全的 644 和 755。

问题：网站后台能登录，但前台所有页面都空白或显示乱码

• 原因：

  1. 数据库连接信息中的 字符集 设置不正确。
  2. 数据库中的数据编码与网站编码不一致（例如数据库是gbk，网站是utf8）。

• 解决方法：

  1. 检查 $cfg_db_language 的值，确保它与你网站使用的编码一致（现代网站推荐使用 utf8）。
  2. 如果数据编码不匹配，需要使用phpMy导出数据，转换编码后再导入，这是一个比较复杂的过程，最好的办法是在安装时就统一使用UTF-8。

安全建议

1. 修改默认表前缀：在安装织梦时，就建议将数据表前缀从默认的 dede_ 修改为一个随机、复杂的字符串（如 abc_ 或 myweb_）,这可以有效防止利用已知前缀进行SQL注入攻击。
2. 保护好 data 目录：确保 data 目录的权限设置为 755，并且不要将其Web目录设置为可执行，很多虚拟主机控制面板有“保护目录”功能,可以启用。
3. 定期备份：定期备份你的网站文件和数据库,以防万一。

希望这份详细的指南能帮助你理解和操作织梦的数据库连接文件！