开发文档

一、环境要求

• PHP 8.2 或更高（推荐 8.2）/ MySQL 5.7+ / MariaDB 10.3+（utf8mb4）；
• PHP 扩展：PDO、pdo_mysql、GD（推广二维码/图片处理必需）；
• 建议 php.ini 设 date.timezone = Asia/Shanghai（否则订单/抽取记录时间差 8 小时）；
• Nginx / Apache 均可，本程序无复杂伪静态要求（?mod=xxx 形式的路由）。

二、安装步骤

1. 解压安装包，把 xjukeji-manghe 目录里的全部文件上传到网站根目录（也可以直接把该目录当站点根）；
2. 确认站点根目录可写（安装程序要生成 config.php 和 install.lock）；
3. 浏览器访问 http://你的域名/install/；
4. 按向导填写：
   • 数据库地址 / 端口 / 库名 / 用户名 / 密码 / 表前缀（默认 mh）；
   • 站点名称、标题、关键词、描述、客服微信、客服 QQ；
   • 管理员账号与密码（后台登录用，务必牢记）；
5. 看到「安装成功」后，后台地址：http://你的域名/admin/login.php。

三、安装完成后必做

1. 删除站点根目录下的 install/ 整个目录（不删的话别人可以重复运行安装程序）；
2. 确认根目录已生成 config.php 和 install.lock（如需重装：删掉 install.lock 后再访问 /install/）；
3. 到后台「程序信息」页确认各项状态正常；
4. 后台「盲盒设置」里配好：盲盒投递费用、抽取费用、VIP 费用、每日签到积分、加盟费用、一级/二级利润、最低提现、人工审核开关、可选二级域名；
5. 后台「支付配置」填易支付参数（接口地址 / PID / 密钥），回调地址用正式域名；
6. 把客服微信/QQ、轮播图、用户中心公告补上，前台就完整了。

四、常见问题

• 访问首页一直跳到 /install/：还没装成功，或根目录缺 install.lock；
• 向导提示「config.php 可写：未通过」：给站点根目录写权限（Linux chmod -R 755，属主设为 Web 运行用户）；
• 后台时间不对 / 订单时间差 8 小时：php.ini 设 date.timezone = Asia/Shanghai 后重启 PHP；
• 提示「数据库中已存在相同前缀的表」：换表前缀，或先清空该库；
• 推广二维码 / 图片不显示：检查 php GD 扩展是否开启；
• 买家/月老提现提交报错：确认 mh_tixian 表的 user 列是 varchar（老版本是 int，严格模式 MySQL 下会报 Incorrect integer value，执行 ALTER TABLE mh_tixian MODIFY `user` varchar(255) NOT NULL; 修复）。

五、备份与搬家

• 备份：数据库（前缀 mh，7 张表）+ 站点目录 + config.php；
• 搬家/换域名：改 config.php 库信息；后台「站点设置」与各分站的二级域名要逐条核对（分站按域名匹配 mh_site.url）。