- 搭建本地服务器环境:让电脑能运行网站程序。
- 安装并配置数据库:网站数据存储的地方。
- 下载并安装 DedeCMS:将程序部署到环境中。
第一步:搭建本地服务器环境 (推荐集成环境)
对于新手来说,手动安装 Apache、PHP、MySQL 等组件非常繁琐且容易出错,强烈推荐使用集成环境包,一键安装所有必需的软件。
推荐集成环境:phpStudy
phpStudy 是一款非常流行且功能强大的 Windows 环境集成包,支持多种 PHP 版本和数据库,非常适合本地开发。
下载 phpStudy
- 访问 phpStudy 官网:https://www.xp.cn/
- 根据你的 Windows 系统位数(32位或64位),下载对应的版本,目前推荐下载 phpStudy 8.1 或更高版本,它对 PHP 7.x 和 8.x 都有很好的支持。
- 下载的是一个安装包(
phpstudy2025.zip),解压即可使用,无需安装。
安装与启动 phpStudy
- 将下载的压缩包解压到一个你方便管理的目录,
D:\phpstudy。 - 进入解压后的文件夹,双击运行
phpstudy.exe。 - 首次运行时,可能会提示你安装一些服务(如 Nginx/Apache, MySQL),点击“是”或“一键安装”即可,这个过程会自动完成,无需你手动操作。
- 安装完成后,phpStudy 的主界面会显示出来,默认情况下,它可能已经启动了 Apache 和 MySQL 服务,你可以通过界面上的“启动”和“停止”按钮来管理它们。
验证环境是否成功
- 打开你的浏览器,在地址栏输入
http://localhost或http://127.0.0.1。 - 如果能看到 phpStudy 的欢迎页面,说明你的本地服务器环境已经成功搭建好了!
第二步:安装并配置数据库 (MySQL)
DedeCMS 需要一个数据库来存储网站的所有数据,比如文章、栏目、会员信息等,phpStudy 已经集成了 MySQL,我们只需要进行一些简单的配置。
启动 MySQL 服务
- 确保 phpStudy 界面上的 MySQL 服务是“运行”状态,如果不是,点击“启动”按钮。
创建数据库
- 在 phpStudy 界面,找到并点击 “数据库管理” -> “phpMyAdmin”,这会在浏览器中打开 phpMyAdmin 的管理界面。
- 在 phpMyAdmin 页面,点击顶部的 “新建” 选项卡。
- 数据库名:填写一个你想要的数据库名称,
dedecms。 - 排序规则:保持默认的
utf8mb4_general_ci即可,它能很好地支持中文和 Emoji。 - 点击 “创建” 按钮。
- 数据库创建成功后,记录下数据库名称,后面安装 DedeCMS 时会用到。
(可选)创建数据库用户并授权 出于安全考虑,最好为 DedeCMS 创建一个专用的数据库用户,而不是使用 root 用户。
- 在 phpMyAdmin 主页,点击 “用户账户” 选项卡。
- 点击 “添加用户账户”。
- 登录信息:
- 用户名:填写一个用户名,
dede_user。 - 主机名:选择
localhost。 - 密码:设置一个密码。
- 用户名:填写一个用户名,
- 全局权限:保持“无”即可,我们稍后在数据库层面授权。
- 点击 “执行” 创建用户。
- 返回到 “用户账户” 页面,找到你刚刚创建的用户
dede_user,点击后面的 “编辑权限”。 - 在数据库列表中,为你之前创建的数据库
dedecms勾选,然后点击右下角的 “执行”。 - 在新的权限页面,勾选 “数据” 和 “结构” 下的 “全部” 权限,然后再次点击 “执行”。
你有了:
- 数据库名:
dedecms - 数据库用户名:
dede_user - 数据库密码:
你设置的密码
第三步:下载并安装 DedeCMS
现在服务器和数据库都准备好了,我们开始安装 DedeCMS 程序本身。
下载 DedeCMS
- 访问 DedeCMS 官方网站:https://www.dedecms.com/
- 在顶部导航栏找到 “下载” 或 “源码下载”。
- 下载最新的稳定版本(
DedeCMS-V5.7.110-UTF8-SP1.zip),对于本地开发,UTF8 编码版本是必须的。 - 下载完成后,解压这个压缩包。
上传程序文件
- 在 phpStudy 的安装目录下,有一个
WWW或www或Htdocs文件夹(不同版本名称可能略有不同),这是你的网站根目录。 - 将你刚刚解压出来的 DedeCMS 文件夹内的所有文件和文件夹(注意是内部文件,不是 dedecms 这个文件夹本身)复制或剪切到
WWW文件夹中。 - 为了方便访问,你可以将这些文件直接放在
WWW根目录下,或者创建一个子文件夹,D:\phpstudy\WWW\dedecms,这里我们以放在根目录为例。
开始安装
- 打开浏览器,在地址栏输入
http://localhost/install/。- 如果你把文件放在了
WWW的子文件夹dedecms里,那么地址就是http://localhost/dedecms/install/。
- 如果你把文件放在了
- 这时会进入 DedeCMS 的安装向导页面。
- 环境检测:向导会自动检测你的 PHP 版本、GD库、MySQL 扩展等,如果显示“√”或“通过”,说明环境兼容;如果显示“×”或“不通过”,你需要返回第一步,检查 phpStudy 中是否正确启动了服务,或者切换到兼容的 PHP 版本。
- 协议同意:勾选“同意”。
- 环境设置:设置网站的管理员目录,默认是
dede,为了安全,可以修改成一个别人不容易猜到的名字,myadmin。 - 数据库设置:填写你在第二步创建的信息。
- 数据库主机名:
localhost - 数据库名:
dedecms - 数据库用户名:
dede_user(如果你创建了专用用户) 或root(如果你直接用的 root) - 数据库密码:
你设置的密码 - 数据库前缀:保持默认的
dede_即可,可以避免和其他程序的数据冲突。
- 数据库主机名:
- 网站信息设置:
- 网站名称:给你的本地网站起个名字,我的 DedeCMS 测试站”。
- 网站首页:默认是
index.html。 - 管理员账号:默认是
admin。 - 管理员密码:设置一个你自己的密码。
- 安全提示:请务必修改默认密码!
完成安装
- 填写完所有信息后,点击“开始安装”。
- 安装程序会自动创建数据表并写入初始数据,这个过程很快,完成后会提示“安装成功”。
- 根据提示,非常重要的一步:删除或重命名
install安装文件夹,以防止他人重新安装你的网站,你可以直接在WWW目录下将install文件夹删除。 - 点击“进入网站首页”或“进入后台管理”。
第四步:验证与使用
- 访问前台网站:在浏览器输入
http://localhost,你应该能看到 DedeCMS 的默认首页。 - 访问后台管理:在浏览器输入
http://localhost/dede/(或者你之前设置的管理员目录,如http://localhost/myadmin/),然后使用你设置的管理员账号和密码登录。
登录后台后,你就可以开始创建栏目、发布文章、修改网站模板等操作了,享受 DedeCMS 带来的便捷!
常见问题与排错
-
安装时提示
目录不可写或权限不足- 原因:
WWW目录下的某些文件或文件夹(如data,uploads,templets等)当前用户没有写入权限。 - 解决:找到这些文件夹,右键 -> 属性 -> 安全 -> 编辑,添加你的当前用户(如
Administrators),并给予“完全控制”权限,或者,一个简单粗暴的方法是将这些文件夹的权限设置为“ Everyone ”完全控制(仅限本地开发环境,生产环境切勿如此)。
- 原因:
-
安装时提示
数据库连接失败- 原因:数据库名、用户名、密码填写错误,或者 MySQL 服务未启动。
- 解决:仔细核对第二步中创建的信息,并确保 phpStudy 中的 MySQL 服务是“运行”状态。
-
浏览器打开
localhost显示 404 或无法访问- 原因:Apache 或 Nginx 服务未启动。
- 解决:检查 phpStudy 界面,确保 Apache 和 MySQL 的状态都是“运行”,如果不是,点击“启动”。
-
后台登录后空白或出现乱码
- 原因:通常是 PHP 版本与 DedeCMS 不兼容,或者数据库字符集设置有问题。
- 解决:DedeCMS V5.7 对 PHP 7.4 及以下版本支持较好,如果使用 PHP 8.0+,可能会遇到兼容性问题,可以在 phpStudy 中切换到较低的 PHP 版本(如 PHP 7.4)再试,确保数据库和数据表都是
utf8mb4编码。
至此,你的 DedeCMS 本地开发环境就完全搭建好了!可以开始愉快地进行二次开发和内容管理了。
