第一部分:准备工作
在开始安装之前,请确保你的电脑上已经安装了必要的软件。
安装集成开发环境
对于本地开发,最简单的方法是使用集成环境包,它会自动安装并配置好 Apache/Nginx (Web服务器)、PHP (脚本语言) 和 MySQL (数据库)。
- 推荐软件:phpStudy
- 下载地址:phpStudy 官方下载页面
- 版本选择:根据你的系统选择 32 位或 64 位版本,对于新手,推荐使用
phpStudy 8.1版本,它集成了 PHP 7.4 和 MySQL 5.7/8.0,兼容性较好。
下载 Dedecms 安装包
- 官方网站:DedeCMS 官方网站
- 下载步骤:
- 访问官网,点击“下载”。
- 选择你需要的版本(
DedeCMS V5.7 SP2 UTF8版本)。 - 下载后你会得到一个
.zip或.rar格式的压缩包。
第二部分:安装步骤
步骤 1:安装并启动 phpStudy
- 运行你下载的
phpStudy安装程序,按照提示完成安装。 - 安装完成后,启动 phpStudy。
- 在 phpStudy 的主界面,确保 Apache 或 Nginx 和 MySQL 服务都已经启动(状态显示为“运行中”),如果未启动,点击“启动”按钮。
步骤 2:解压 Dedecms 安装包
- 将下载的 Dedecms 压缩包(
dedecms5.7-sp1UTF8-release20080618.zip)解压到一个你容易找到的文件夹。 - 解压后,你会看到一个名为
dede的文件夹。这个文件夹就是你的网站根目录。
步骤 3:将网站文件放入 Web 服务器目录
这是最关键的一步,你需要将 Dedecms 的网站文件放到 phpStudy 指定的网站根目录下。
- 在 phpStudy 主界面,找到右上角的 “网站” 菜单,点击 “管理网站”。
- 在弹出的窗口中,点击 “添加站点”。
- 站点信息配置:
- 域名:可以填写
localhost或0.0.1,本地访问用localhost即可。 - 端口:保持默认的
80。 - 根目录:这是最重要的部分! 点击“选择目录”,然后浏览到你刚刚解压 Dedecms 文件夹时所在的路径,并选中那个
dede文件夹。- 如果你的 Dedecms 文件解压在
D:\downloads\dedecms,那么你的根目录就应该选择D:\downloads\dedecms\dede。
- 如果你的 Dedecms 文件解压在
- 域名:可以填写
- 点击“确定”保存设置。
步骤 4:创建数据库
DedeCMS 需要一个数据库来存储网站内容(如文章、用户信息等)。
- 在 phpStudy 主界面,点击 “MySQL管理” -> “MySQL-Front” 或 “phpMyAdmin”,这会自动在浏览器中打开 phpMyAdmin。
- 在 phpMyAdmin 的首页,点击顶部的 “新建” 选项卡。
- 创建数据库:
- 数据库名:为你网站的数据起一个名字,
dedecms_db。 - 排序规则:强烈建议选择
utf8mb4_general_ci,这样可以完美支持中文字符和 Emoji 表情。
- 数据库名:为你网站的数据起一个名字,
- 点击 “创建” 按钮,数据库就创建好了。
步骤 5:运行安装向导
所有准备工作都已完成,可以开始正式安装了。
- 打开你的浏览器(如 Chrome、Edge)。
- 在地址栏输入你刚才在 phpStudy 中设置的域名,即:
http://localhost - 如果一切顺利,你将看到 Dedecms 的欢迎页面和安装协议,阅读协议后,点击“同意”。
- 接下来是 “环境检测” 页面,系统会自动检测你的 PHP、MySQL 等环境是否符合要求,如果看到红色的“不通过”,请返回检查 phpStudy 的配置是否正确,或者 PHP 版本是否过低(DedeCMS 5.7 对 PHP 8.x 的支持有限,推荐使用 PHP 7.4),绿色的“通过”则表示正常。
- 点击“下一步”,进入 “数据库配置” 页面。
- 数据库服务器:默认为
localhost,无需修改。 - 数据库用户名:默认为
root。 - 数据库密码:这是你在安装 phpStudy 时设置的 MySQL 密码,如果你没有设置过,很多版本默认为空(直接留空)。
- 数据库名:选择你刚刚创建的数据库名,
dedecms_db。 - 前缀:数据表的前缀,默认为
dede_,为了安全,可以修改成其他复杂的名字,abc_。
- 数据库服务器:默认为
- 点击“下一步”,进入 “网站设置” 页面。
- 站点名称:填写你的网站名称。
- 站点默认主页:默认为
index.php,无需修改。 - 管理员账号:这是你登录网站后台的账号,
admin。 - 管理员密码:设置一个强密码。
- 安全设置:会要求你输入两次密码进行确认。
- 点击“下一步”,安装程序会开始执行 SQL 脚本,创建数据表并写入初始数据,这个过程很快。
- 安装完成后,页面会提示安装成功,它会要求你删除
/data/install_lock.txt文件以确保安全。
第三部分:安装后配置与访问
步骤 6:删除安装锁文件并完成安装
- 返回你的 Dedecms 网站根目录(即
D:\downloads\dedecms\dede)。 - 找到并删除
data文件夹下的install_lock.txt文件。这一步是必须的,否则无法访问网站前台。 - 为了安全,最好也删除
/install/整个文件夹。
步骤 7:访问你的网站
-
访问网站前台: 在浏览器地址栏输入
http://localhost,你将看到 Dedecms 默认的首页。 -
访问网站后台: 在浏览器地址栏输入
http://localhost/dede,然后输入你刚才设置的管理员账号和密码,即可登录网站后台,开始管理你的网站。
常见问题与解决方案
-
问题 1:访问
http://localhost时提示 404 Not Found 或找不到页面。- 原因:网站根目录配置错误。
- 解决:回到 phpStudy 的“管理网站”设置,检查“根目录”是否正确指向了解压后的
dede文件夹。
-
问题 2:安装时数据库连接失败,提示
Access denied for user 'root'@'localhost'。- 原因:MySQL 密码错误。
- 解决:确认你在 phpStudy 中设置的 MySQL 密码,如果忘记密码,可以在 phpStudy 的“工具” -> “重置 MySQL 密码”中重置。
-
问题 3:安装时提示
function mb_ ... is not found等错误。- 原因:PHP 环境缺少
mbstring(多字节字符串) 等扩展。 - 解决:在 phpStudy 主界面,点击“切换版本”或“设置” -> “扩展组件管理”,确保
mbstring,mysqli,gd等常用扩展是开启的状态,然后重启 Apache 服务。
- 原因:PHP 环境缺少
-
问题 4:前台或后台页面乱码。
- 原因:数据库编码或文件编码不一致。
- 解决:确保在创建数据库时选择了
utf8mb4_general_ci,如果仍有问题,可以检查网站配置文件/include/config_base.php中的数据库编码设置。
恭喜你!至此,你已经成功在本地安装并运行了 Dedecms,接下来你就可以在后台添加栏目、发布文章,开始搭建你的网站了。
