# EMSHOP

**Repository Path**: emfaka/emshop

## Basic Information

- **Project Name**: EMSHOP
- **Description**: EMSHOP（原红盟云卡）是一套专门为虚拟商品交易定制的开源数字商品销售系统，帮助个人创业者和企业卖家快速搭建属于自己的自动发卡商城。无论是游戏点卡、软件激活码、会员订阅、课程资料还是各类虚拟服务，EMShop可以让您轻松商品管理、自动处理订单、对接主流支付通道，实现7×24小时自动化售卖。
- **Primary Language**: PHP
- **License**: GPL-3.0
- **Default Branch**: master
- **Homepage**: https://emfaka.com/
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2026-04-27
- **Last Updated**: 2026-06-15

## Categories & Tags

**Categories**: Uncategorized

**Tags**: emshop, 红盟云卡, 自动发卡, 发卡商城

## README

# EMSHOP 发卡程序

<p align="center">
  <strong>专为虚拟商品交易打造的开源数字商品销售系统</strong>
</p>

<p align="center">
  <a href="https://emfaka.com/">官方网站</a>
  ·
  <a href="https://emfaka.com/xiazai">程序下载</a>
  ·
  <a href="https://emfaka.com/yanshi">官方演示</a>
  ·
  <a href="https://emfaka.com/forum/186.html">需求反馈</a>
</p>

<p align="center">
  <img src="https://img.shields.io/badge/EMSHOP-v1.2.72-blue" alt="EMSHOP Version">
  <img src="https://img.shields.io/badge/PHP-%3E%3D7.2-777BB4" alt="PHP Version">
  <img src="https://img.shields.io/badge/MySQL-%3E%3D5.6-4479A1" alt="MySQL Version">
  <img src="https://img.shields.io/badge/License-GPLv3-green" alt="License">
</p>

---

## 项目介绍

**EMSHOP 发卡程序**是一套面向虚拟商品、数字商品、卡密商品、账号资源、会员权益、授权码等业务场景的自动售卖系统。系统围绕“商品展示 → 在线下单 → 支付对接 → 自动发货 → 订单管理 → 售后运营”构建，适合个人站长、工作室、团队和企业搭建数字商品销售平台。

EMSHOP 以轻量、高效、易部署为核心，内置后台管理、商品管理、库存管理、订单管理、会员中心、分站体系、支付插件、文章/博客 SEO、模板扩展和插件扩展能力，能够满足从单站售卖到多站点运营的不同需求。

---

## 功能特性

### 商品与发货

- 支持虚拟商品、卡密商品、账号类商品、服务类商品等数字商品售卖
- 支持自动发货，用户支付完成后可自动获取商品内容
- 支持普通商品、一次性库存、通用库存等多种发货方式
- 支持多规格 SKU，适合不同地区、套餐、版本、数量、权益等商品组合
- 支持库存管理、库存导入、库存导出、库存使用记录追踪
- 支持商品分类、商品标签、商品排序、商品上下架管理

### 订单与支付

- 支持在线下单、订单查询、订单状态管理
- 支持支付插件扩展，便于对接不同支付渠道
- 支持优惠券、余额、充值记录、资金流水等基础运营能力
- 支持订单列表、订单明细、发货记录、异常订单处理
- 支持邮件通知、站内通知等业务提醒能力

### 用户与会员

- 支持用户注册、登录、个人中心
- 支持用户余额、充值订单、消费记录
- 支持会员等级、用户权益、授权信息等扩展场景
- 支持用户订单查看、商品购买记录查询

### 分站与运营

- 支持分站体系，适合代理分销、多站点运营和业务拆分
- 支持分站商品、分站等级、分站账单、分站插件、分站存储等管理能力
- 支持后台导航管理、链接管理、页面管理、评论管理
- 支持文章、标签、分类、评论等内容模块，便于做教程、公告和 SEO 内容沉淀

### 模板与插件

- 支持前台模板扩展，可根据业务需要更换商城展示风格
- 支持博客模板，适合官网、教程站、公告站和帮助中心
- 支持插件机制，支付、商品类型、发货方式、后台功能均可扩展
- 默认包含常用商品插件、支付插件、后台首页增强等基础扩展

