摘要

  • 目标：在本地电脑上成功搭建一个 Dedecms 网站,用于学习和测试。
  • 核心软件：
    1. PHPStudy：一个集成了 Apache/Nginx、PHP、MySQL 的本地服务器环境软件。
    2. Dedecms V5.7管理系统的源程序。
  • 操作系统：Windows (10/11)

第一步：准备工作

在开始之前,请确保你已经下载好了以下两个软件：

  1. PHPStudy

    • 下载地址：https://www.xp.cn/download.html
    • 版本选择：下载最新版即可，对于新手，推荐选择带有界面的版本，PHPStudy for Windows。
    • 注意：如果你的电脑是 64 位系统，请务必下载 64 位版本的 PHPStudy。

  2. Dedecms V5.7

    • 下载地址：https://www.dedecms.com/products/dedecms/
    • 版本选择：下载 DedeCMS V5.7 GBK/UTF8 版本。GBK 是中文编码，UTF8 是国际编码，两者在功能上无差别，主要是数据库和文件编码不同。如果你不确定，建议选择 GBK 版本，因为国内很多模板和插件是基于 GBK 开发的。

第二步：安装并启动 PHPStudy

  1. 安装 PHPStudy

    • 双击你下载的 PHPStudy 安装包（phpstudy_pro.zip 或 phpstudy_install.exe）。
    • 如果是 .zip 文件，直接解压到你想要安装的目录（如 D:\phpstudy_pro）。
    • 如果是 .exe 文件，按照提示“下一步”即可完成安装。

  2. 启动 PHPStudy

    • 打开 PHPStudy 的主界面。
    • 在顶部菜单栏，确保你选择了 Apache 或 Nginx（两者都可以，新手推荐 Apache）。
    • 点击 启动 按钮，如果启动成功，状态会变为“运行中”。

第三步：配置 PHPStudy

为了确保 Dedecms 能够顺利安装，我们需要对 PHPStudy 的 PHP 版本进行一些简单设置。

  1. 进入设置：在 PHPStudy 界面，点击右上角的 设置 -> 打开配置文件 -> php.ini。

  2. 修改关键配置：在打开的 php.ini 文件中，使用 Ctrl + F 搜索以下几项，并确保它们的值没有被注释（前面没有分号 ）且足够大。

    • upload_max_filesize：上传文件的最大大小，建议设置为 32M 或更大。
    • post_max_size：POST 数据的最大大小，通常设置为与 upload_max_filesize 相同或更大。
    • max_execution_time：脚本最大执行时间，建议设置为 300（秒）。
    • max_input_time：脚本接收输入数据的时间限制，建议设置为 300（秒）。

    修改示例：

    ; 原始值可能是 8M
upload_max_filesize = 32M
; 原始值可能是 8M
post_max_size = 32M
; 原始值可能是 30 或 60
max_execution_time = 300
; 原始值可能是 30 或 60
max_input_time = 300

  3. 保存并重启：保存 php.ini 文件，然后回到 PHPStudy 主界面，点击 重启 按钮,让配置生效。

第四步：创建数据库

Dedecms 需要一个数据库来存储网站的所有数据（文章、栏目、用户等）。

  1. 打开 MySQL 管理工具：在 PHPStudy 界面，点击 数据库 -> MySQL 管理器 -> phpMyAdmin，这会在你的浏览器中打开 phpMyAdmin。

  2. 创建新数据库：

    • 在 phpMyAdmin 的主界面，找到“创建数据库”区域。
    • 数据库名：输入一个你喜欢的名字，dedecms。
    • 排序规则：非常重要！ 这里必须选择与你的 Dedecms 版本编码一致。
      • 如果你下载的是 GBK 版本，请选择 gbk_chinese_ci。
      • 如果你下载的是 UTF8 版本，请选择 utf8_general_ci。
    • 点击 创建 按钮。

