“没有 common.inc.php” 这个说法,其实有两种可能的情况,我们需要分别对待:

(图片来源网络,侵删)
文件确实不存在(最常见)
这种情况通常发生在以下场景:
- 文件上传错误:您通过FTP或面板上传文件时,可能因为路径错误或遗漏,导致
common.inc.php文件没有被正确上传到服务器的指定目录。 - 文件被误删:在网站维护或迁移过程中,不小心删除了这个关键文件。
- 下载的安装包不完整:您下载的织梦程序包本身可能就是损坏或不完整的。
common.inc.php 文件的作用
这个文件是织梦CMS的核心配置文件,它定义了网站运行所需的基本信息,
- 数据库连接信息(主机名、用户名、密码、数据库名)
- 网站安装根目录 (
$cfg_basedir) - 网站名称、管理员邮箱等全局配置
没有这个文件,织梦程序根本无法启动和连接数据库,所以您会看到各种错误,无法连接数据库”、“页面空白”等。
如何解决(修复方法)
解决方法的核心是:手动创建或上传一个正确的 common.inc.php 文件。

(图片来源网络,侵删)
步骤 1:找到正确的配置信息
您需要获取您的数据库信息,这些信息通常可以在您的主机控制面板(如cPanel、宝塔面板等)或之前成功安装织梦时记录的笔记中找到。
您需要准备以下信息:
- 数据库主机名:通常是
localhost,但也可能是0.0.1或一个域名。 - 数据库用户名:您数据库的用户名。
- 数据库密码:您数据库的密码。
- 数据库名:您创建的用于织梦的数据库名。
- 网站根目录路径:您的网站文件在服务器上的绝对路径,在Linux服务器上可能是
/www/wwwroot/您的域名,在Windows上可能是D:\web\您的域名。
步骤 2:创建或修改 common.inc.php 文件

(图片来源网络,侵删)
-
通过FTP/文件管理器连接您的服务器。
-
定位到文件位置:
common.inc.php文件位于织梦程序的根目录下,也就是和index.php、install文件夹在同一个层级。/您的网站根目录/ ├── common.inc.php <-- 这个文件 ├── dede/ ├── include/ ├── index.php └── install/ -
创建文件:如果文件不存在,就在根目录下新建一个名为
common.inc.php的文件。 -
:用文本编辑器(如Notepad++, VS Code)打开这个文件,填入以下代码,并将
[ ]中的内容替换为您在步骤1中获取的实际信息。<?php //数据库连接信息 $cfg_dbhost = 'localhost'; //数据库主机 $cfg_dbname = '您的数据库名'; //数据库名 $cfg_dbuser = '您的数据库用户名'; //数据库用户名 $cfg_dbpwd = '您的数据库密码'; //数据库密码 $cfg_dbprefix = 'dede_'; //数据表前缀,通常不需要修改 $cfg_db_language = 'gbk'; //数据库语言版本,gbk或utf-8,请与您的数据编码一致 //网站根目录 // !!! 重要:请务必确保这里的路径是您网站在服务器上的绝对路径 !!! // Linux服务器可能是 /home/wwwroot/您的域名 // Windows服务器可能是 D:\web\您的域名 $cfg_basedir = '/www/wwwroot/您的域名'; // 不需要修改以下内容 $cfg_plus_dir = '/plus'; $cfg_user_dir = '/member'; ?>
-
保存文件:将文件保存并上传到服务器的根目录,覆盖掉原来的(如果存在)或新建的文件。
步骤 3:设置文件权限
为了安全,建议将 common.inc.php 的权限设置为 644(即所有者可读写,组和其他用户只读),您可以通过FTP软件或服务器面板的文件管理器来修改权限。
完成以上步骤后,重新访问您的网站,问题应该就解决了。
文件存在,但内容错误或路径错误
文件是存在的,但里面的信息是错的。
- 数据库信息错误:检查
$cfg_dbhost,$cfg_dbname,$cfg_dbuser,$cfg_dbpwd是否与您当前数据库的信息完全一致,特别注意大小写和空格。 - 网站根目录路径 (
$cfg_basedir) 错误:这是最常见的错误原因,路径必须是绝对路径,而不是相对路径(如 或 )。- 如何获取绝对路径?
- 方法一(推荐):在您的网站根目录下,创建一个名为
info.php的文件,内容为<?php phpinfo(); ?>,然后在浏览器中访问这个文件(http://您的域名/info.php),在页面中搜索DOCUMENT_ROOT,它的值就是您的绝对路径。 - 方法二:联系您的主机商客服,他们会告诉您您网站的绝对路径。
- 方法一(推荐):在您的网站根目录下,创建一个名为
- 如何获取绝对路径?
- 数据表前缀错误:如果您在安装时修改了默认的前缀(从
dede_改成了别的),$cfg_dbprefix的值也需要相应修改。
| 问题现象 | 可能原因 | 解决方案 |
|---|---|---|
| 整个网站无法访问,报错 | common.inc.php 文件不存在或内容错误。 |
检查文件是否存在。 如果不存在,请按照“情况一”的步骤手动创建并填写正确的配置信息。 如果存在,请检查文件内的数据库连接信息和网站根目录路径是否正确。 |
希望这个详细的解答能帮助您解决问题!如果还有疑问,可以随时追问。