### 管理与维护

- 支持安装向导，填写数据库信息即可完成初始化
- 支持系统设置、站点配置、媒体资源管理
- 支持数据备份、数据恢复、系统日志、修复工具
- 支持在线升级相关接口，便于后续版本维护

---

## 适用场景

EMSHOP 适合以下业务场景：

- 虚拟商品自动发货平台
- 卡密、兑换码、授权码售卖站
- Apple ID、Gmail、Telegram、Google Voice 等账号类商品商城
- 软件授权、会员权益、订阅服务售卖
- 数字资源、教程资料、素材资源售卖
- 代理分销、分站运营、多站点业务矩阵
- 个人发卡站、工作室数字商品商城、企业级自动售卖系统

---

## 运行环境

推荐环境：

| 环境 | 推荐版本 |
| --- | --- |
| 操作系统 | Linux |
| Web 服务 | Nginx / Apache |
| PHP | 7.4 及以上 |
| MySQL | 5.6 及以上，推荐 5.7 / 8.0 |
| 编码 | UTF-8 / UTF8MB4 |

最低建议：

- PHP 7.2+
- MySQL 5.6+
- Nginx / Apache
- 支持伪静态

推荐开启 PHP 扩展：

- `mysqli` 或 `pdo_mysql`
- `curl`
- `mbstring`
- `openssl`
- `json`
- `gd`
- `fileinfo`
- `zip`

---

## 安装部署

### 1. 下载程序

从官方渠道下载 EMSHOP 正式版程序包，或从 GitHub Release 下载最新版本压缩包。

### 2. 上传源码

将程序文件上传到网站根目录，例如：

```text
/www/wwwroot/your-domain.com/
```

确保以下目录具有可写权限：

```text
content/cache/
content/log/
content/uploadfile/
content/backup/
content/templates/
content/plugins/
```

### 3. 创建数据库

在 MySQL 中创建一个空数据库，并记录：

```text
数据库地址
数据库名称
数据库用户名
数据库密码
数据库表前缀
```

推荐数据库编码使用：

```text
utf8mb4
```

### 4. 访问安装向导

浏览器访问：

```text
https://你的域名/install.php
```

按照页面提示填写数据库信息、管理员账号、站点信息，完成安装。

### 5. 配置伪静态

Apache 环境可使用项目内置 `.htaccess`。

Nginx 可参考以下规则：

```nginx
location / {
    try_files $uri $uri/ /index.php?$query_string;
}
```

### 6. 安装后安全处理

安装完成后建议：

- 删除或重命名 `install.php`
- 检查 `config.php` 是否已生成正确数据库配置
- 设置合理的目录权限
- 开启 HTTPS
- 定期备份网站文件和数据库
- 不要将生产环境的数据库密码提交到公开仓库

---

## 宝塔面板快速部署建议

1. 新建站点，选择 PHP 7.4 或 PHP 8.0。
2. 新建 MySQL 数据库，编码选择 `utf8mb4`。
3. 上传并解压 EMSHOP 程序包到网站根目录。
4. 设置运行目录为网站根目录。
5. 配置伪静态规则。
6. 访问 `/install.php` 完成安装。
7. 安装完成后删除安装文件并开启 HTTPS。

---

## 常用后台模块

- 控制台：查看系统状态、版本信息、环境信息
- 商品管理：商品、分类、规格、库存、发货方式
- 订单管理：订单列表、订单明细、发货记录
- 用户管理：会员、余额、充值、提现、等级
- 内容管理：文章、页面、标签、评论、友情链接
- 分站管理：分站、分站商品、分站账单、分站等级
- 插件管理：支付插件、商品插件、功能插件
- 模板管理：前台模板、博客模板、模板配置
- 系统管理：站点设置、导航、媒体、日志、备份、修复

---

## 更新升级

升级前请务必备份：

```text
1. 网站完整文件
2. MySQL 数据库
3. content/uploadfile/ 上传资源
4. content/templates/ 自定义模板
5. content/plugins/ 自定义插件
6. config.php 配置文件
```

