织梦CMS数据库配置文件在哪？

主要配置文件：data/common.inc.php

这是最重要、最核心的数据库配置文件，织梦CMS在启动时,会首先加载这个文件来获取数据库连接所需的所有信息。

文件路径： 你的网站根目录/data/common.inc.php

如何修改：

1. 使用FTP/SFTP工具登录到你的网站服务器。
2. 找到并下载 data 目录下的 common.inc.php 文件到本地电脑。
3. 用代码编辑器（如 VS Code, Sublime Text, Notepad++ 等）打开这个文件。
4. 找到以下代码段,并根据你的数据库信息进行修改：

<?php
//数据库连接信息
$cfg_dbhost = 'localhost'; // 数据库服务器
$cfg_dbname = 'your_database_name'; // 数据库名称
$cfg_dbuser = 'your_database_user'; // 数据库用户名
$cfg_dbpwd = 'your_database_password'; // 数据库密码
$cfg_dbprefix = 'dede_'; // 数据库表前缀，建议不要修改
$cfg_db_language = 'gbk'; // 数据库语言版本，gbk 或 utf8
$cfg_db_port = '3306'; // 数据库端口，默认为3306，如果不是默认端口则需要修改
// ... 文件中还有其他配置，但以上是数据库相关的核心配置 ...
?>

参数详解：

• $cfg_dbhost: 数据库主机地址。
  • 如果数据库和网站在同一个服务器上，通常是 localhost。
  • 如果是独立数据库服务器,这里应该是服务器的IP地址或域名。
• $cfg_dbname: 数据库名称,你在创建数据库时为它起的名字。
• $cfg_dbuser: 数据库用户名,用于连接和操作该数据库的用户名。
• $cfg_dbpwd: 数据库密码，对应 $cfg_dbuser 用户的密码。
• $cfg_dbprefix: 数据库表前缀。
  • 这是所有织梦数据表的统一前缀，dede_archives (文章表), dede_arctype (栏目表)。
  • 强烈建议不要修改，如果修改了，需要确保你所有的数据表都使用了新的前缀，否则网站将无法正常工作,这个值在安装织梦时确定。
• $cfg_db_language: 数据库字符集。
  • utf8: 强烈推荐使用，支持全球所有语言，包括中文、英文、日文等,可以避免很多乱码问题。
  • gbk: 支持中文（GBK/GB2312编码）,但无法很好地支持其他语言。
• $cfg_db_port: 数据库端口号。
  • 默认MySQL的端口号是 3306，如果你的数据库服务器使用了非标准的端口,就需要在这里填写正确的端口号。

修改完成后，保存文件，并通过FTP/SFTP工具重新上传回服务器的 data 目录，覆盖原文件即可。

安装配置文件：install/index.php (首次安装时使用)

这个文件只在首次安装织梦CMS时使用，在安装过程中，系统会引导你填写数据库信息，这些信息最终会被写入到 data/common.inc.php 文件中。

文件路径： 你的网站根目录/install/index.php

用途：

• 新网站部署。
• 网站迁移后,在全新环境上重新部署。

一旦安装完成，这个文件就失去了作用，为了安全起见，安装成功后应该删除 install 整个目录。

数据库配置文件丢失或损坏怎么办？

这是一个常见问题，通常发生在网站迁移或服务器更换后。data/common.inc.php 文件丢失、权限错误或内容被修改错误，网站将无法访问，并可能报错“无法连接数据库”。

解决方案：

1. 重新创建 common.inc.php 文件：

   • 在你的网站根目录下，找到 dede 目录（后台管理目录）。
   • 进入 dede 目录，找到名为 config_update_env.php 的文件。
   • 在浏览器中访问这个文件，http://你的域名/dede/config_update_env.php
   • 系统会检测你的环境，并让你填写数据库信息，填写正确信息后，它会自动为你生成或修复 data/common.inc.php 文件。

2. 手动创建文件：

   • 如果上述方法无效，你可以手动创建一个 common.inc.php 文件。
   • 将下面这段代码复制进去,并填入你正确的数据库信息。

