前言
织梦 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. 下载资源准备
- DedeAMPZ整合包：适合初学者， 但不建议长期使用，主要原因是不够灵活且更新慢。
二、 本地测试环境搭建详解步骤
1. 安装phpStudy集成环境
phpStudy是一款国内用户常用的集成PHP+Apache+MySQL的软件包，适合快速搭建本地测试服务器。以下为安装步骤：
- 下载安装文件：访问官网下载安装包。
- 施行安装程序：双击运行安装文件，按照提示选择安装目录。建议不要安装在C盘避免权限问题。
- 启动服务面板：完成后打开phpStudy控制面板，启动Apache和MySQL服务。
- 配置PHP版本： 根据需要切换PHP版本， 确保与dedeCMS兼容，一般选择PHP7.4或更高版本。
2. 创建数据库与用户权限设置
dedeCMS依赖数据库存储网站数据，需要提前创建一个空数据库供程序使用。步骤如下：
- A. 打开 phpMyAdmin 管理界面：通常访问 http://localhost/phpmyadmin ， 默认用户名root，无密码或根据你的配置填写；
- B. 点击“新建”，输入数据库名称，如：dedecms_db；字符集选择 utf8mb4_general_ci，以支持中文和多语言；
- C. 确认创建成功后如果需要，可以创建专门的数据库用户，并赋予权限；不过在本地测试一般用root即可。
- D. 记住数据库名、 用户名和密码，这些信息后续会用于织梦系统的配置中。
3. 部署织梦dedeCMS程序文件到本地服务器目录中
dedeCMS官方压缩包包含完整的网站程序，需要放置在apache默认网站根目录下进行访问和运行。具体操作如下:
- A. 找到phpStudy软件中的“网站根目录”， 一般是 phpStudy\WWW 文件夹，比方说 D:\phpStudy\WWW；
- B. 将下载好的 dedeCMS 压缩包解压，将其中所有文件全部复制粘贴到上述 www 文件夹中；
- C. 确认文件结构完整，如 index.php、include、plus 等核心文件存在；
- D . 如果之前有旧版代码，请清理干净再覆盖，以避免缓存导致奇怪的问题 。
4 . 配置 Apache 虚拟主机
为了方便后续通过自定义域名访问本地站点， 我们可以修改 Apache 配置添加虚拟主机 ：
- A . 打开 apache 配置文件 ： httpd-vhosts.conf ，路径一般在 phpStudy\Apache\conf\extra\ 下 ;
- B . 添加虚拟主机配置 ：
DocumentRoot "D:/phpStudy/WWW"
ServerName dedelocal.test
Options Indexes FollowSymLinks Includes ExecCGI
AllowOverride All
Require all granted
- C . 修改 hosts 文件 添加映射 ： C:\Windows\System32\drivers\etc\hosts ，新增一行：
127.0.0.1 dedelocal.test
- 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．初始化管理员账号信息配置及站点基本信息填写