第五步：上传并解压 Dedecms

  1. 解压 Dedecms：将你下载的 Dedecms 压缩包（dedecms5.7-gbk-full.zip）解压到一个文件夹里。

  2. 找到核心文件：进入解压后的文件夹，你会看到一个名为 dede 的文件夹，这就是后台管理目录，还有一个 data 文件夹，里面有一个 admin 文件夹,需要修改其权限。

  3. 修改目录权限（关键步骤）：

    • 进入 dedecms 文件夹下的 data 目录。
    • 找到 admin 文件夹，将其重命名为 ok，这一步是为了防止安装时出现权限错误，安装成功后，你可以把它改回 admin,或者直接删除。

  4. 上传文件到服务器：

    • 回到 PHPStudy 的根目录（D:\phpstudy_pro\WWW）,这个目录是本地网站的根目录。

    • 将 第二步解压出来的 dedecms 文件夹内的所有文件和文件夹（注意是文件夹内的内容，不要把 dedecms 这个文件夹本身复制进去）复制或剪切到 WWW 目录中。

    • 完成后的目录结构应该是： D:\phpstudy_pro\WWW\ ├── index.html ├── dede/ (后台目录) ├── include/ (核心类库) ├── templets/ (模板文件) └── ... (其他文件)

第六步：运行安装程序

所有准备工作都已完成,可以开始安装了。

  1. 访问安装页面：打开你的浏览器,在地址栏输入：

    http://localhost/install/index.php

    PHPStudy 和文件上传都正确，你应该能看到 Dedecms 的安装向导界面。

  2. 环境检测：

    • 安装程序会自动检测你的服务器环境（PHP 版本、数据库连接等）。
    • 如果前面步骤都正确，所有项目都会显示“通过”。
    • 如果有“不通过”的项目，根据提示回到前面的步骤检查（通常是 PHP 配置或文件权限问题）。

  3. 开始安装：点击“开始安装”。

  4. 设置网站信息：

    • 网站名称：给你的网站起个名字，我的本地 Dedecms”。
    • 网站首页：通常保持默认 index.html。
    • 管理员账号：设置你的后台登录用户名，默认是 admin,建议修改。
    • 管理员密码：设置一个复杂的密码,并牢记。
    • 安全设置：输入后台管理目录的密码，这个密码在登录后台时需要输入，比管理员密码更重要,请务必设置。
    • 网站默认编码：选择与你的 Dedecms 版本一致的编码（GBK 或 UTF8）。
    • 数据库信息：
      • 数据库服务器：默认 localhost。
      • 数据库用户名：默认 root。
      • 数据库密码：默认 root。（如果你在安装 PHPStudy 时修改过密码，请填写你修改后的密码）
      • 数据库名：填写你 第四步 创建的数据库名，dedecms。
      • 数据库表前缀：保持默认 dede_ 即可。

  5. 完成安装：点击“开始安装”，等待程序执行，安装成功后，会提示你删除 install 目录。

第七步：完成安装与访问

  1. 删除安装目录：根据提示，进入 WWW 目录，删除 install 文件夹,这是为了安全。

  2. 访问网站：

    • 前台网站：在浏览器输入 http://localhost，你应该能看到 Dedecms 默认的首页。
    • 后台管理：在浏览器输入 http://localhost/dede（或你修改后的后台目录），然后输入你设置的管理员账号和密码,即可登录后台进行内容管理。

常见问题与解决方法

  • 问题1：安装时提示 data/admin 目录不可写。

    • 解决：请回到 第五步，确保你已经将 data/admin 文件夹重命名为了 ok。

  • 问题2：安装时数据库连接失败。

    • 解决：
      1. 检查数据库名、用户名、密码是否正确（特别是密码，很多人会忘记自己改过）。
      2. 确保你已经启动了 PHPStudy。
      3. 尝试在 phpMyAdmin 中是否能正常登录。

  • 问题3：浏览器访问 localhost 显示 404 错误。

    • 解决：
      1. 检查 PHPStudy 是否已启动并运行。
      2. 检查文件是否上传到了正确的目录（WWW 目录）。
      3. 确保你使用的是 Apache 或 Nginx,并且端口没有冲突。

  • 问题4：页面乱码。

    • 解决：这通常是编码不匹配导致的，请检查：
      1. 你下载的 Dedecms 是 GBK 还是 UTF8 版本？
      2. 在创建数据库时，选择的排序规则是否与 Dedecms 版本一致？
      3. 网站后台的“系统” -> “系统基本参数” -> “核心设置”中的“网站默认编码”是否正确？

恭喜你！至此，你已经成功在本地搭建好了 Dedecms 环境,现在你可以尽情地探索和学习如何使用这个强大的内容管理系统了。