<?php
//数据库连接信息
$cfg_dbhost = 'localhost';
$cfg_dbname = 'your_database_name';
$cfg_dbuser = 'your_database_user';
$cfg_dbpwd = 'your_database_password';
$cfg_dbprefix = 'dede_';
$cfg_db_language = 'utf8';
$cfg_db_port = '3306';
//开启缓存功能
$cfg_cachetime = '3600';
//静态文件目录
$cfg_cmspath = '/';
//网站路径
$cfg_mainsite = 'http://你的域名';
//系统调试模式
$cfg_debug = 'N';
//magic_quotes_gpc
$cfg_mgcid = 'Y';
//session自动开启
$cfg_autoopen = 'N';
//session保存路径
$cfg_sessionpath = '';
//session cookie生命周期
$cfg_cookie_life = '0';
//session cookie路径
$cfg_cookie_path = '/';
//session cookie域名
$cfg_cookie_domain = '';
//session cookie前缀
$cfg_cookie_prefix = 'DEDE';
//session cookie安全
$cfg_cookie_secure = '';
//session cookie httponly
$cfg_cookie_httponly = '';
//session cookie samesite
$cfg_cookie_samesite = '';
//session.gc_maxlifetime
$cfg_gc_maxlifetime = '1440';
//session.save_handler
$cfg_save_handler = 'files';
//session.save_path
$cfg_save_path = '';
//session.use_strict_mode
$cfg_use_strict_mode = '1';
//session.use_cookies
$cfg_use_cookies = '1';
//session.use_only_cookies
$cfg_use_only_cookies = '1';
//session.use_trans_sid
$cfg_use_trans_sid = '0';
//session.cookie_lifetime
$cfg_cookie_lifetime = '0';
//session.cookie_path
$cfg_cookie_path = '/';
//session.cookie_domain
$cfg_cookie_domain = '';
//session.cookie_secure
$cfg_cookie_secure = '';
//session.cookie_httponly
$cfg_cookie_httponly = '';
//session.cookie_samesite
$cfg_cookie_samesite = '';
//session.cache_limiter
$cfg_cache_limiter = 'nocache';
//session.cache_expire
$cfg_cache_expire = '180';
//session.sid_length
$cfg_sid_length = '26';
//session.sid_bits_per_character
$cfg_sid_bits_per_character = '6';
//session.hash_function
$cfg_hash_function = '0';
//session.hash_bits_per_character
$cfg_hash_bits_per_character = '5';
//session.entropy_file
$cfg_entropy_file = '';
//session.entropy_length
$cfg_entropy_length = '0';
//session.gc_divisor
$cfg_gc_divisor = '1000';
//session.gc_probability
$cfg_gc_probability = '1';
//session.referer_check
$cfg_referer_check = '';
//session.entropy_length
$cfg_entropy_length = '0';
//session.cache_limiter
$cfg_cache_limiter = 'nocache';
//session.cache_expire
$cfg_cache_expire = '180';
//session.use_strict_mode
$cfg_use_strict_mode = '1';
//session.use_cookies
$cfg_use_cookies = '1';
//session.use_only_cookies
$cfg_use_only_cookies = '1';
//session.use_trans_sid
$cfg_use_trans_sid = '0';
//session.cookie_lifetime
$cfg_cookie_lifetime = '0';
//session.cookie_path
$cfg_cookie_path = '/';
//session.cookie_domain
$cfg_cookie_domain = '';
//session.cookie_secure
$cfg_cookie_secure = '';
//session.cookie_httponly
$cfg_cookie_httponly = '';
//session.cookie_samesite
$cfg_cookie_samesite = '';
//session.sid_length
$cfg_sid_length = '26';
//session.sid_bits_per_character
$cfg_sid_bits_per_character = '6';
//session.hash_function
$cfg_hash_function = '0';
//session.hash_bits_per_character
$cfg_hash_bits_per_character = '5';
//session.entropy_file
$cfg_entropy_file = '';
//session.entropy_length
$cfg_entropy_length = '0';
//session.gc_divisor
$cfg_gc_divisor = '1000';
//session.gc_probability
$cfg_gc_probability = '1';
//session.referer_check
$cfg_referer_check = '';
//session.entropy_length
$cfg_entropy_length = '0';
?>

注意： 手动创建时，确保文件编码为 UTF-8 无BOM格式,否则可能导致网站出现乱码或无法连接数据库。

data/common.inc.php 是你日常维护织梦CMS时需要打交道的关键文件。