更新 README 文档,替换为 GeneAgro CMS 使用说明

This commit is contained in:
2025-10-19 12:26:01 +08:00
parent b8286157ac
commit a9bcfce8d8
7 changed files with 398 additions and 90 deletions

49
doc/Deployment.md Normal file
View File

@@ -0,0 +1,49 @@
# GeneAgro CMS 部署与重写规则指南
环境准备
- PHP7.0 及以上(建议 7.17.4),启用 gd、mbstring、curl、mysqli 扩展。
- Web 服务器Nginx/Apache/IIS 均可,需开启伪静态/URL 重写。
- 时区与编码:建议在 php.ini 中设置 date.timezone=Asia/Shanghai确保输出编码为 UTF-8。
目录权限
- 需写入权限runtime、log、static/upload、data 等目录。
- 生产环境最小化权限:仅赋予必要写入目录权限,其他目录只读。
重写规则示例
- Nginx参考 rewrite/nginx.txt
- 典型配置:
- location / { try_files $uri $uri/ /index.php?$args; }
- 后台入口保持直达:/iotadmin.php。
- Apache参考 rewrite/.htaccess
- 典型配置:
- RewriteEngine On
- RewriteCond %{REQUEST_FILENAME} !-f
- RewriteCond %{REQUEST_FILENAME} !-d
- RewriteRule . index.php [L]
- IIS参考 rewrite/web.config
- 使用 URL Rewrite 组件导入 web.config 配置。
应用入口与路由
- 前台入口index.php。
- 后台入口iotadmin.php。
- API 入口api.php。
- 路由apps/common/route.php系统内置config/route.php项目覆盖与扩展
部署流程建议
1) 上传代码至站点目录,确认 PHP 版本与扩展;
2) 配置数据库config/database.php与站点参数config/config.php
3) 设置伪静态规则(参考 rewrite 目录);
4) 访问后台 iotadmin.php 完成站点与 API 配置;
5) 验证前台与 API 可用性;
6) 关闭调试模式core/convention.php 中 debug=false开启必要的日志与监控。
安全加固
- HTTPS建议强制 HTTPS尤其是后台与 API 访问)。
- 会话安全启用仅站点路径会话session_in_sitepath=true合理设置 Cookie 参数HttpOnly、Secure
- 访问控制:按需配置 access_rule.*(限制特定浏览器/操作系统)。
- 文件上传:限制格式与尺寸,开启水印(如有需求),对上传目录做执行权限隔离(不允许脚本执行)。
性能与运维
- 缓存:根据业务开启 Memcachecache.handler=memcache
- 日志:生产环境建议使用数据库日志,并按周期归档;或文本日志按日切割并外采。
- 备份:数据库定时备份,日志与上传文件定期打包与远端归档。