安装部署

运行环境

项目	要求
操作系统	Linux（推荐 CentOS 7+ / Ubuntu 20.04+）
Web 服务	Nginx 1.18+
PHP	PHP 8.0+，开启 PDO、mbstring、openssl、curl、fileinfo、json
数据库	MySQL 5.7+ / 8.0，字符集 utf8mb4
缓存	Redis 可选，用于会话和队列
HTTPS	正式环境必须启用，支付回调只走 HTTPS

安装步骤

1. 创建站点目录

   在宝塔或命令行创建站点，例如 /www/wwwroot/www.example.com。

2. 上传程序

   把程序包解压到站点根目录，确保 index.php 和 admin/ 在同一层。

3. 创建数据库

   新建 MySQL 数据库和独立用户，字符集选择 utf8mb4，导入安装 SQL。

4. 配置数据库

   编辑数据库配置文件，填写主机、库名、用户名和密码。不要把配置文件暴露在 Web 目录之外的可下载路径。

5. 设置目录权限

   运行目录、缓存和上传目录需要 Web 用户可写，推荐属主 www:www，目录 755，文件 644。

6. 配置 Nginx

   开启 PHP 解析，静态文件直接返回，其它请求交给入口文件处理。

7. 访问后台

   打开 https://你的域名/admin/，使用安装时创建的管理员登录。

Nginx 参考

server {
    listen 80;
    server_name www.example.com;
    root /www/wwwroot/www.example.com;
    index index.php index.html;

    location / {
        try_files $uri $uri/ /index.php?$args;
    }

    location ~ \.php$ {
        include fastcgi_params;
        fastcgi_pass unix:/tmp/php-cgi-80.sock;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
    }
}

安装后检查

• 后台能正常登录，分类和产品页面能打开。
• 前台应用列表、产品详情和 API 列表能读取数据库。
• 客户可以注册、登录、进入控制台。
• 待支付订单可以进入付款页。
• 支付回调地址可以从公网通过 HTTPS 访问。