开发文档

一、安装包内容

• backend/：网站程序（PHP，ThinkCMF 5.0 / ThinkPHP 5.0）——网站运行根目录是 backend/public；
• db/install_full.sql：完整数据库（含建库语句 + 演示数据），推荐一键导入；db/schema_patch.sql 与 db/upgrade_*.sql 是结构补丁与历次升级脚本（按文件名日期顺序执行）；
• frontend_src/：前端源码（uni-app，H5/PC）；docs/：Nginx / Apache 伪静态示例。

二、环境要求

• PHP 7.1 ~ 7.4（推荐 7.4），扩展：pdo_mysql、mbstring、curl、gd、openssl、fileinfo、json、zip；
• MySQL 5.6+ / MariaDB 10.2+（utf8mb4）；需要伪静态（URL Rewrite）；
• 磁盘：程序约 200MB（含演示图片），数据库约 3MB。

三、安装步骤

1. 把 backend/ 整个目录上传到服务器（例如 /www/wwwroot/zuhao/）；
2. 把域名/网站根目录指向 /www/wwwroot/zuhao/backend/public —— 注意不是 backend/；
3. 导入 db/install_full.sql（phpMyAdmin / 宝塔 / 命令行均可），它会自动建库、建 56 张表、写入演示数据与后台菜单；
4. 改 backend/data/config/database.php（或 CMF 的数据库配置）里的库名/账号/密码；
5. 配置伪静态（参考 docs/nginx.conf.example 或 docs/apache.htaccess）；
6. 访问站点首页，后台入口 /admin（默认后台账号见安装说明或导入的演示数据）。

四、目录权限

• 可写：backend/data/（配置与缓存）、backend/public/upload/（上传）、backend/runtime/（TP 运行目录）；
• Linux 参考：chmod -R 755 backend/data backend/public/upload backend/runtime，属主设为 PHP 运行用户。

五、安装后必做

• 后台「设置」核对站点域名、客服、短信/邮件配置；
• 把 db/ 下还有没执行过的 upgrade_*.sql（比对文件日期）按顺序补跑；
• 前台是 uni-app 前端：若要自己改前端，在 frontend_src/ 里改并构建，产物覆盖到站点（改前备份）；
• 需要另装 PHP 版本时注意：本程序锁 PHP 7.1~7.4，8.0+ 不兼容（ThinkCMF 5 老内核）。

六、常见问题

• 整站 404 / 子页面打不开：伪静态没配；
• 后台能开前台白屏：前端产物路径不对，检查站点根是否指到了 backend/public；
• 上传图片失败：public/upload 权限不足；
• 换域名后登录异常：清 data/runtime 缓存并核对 cmf_option 里的站点域名。