开发文档

一、环境要求

• PHP 7.4（兼容 7.2~8.0；推荐 7.4，8.1+ 未适配）；MySQL 5.6+（utf8mb4）；
• PHP 扩展：pdo_mysql / mysqli、curl、mbstring、gd、openssl、fileinfo、zip；
• Nginx / Apache（需伪静态）；目录 cache/、runtime/ 可写；
• 核心文件是加密形态，部署时不要试图编辑 index.php 等核心文件（会直接坏站）。

二、安装步骤

1. 上传全部文件到网站根目录，把网站运行目录指向程序根（本程序不需要指向 public，根目录即站点根）；
2. 建库（utf8mb4），记住库名/账号/密码；
3. 浏览器访问 http://你的域名/install/，按向导填写数据库与站点信息；
4. 安装完成会生成 config.php 和 install/install.lock；装完请删除 install/ 目录（或至少确认 install.lock 存在）；
5. 后台：/admin/login.php；前台会员中心：/user/。

三、安装后必做

• 计划任务：把 cron.php / cron_jobs.php 挂到系统计划任务（建议每分钟一次），自动发货、订单超时、对账都依赖它；
• 支付配置：后台「支付设置」填易支付/微信/支付宝参数，异步回调地址用正式 HTTPS 域名；
• 商品与卡密：先建分类/商品，再导入卡密（shua_kms / 发卡表），商品设置里选自动发货；
• 分站与供应商：分站域名解析好后，在后台「分站管理」绑定；供应商对接在 sup/ 与后台同步配置（shua_sync_config）；
• 模板：后台可切换多套模板（template/ 下 Agod / AgodM / AgodN / Fall1…），改模板前先复制备份。

四、常见问题

• 装完首页空白/报错：PHP 版本不对（要 7.4 系）或 cache/ 不可写；
• 后台登录成功但菜单点不动：伪静态没配（带参数的页面走伪静态规则）；
• 前台 AJAX 返回 403：接口带同站 Referer 校验，用工具直连会被拒，属正常防跨站；
• 自动发货不跑：cron 没挂或卡密池为空；
• 改不了核心逻辑：核心文件加密，二开请用「模板 + 旁挂 PHP 文件 + 直接操作数据库」的方式（参考开发文档）。

五、升级 / 备份

• 升级：覆盖程序文件（保留 config.php、cache/ 与你自己加的文件），如需结构变更按升级包说明执行 SQL；
• 备份：数据库（前缀 shua_，51 张表）+ 站点目录 + config.php。