推荐升级流程：

1. 查看官方更新日志。
2. 备份当前站点和数据库。
3. 在测试环境验证新版兼容性。
4. 确认模板、插件、支付接口正常。
5. 再同步到生产环境。

---

## 二次开发说明

EMSHOP 采用传统 PHP 项目结构，核心功能按后台、用户中心、模板、插件、模型、类库等模块划分。二次开发时建议优先通过以下方式扩展：

- 前台样式调整：修改 `content/templates/` 下的模板
- 博客/文章样式调整：修改 `content/blog/` 下的模板
- 支付渠道扩展：新增或修改 `content/plugins/` 下的支付插件
- 商品发货扩展：新增商品插件或发货回调逻辑
- 后台功能扩展：新增后台页面并接入权限与菜单
- 数据逻辑扩展：优先通过模型层和服务层处理，减少直接散落 SQL

建议不要直接修改核心文件，除非你明确知道后续升级时需要合并差异。

---

## 安全建议

- 生产环境不要开启调试信息输出
- 数据库账号不要使用 root
- 后台账号使用强密码，并定期更换
- 后台路径、服务器面板、数据库面板建议增加访问限制
- 上传目录禁止执行 PHP 文件
- 定期备份数据库与上传文件
- 支付回调地址建议使用 HTTPS
- 插件和模板请从可信渠道下载
- 公开 GitHub 仓库不要提交真实 `config.php`、数据库备份、日志文件、支付密钥

---

## 常见问题

### 安装时提示数据库连接失败怎么办？

请检查数据库地址、数据库名、用户名、密码是否正确，并确认 MySQL 服务正常运行。如果数据库不在本机，还需要确认远程数据库授权和防火墙端口是否放行。

### 支付成功后没有自动发货怎么办？

请检查支付插件配置、支付回调地址、服务器 HTTPS、订单状态、库存内容和系统日志。若使用第三方支付，还需要确认第三方平台是否成功通知到站点。

### 商品图片或附件上传失败怎么办？

请检查 `content/uploadfile/` 目录权限，以及 PHP 上传大小限制、文件类型限制、磁盘空间是否正常。

### 后台样式错乱怎么办？

请清理浏览器缓存、站点缓存、CDN 缓存，并确认静态资源路径、HTTPS 配置和伪静态规则正常。

### 升级前需要注意什么？

务必先备份网站文件和数据库。特别是自定义模板、插件、上传文件和数据库数据，建议先在测试环境验证后再升级生产站点。

---

## 贡献方式

欢迎提交 Issue、Pull Request 或功能建议：

- Bug 反馈：请提供复现步骤、环境版本、错误截图、日志信息
- 功能建议：请说明使用场景、期望效果、参考截图
- 代码贡献：请尽量保持代码风格一致，并说明改动范围
- 文档完善：欢迎补充安装教程、部署教程、常见问题和插件开发说明

---

## 版本信息

当前 README 整理版本：

```text
EMSHOP v1.2.72
```

版本更新建议统一记录在：

```text
CHANGELOG.md
```

---

## 开源协议

本项目基于 `GPLv3` 协议发布，详情请查看项目根目录：

```text
license.txt
```

---

## 免责声明

本项目仅用于合法合规的数字商品销售、虚拟商品交付、自动化订单管理等场景。使用者应遵守所在国家或地区的法律法规，不得将本程序用于违法违规业务。因使用、二次开发、部署、经营行为产生的任何风险与责任，由使用者自行承担。

---

## 官方信息

- 官方网站：<https://emfaka.com/>
- 程序下载：<https://emfaka.com/xiazai>
- 官方演示：<https://emfaka.com/yanshi>
- 需求反馈：<https://emfaka.com/forum/186.html>
- 项目名称：EMSHOP 发卡程序
- 项目定位：虚拟商品自动售卖系统 / 数字商品销售平台 / 自动发卡系统
- 适用对象：个人站长、工作室、数字商品卖家、企业级虚拟商品运营团队