软件源码商城系统

一、环境要求

----------------------------------------

- PHP >= 8.1（推荐 8.2）

- MySQL >= 5.7（推荐 5.7 / 8.0）

- Nginx 或 Apache

- PHP 扩展：pdo_mysql、mbstring、json、openssl、fileinfo、curl、gd、zip、session

二、部署步骤（宝塔面板）

----------------------------------------

1. 新建站点

- 绑定你的域名

- PHP 版本选择 8.2

- 如需 HTTPS，申请并部署 SSL 证书

2. 新建数据库（宝塔 → 数据库）

- 记录下：数据库名、用户名、密码

- 字符集选择 utf8mb4

- 表前缀使用 cx_

3. 上传程序

- 将本包内所有文件上传到站点根目录（如 /www/wwwroot/你的域名/）

- 注意：不是上传到 public 子目录，站点根目录就是本包根目录

4. 设置运行目录（重要）

- 宝塔 → 网站 → 设置 → 网站目录 → 运行目录 选择 /public

- 伪静态选择 thinkphp（或手动填下面规则）

5. 设置伪静态（Nginx）

- 宝塔 → 网站 → 设置 → 伪静态，填入：

location / {

if (!-e $request_filename) {

rewrite ^/(.*)$ /index.php/$1 last;

}

}

6. 配置数据库连接

- 复制 .example.env 为 .env

- 修改 [DB] 段内容：

TYPE = mysql

HOST = 127.0.0.1

NAME = 你的数据库名

USER = 你的数据库用户

PASS = 你的数据库密码

PORT = 3306

CHARSET = utf8mb4

PREFIX = cx_

- 正式上线请把 APP_DEBUG 设为 false

- 注意：.env 使用 [DB] 分段格式，不要写成 DB_HOST = xxx 这种旧写法

7. 导入数据库

- 宝塔 → 数据库 → 导入，选择 install.sql

- 不要在 install.sql 里手工改表前缀；若你用了自定义前缀，

请同时修改 install.sql 中的表名与 .env 中的 PREFIX

8. 设置目录权限（Linux）

chmod -R 755 /www/wwwroot/你的域名

chown -R www:www /www/wwwroot/你的域名

chmod -R 777 /www/wwwroot/你的域名/runtime

三、访问地址

----------------------------------------

- 前台首页：http://你的域名/

- 后台管理：http://你的域名/admin

- 默认管理员：admin / admin123 ← 首次登录后请立即修改密码

四、登录后必做的配置

----------------------------------------

1. 程序授权

- 后台 → 支付配置 下方 → 程序授权

- 输入购买时获得的授权码，点击绑定（授权码与域名一对一绑定）

2. 支付配置

- 后台 → 支付配置

- 先选「网关类型」：逍遥PAY 填 /submit.php，标准易支付 YPAY 填 /api/submit.php

（如果对方给的接口地址已带完整 .php，直接粘到「接口地址」里即可，类型随便选）

- 填写易支付的：接口地址、商户号(pid)、商户密钥(key)

- 按需开启支付宝 / 微信支付 / QQ 钱包

- 设置最低充值金额

3. 系统设置

- 后台 → 系统设置：网站名称、标题、关键词、描述、Logo、ICP备案号

- 联系QQ、QQ群、统计代码

- 验证码开关（后台登录、前台注册、前台登录）

- 开放会员注册开关、自助友链申请开关

4. 邮箱设置（可选）

- 后台 → 邮箱设置：SMTP 服务器、端口、加密方式、账号、密码、发件人名称

- 可开启通知：注册成功通知会员、新会员注册通知管理员、

充值成功通知会员、充值成功通知管理员、软件到期提醒

- 需强制邮箱验证时，打开「强制邮箱验证」开关

五、目录说明

----------------------------------------

app/admin 后台管理应用

app/index 前台商城应用

app/api 对外接口应用（软件更新、下载、授权校验）

app/common 公共模型与服务

config 框架与应用配置

public 网站运行目录（入口 index.php、静态资源）

route 路由（预留）

vendor Composer 依赖（已内置，无需再执行 composer install）

install.sql 数据库安装脚本

demo_data.sql 演示数据（可选，见「五之附」）

.example.env 数据库/运行环境配置模板

deploy-docs/ 详细部署文档（deploy-guide.html，用浏览器打开）

五之附、演示数据（可选）

----------------------------------------

包内 demo_data.sql 是一份演示数据，含 14 个分类、10 个源码商品、

3 条公告与 3 条友情链接，导入后前台立刻有内容可浏览，适合首次

安装时直观了解前台效果。

- 导入方式：宝塔 → 数据库 → 导入，选择 demo_data.sql

- 注意：该脚本会先清空 cx_category / cx_goods / cx_notice /

cx_friendlink 四张表。已录入真实数据的站点请勿导入。

- 清理：脚本末尾附有「清理演示数据」语句，执行后即可自行

录入正式的分类与商品。

六、常见问题

----------------------------------------

Q1. 打开出现 404

→ 检查「运行目录」是否设为 /public；检查伪静态规则是否已保存。

Q2. 显示「页面错误！请稍后再试～」

→ 把 .env 中 APP_DEBUG 临时改为 true 查看具体报错，

排查完成后务必改回 false。

→ 常见原因：.env 数据库配置格式错误（缺少 [DB] 分段）。

Q3. 登录后立刻跳回登录页

→ runtime 目录没有写入权限：

chmod -R 777 runtime

Q4. 后台提示未授权 / 自动跳到程序授权页

→ 属于正常机制。请在「程序授权」中绑定授权码，

并确认授权码绑定的域名与当前访问域名完全一致。

Q5. 上传的更新包 / 软件文件下载 404

→ 确认 public 下上传目录存在且可写。

七、安全建议

----------------------------------------

1. 首次登录后立即修改后台管理员密码

2. 正式环境务必设置 APP_DEBUG = false

3. 妥善保管 .env（包含数据库密码），不要提交到公开仓库

4. public 目录下不要放置 phpinfo、探针、调试脚本

5. 定期备份数据库与 public 下的上传文件

========================================