开发文档

一、环境要求

• PHP 8.1 及以上（推荐 8.2）；MySQL 5.7 / MariaDB 10.3+；Nginx / Apache / IIS 均可；
• PHP 扩展：pdo_mysql、mysqli、mbstring、curl、fileinfo、openssl、gd（图片处理）；
• 站点根目录指向 public/；伪静态必配：try_files $uri $uri/ /index.php?$query_string;

二、上传与权限

• 上传全部文件（含 vendor/）；
• 可写目录：项目根目录（写 .env）、public/（写 install.lock）、runtime/、public/uploads/；
• Linux 参考：chmod -R 755 runtime public/uploads public（属主按实际运行用户调整）。

三、安装步骤

1. 上传安装包到网站目录，网站根目录指向 public；
2. 建好数据库（utf8mb4）；
3. 浏览器访问 http://你的域名/install.php；
4. 向导先自检环境，通过后填写：数据库地址 / 端口 / 库名 / 账号 / 密码，后台管理员账号与密码；「写入演示数据」默认勾选（正式站可取消）；
5. 安装完成后删除 install.php（如向导未自动删）；
6. 后台入口：/admin。

四、安装后必做

• 计划任务：TP8 的控制台入口是项目根的 think（php think 命令名），按后台「系统设置」里的定时任务说明加入 crontab，任务超时/自动结算依赖它；
• 支付配置：后台「支付设置」里填易支付（config/epay.php 对应项）或支付宝（config/alipay.php），回调地址必须是外网可访问的 HTTPS 域名；
• 短信/邮件：extend/alisms（阿里云短信）与 SMTP 配置好，注册验证码才能发出；
• 实名与提现：后台设定提现门槛、手续费与审核方式。

五、常见问题

• 装完首页 404 / 样式丢失：伪静态没配，或网站根目录指错（必须是 public/）；
• 页面报 Undefined array key：PHP 版本过低（本系统要求 8.1+）；
• 接口跨域/回调失败：在后台把站点域名填成带 https 的正式域名，别用 IP 或带端口；
• 任务不自动结束：检查计划任务是否在跑（runtime/log 里有定时任务日志）。

六、升级

/xj_panel.php 提供「验证授权 / 在线更新」；升级不会覆盖 .env、config/ 与上传目录。二开过 app/ 下文件的话，升级前先备份。