1 产品与环境要求
1.1 产品简介
热建企业CMS 2.0 是四川热键科技有限公司自主研发的企业级内容管理系统，基于 PHP 与 MySQL 构建，采用 CodeIgniter 4 框架开发。系统提供内容管理、电子杂志、会员投稿、支付、安全、SEO、多语言与 AI 等完整能力，可快速部署内容门户、文学期刊、电子杂志与企业官网等站点。
1.2 运行环境要求
| 项目 | 要求 |
|---|---|
| 操作系统 | Linux / Windows Server / 主流虚拟主机 |
| Web 服务器 | Apache 2.4 及以上，或 Nginx（需支持 URL 重写） |
| PHP 版本 | 8.2 及以上 |
| 数据库 | MySQL 5.7 及以上（或兼容的 MariaDB） |
| 站点根目录 | Web 根目录指向系统 public 目录 |
1.3 PHP 扩展要求
系统运行需要以下 PHP 扩展，安装前请确认均已启用：
| 扩展 | 用途 | 是否必需 |
|---|---|---|
| intl | 国际化与多语言 | 必需 |
| mbstring | 多字节字符串处理 | 必需 |
| openssl | 加密与安全 | 必需 |
| json | 数据交换 | 必需 |
| mysqli | MySQL 数据库驱动 | 必需 |
| fileinfo | 文件类型识别 | 必需 |
| gd | 图片处理 | 建议 |
| curl | 远程请求（微信、AI 等） | 建议 |
| sodium | 加密支持 | 建议 |
| zip / bcmath | 压缩与计算扩展 | 可选 |
2 安装前准备
2.1 获取安装包
向四川热键科技有限公司获取最新安装包（源码压缩包）。解压后主要包含 system、app、public、writable、modules、plugins 等目录，其中 public 为对外可访问的 Web 根目录。
2.2 环境检查
- ·确认 PHP 版本不低于 8.2 且必要扩展已启用；
- ·确认 MySQL 服务可正常连接，并已创建数据库及账号；
- ·确认 Web 服务器已启用 URL 重写（Apache 的 mod_rewrite 或 Nginx 的 rewrite 模块）。
3 安装步骤
3.1 上传源码
将源码上传至服务器站点目录，并将 Web 根目录指向 public。若主机环境无法直接指定 public，需在站点根目录配置重写规则，将请求转发至 public/index.php。
3.2 配置 .env
将随包提供的 .env 配置文件复制到站点根目录，填写站点地址、数据库连接信息与加密密钥等参数。具体字段说明见第 4 章。
3.3 数据库初始化
- ·创建数据库（如 rejiancms），字符集建议 utf8mb4；
- ·导入随包提供的数据库初始化脚本（install.sql）；
- ·或在已有备份环境下使用后台“数据库恢复”导入备份文件。
3.4 目录权限设置
确保 writable 目录具备写入权限，该目录用于缓存、日志、会话与上传文件的读写。Linux 下可执行 chmod -R 755 并对 writable 目录赋予写权限。
3.5 Web 服务器配置
3.5.1 Apache
启用 mod_rewrite 模块，public 目录下的 .htaccess 已内置“静态优先 + 前端控制器”重写规则，通常无需额外修改。确保 AllowOverride 允许 .htaccess 生效。
3.5.2 Nginx
将 root 指向 public 目录，配置 try_files 将不存在的请求转发到 index.php，并参照系统伪静态规则配置 rewrite：
3.6 访问验证
- ·访问站点首页，确认前台正常渲染；
- ·访问后台地址（如 /admin），使用初始管理员账号登录；
- ·提交一篇文章或电子杂志，验证后台与前台数据连通正常。
4 配置说明
4.1 .env 配置详解
| 配置项 | 说明 | 示例 |
|---|---|---|
| CI_ENVIRONMENT | 运行环境，development 为开发，production 为生产 | development |
| app.baseURL | 站点根地址 | http://127.0.0.1/ |
| app.indexPage | 是否隐藏 index.php | 留空 |
| database.default.hostname | 数据库主机 | 127.0.0.1 |
| database.default.database | 数据库名 | rejiancms |
| database.default.username | 数据库账号 | rejian |
| database.default.DBDriver | 数据库驱动 | MySQLi |
| database.default.DBPrefix | 数据表前缀 | rj_ |
| database.default.charset | 字符集 | utf8mb4 |
| database.default.port | 数据库端口 | 3306 |
| encryption.key | 数据加密密钥（32 字节十六进制） | 随机生成 |
| app.sessionDriver | 会话存储驱动 | files |
4.2 多语言
系统内置多语言能力，可在后台多语言插件中配置中文、英文等语言包、默认语言与语言切换逻辑。前台按地址前缀（如 /zh、/en）提供对应语言内容。
4.3 伪静态与静态化
系统采用“静态优先”重写机制：优先访问 html 目录下已生成的静态页面，未命中时回退到 index.php 动态渲染。可通过后台“静态化管理”生成静态页面，显著提升访问速度并利于 SEO 收录。
5 安全加固
5.1 生产环境配置
- ·将 .env 中 CI_ENVIRONMENT 设置为 production，关闭调试信息；
- ·隐藏服务器签名，禁用目录浏览；
- ·对外仅暴露 public 目录，避免直接访问系统源码目录。
5.2 目录与文件保护
- ·对 writable、.env、system、app 等目录配置禁止 Web 访问；
- ·备份文件、数据库脚本避免存放于 Web 可访问目录；
- ·上传目录需校验文件类型，防止上传可执行脚本。
5.3 安全建议
- ·使用强密码并定期更换；
- ·开启后台登录封锁与 IP 黑名单、防火墙规则；
- ·定期备份数据库与上传目录；
- ·关注官方安全公告并及时升级。
6 升级与维护
6.1 升级
升级前务必备份数据库与源码。在官方升级指引下替换新版源码，并按需执行数据库结构升级，最后清理缓存。
6.2 数据备份与恢复
使用后台“网站维护 — 数据库备份”可生成数据库备份文件；恢复时选择对应备份文件导入即可。建议定期备份并异地保存。
6.3 缓存清理
后台“网站维护 — 缓存”可清理系统缓存与全站缓存。内容更新后若前台未刷新，可执行缓存清理与静态页重新生成。
7 常见问题排查
| 现象 | 可能原因与处理方法 |
|---|---|
| 首页或栏目 404 | URL 重写未生效或 Web 根未指向 public；检查 .htaccess / Nginx rewrite 与 AllowOverride |
| 数据库连接失败 | 核对 .env 中数据库主机、库名、账号与端口是否正确，数据库服务是否启动 |
| 上传或写入失败 | 检查 writable 及上传目录是否具备写权限 |
| 页面 500 错误 | 查看 writable/logs 下运行日志，按错误信息定位（常见为扩展缺失或配置错误） |
| 后台无法登录 | 确认管理员账号存在，检查登录封锁与 IP 黑名单是否误拦 |
附录A 目录结构说明
| 目录 | 说明 |
|---|---|
| system | CodeIgniter 框架核心 |
| app | 应用配置、控制器、模型、视图 |
| modules | 业务模块（内容、杂志、会员、支付、安全、SEO 等） |
| plugins | 扩展插件 |
| public | Web 根目录（对外唯一入口，含 index.php 与静态资源） |
| writable | 缓存、日志、会话与上传文件（需写权限） |
| docs | 产品文档 |
安装完成后请及时修改初始管理员密码，并将 CI_ENVIRONMENT 切换为 production；如遇异常，优先查阅 writable/logs 下的运行日志。