前言

织梦 dedeCMS 是国内广泛使用的开源内容管理系统， 因其功能强大、易 深受站长喜爱。对于开发者和建站新手而言， 在本地搭建测试环境是非常重要的一步，既能保证调试效率，也能避免线上环境出现意外问题。本文将详细介绍如何搭建织梦dedeCMS本地测试安装环境 并重点讲解如何设置dedeCMS的安装环境钩子，以便实现更灵活的功能 。

一、 准备工作

1. 硬件与软件要求

• 操作系统：Windows 10/11 或 Linux
• PHP版本：建议PHP7.4及以上，兼容dedeCMS最新版本
• Web服务器：Apache 或 Nginx
• 数据库：MySQL 5.7及以上或MariaDB兼容版本
• DedeCMS程序包：官方下载最新版DedeCMS安装包
• 本地集成环境：, XAMPP 或 DedeAMPZ等均可，本教程推荐使用phpStudy方便快捷。

2. 下载资源准备

3. DedeAMPZ整合包：适合初学者， 但不建议长期使用，主要原因是不够灵活且更新慢。

二、 本地测试环境搭建详解步骤

1. 安装phpStudy集成环境

phpStudy是一款国内用户常用的集成PHP+Apache+MySQL的软件包，适合快速搭建本地测试服务器。以下为安装步骤：

1. 下载安装文件：访问官网下载安装包。
2. 施行安装程序：双击运行安装文件，按照提示选择安装目录。建议不要安装在C盘避免权限问题。
3. 启动服务面板：完成后打开phpStudy控制面板，启动Apache和MySQL服务。
4. 配置PHP版本： 根据需要切换PHP版本， 确保与dedeCMS兼容，一般选择PHP7.4或更高版本。

2. 创建数据库与用户权限设置

dedeCMS依赖数据库存储网站数据，需要提前创建一个空数据库供程序使用。步骤如下：

1. A. 打开 phpMyAdmin 管理界面：通常访问 http://localhost/phpmyadmin ， 默认用户名root，无密码或根据你的配置填写；
2. B. 点击“新建”，输入数据库名称，如：dedecms_db；字符集选择 utf8mb4_general_ci，以支持中文和多语言；
3. C. 确认创建成功后如果需要，可以创建专门的数据库用户，并赋予权限；不过在本地测试一般用root即可。
5. D. 记住数据库名、 用户名和密码，这些信息后续会用于织梦系统的配置中。

3. 部署织梦dedeCMS程序文件到本地服务器目录中

dedeCMS官方压缩包包含完整的网站程序，需要放置在apache默认网站根目录下进行访问和运行。具体操作如下:

1. A. 找到phpStudy软件中的“网站根目录”， 一般是 phpStudy\WWW 文件夹，比方说 D:\phpStudy\WWW；
2. B. 将下载好的 dedeCMS 压缩包解压，将其中所有文件全部复制粘贴到上述 www 文件夹中；
3. C. 确认文件结构完整，如 index.php、include、plus 等核心文件存在；
5. D . 如果之前有旧版代码，请清理干净再覆盖，以避免缓存导致奇怪的问题 。

4 . 配置 Apache 虚拟主机

为了方便后续通过自定义域名访问本地站点， 我们可以修改 Apache 配置添加虚拟主机 ：

1. A . 打开 apache 配置文件 ： httpd-vhosts.conf ，路径一般在 phpStudy\Apache\conf\extra\ 下 ;
2. B . 添加虚拟主机配置 ：

   
       DocumentRoot "D:/phpStudy/WWW"
       ServerName dedelocal.test
       
           Options Indexes FollowSymLinks Includes ExecCGI
           AllowOverride All
           Require all granted
       
   
   

3. C . 修改 hosts 文件 添加映射 ： C:\Windows\System32\drivers\etc\hosts ，新增一行： 127.0.0.1 dedelocal.test
4. D . 重启 apache 服务生效 , 然后浏览器打开 http://dedelocal.test 测试是否正常显示 。如果页面出现 dedeCms 默认欢迎页面则说明部署成功。  

三 、 dedeCms 安装流程详解及注意事项  

完成上述部署后我们进入最关键的织梦 cms 安装过程。这部分直接决定未来网站的稳定性和平安性！  请务必认真对待每一步。以下内容基于织梦cms官方最新版本演示：  

1 . 初始化访问安装页面  http : // localhost / 或刚才设置的虚拟主机域名 ，首次进入将自动跳转到 install/index.php 页面 。    

如果页面卡死或者报错， 请检查 php 是否开启了 curl、mysqli ，以及 mysql 数据库连接是否正常 。一边查看 error_log 日志定位错误原因 。  

2 . 数据库信息填写　- 请按实际情况填写刚才创建的信息 ：  

• 数据库服务器： localhost 或127.0.0.1        
　　　
• 数据库名称： dedecms_db  
　　　
• 用户名： root     密码： ******  
　　　
• 数据表前缀： dede_  
　　　: 建议勾选“自动创建数据表”，防止因权限不足导致失败。　

3．确认许可协议并开始自动检测环境参数

dedeCMS会自动检测当前服务器是否满足最低运行条件， 包括PHP版本、必要 模块以及目录读写权限等。如果出现红色警告项，请先解决相关问题，否则无法正常运行。比方说缺少GD库或OpenSSL时请及时开启对应 。

4．初始化管理员账号信息配置及站点基本信息填写

管理员账号: 密码: 网站名称: 网站URL: 下一步 - 完成安装