PHP在线文档/知识库系统

部署环境

1. 需要 PHP 8.3 及以上版本（代码使用了 PHP 8.1+ 枚举与 8.3+ 类型化类常量），MySQL 5.7 及以上。
2. 网站根目录请指向 public/，入口文件为 public/index.php；runtime/ 与 public/upload/ 目录需可写。
3. 先导入 ggdoc.sql 建库，再在 config/Database.php 中填写数据库连接信息。
4. 如需向搜索引擎推送链接和生成站点地图，请在 config/App.php 中配置 APP_DOMAIN，并通过服务器计划任务（crontab）定期执行 php mysmarty task/push_url。

上线前必做的安全设置

1. 默认管理员账号为 admin，部署后请立即修改密码。
2. 请更换 config/App.php 中的 ENCRYPTION_KEY 与 config/Jwt.php 中的 JWT 密钥（密钥一经使用不可随意再改，否则已加密数据将无法解密，所以务必在正式使用前确定）。
3. config/App.php 中 DEBUG 默认为 true，正式上线前请改为 false。
4. 如需邮件功能，请在 config/Mail.php 中配置 SMTP 服务器与授权码；不需要可不配置。

功能边界

1. 源码中前台 Url 控制器包含一批跳转到 auth.ggdoc.cn 的推广/教程链接路由，属于原作者的导流配置，购买后可自行保留、修改或删除，不影响核心功能。
2. API 发布接口需使用后台生成的秘钥调用，并在 api 表中维护 IP 白名单，请勿将秘钥暴露在前端。
3. 未内置付费阅读、会员系统等增值模块；如需此类功能可基于现有架构二次开发。

二次开发说明

1. 全部为自研代码，无 Composer 重型依赖，读懂 library/mysmarty 核心组件（路由、模型、模板）即可上手，学习成本低。
2. 新增页面只需：建控制器（#[Route('/xxx')] 注解路由）→ 建模型（继承 Model 即得链式查询/分页）→ 建视图模板，三步完成。
3. 前端静态资源（TinyMCE、Layer、Vue 等）已随源码内置在 public/static，不依赖外网 CDN，内网环境也可部署。