开发文档

一、环境要求

• PHP 8.0 及以上（推荐 8.1）；MySQL 5.6+（utf8mb4）；
• PHP 扩展：pdo_mysql、mbstring、curl、gd、openssl、fileinfo、zip、bcmath；
• Nginx 或 Apache（Apache 根目录自带 .htaccess；Nginx 要按下面的规则配伪静态）；
• runtime/ 可写；不需要 Redis。

二、Nginx 伪静态（必配）

location ~* ^/(runtime|kernel|config|vendor)/  { return 404; }
location ~  /\.(?!well-known)                  { return 404; }
location ~* \.(log|sql|sqlite|db|db-wal|db-shm|bak|old|save|orig|swp|swo|tmp|ini|lock)$ { return 404; }
location ~* (~|composer\.(json|lock)|package(-lock)?\.json)$ { return 404; }
location / {
    try_files $uri $uri/ /index.php?s=$uri&$args;
}

（前三条是安全规则：把 runtime / 内核 / 配置 / 依赖目录和敏感后缀挡在外面，建议照抄。）

三、安装步骤

1. 上传源码到网站根目录（或 composer create-project lizhipay/acg-faka 拉取）；确认 vendor/ 存在；
2. 配好上面的伪静态；
3. 建好数据库（utf8mb4），配置 config/database.php 里的库名/账号/密码（该文件是 include 返回数组的形式）；
4. 浏览器打开站点首页，即自动进入安装向导，按提示填库信息与管理员；
5. 安装完成后的入口：后台 /admin（管理员用邮箱登录，注册时填的邮箱就是登录名），前台就是站点首页。

四、安装后必做

• 支付通道：后台配置支付（易支付/码支付等），回调地址用正式 HTTPS 域名；
• 商品与卡密：建分类 → 建商品（支持卡密商品与固定内容发货）→ 导入卡密；
• 风格：二次元玻璃拟态主题在 assets/，换配色建议改主题变量而非硬编码；
• 安全：伪静态里的 deny 规则别删；后台入口可以再套一层 Basic Auth 双保险；
• 备份：数据库（前缀默认 acg_）+ 站点目录。

五、常见问题

• 首页打不开 / 404：伪静态没配（Nginx 必须加规则，Apache 有 .htaccess）；
• 装完样式丢失：assets/ 没传全，或 Web 根目录指错；
• 后台登录提示密码错误：后台登录名是邮箱不是用户名；
• 会员登录要验证码：前台验证码接口 /user/captcha/image?action=login；测试/自动化要带同一会话的 cookie 取图；
• 旁挂脚本输出的 JSON 解析失败：本程序的配置文件没有 port 键，脚本里取端口要 $d['port'] ?? 3306，并加 ini_set('display_errors','0')。

六、升级

覆盖源码（保留 config/database.php 与 runtime/、上传目录），用 composer 拉取的执行 composer update；结构变更按版本说明执行迁移。