ZFAKA - 基于 YAF 框架的开源发卡系统

本文介绍 ZFAKA，一款基于 YAF + LayUI 开发的免费开源发卡系统。该系统专为个人或小型企业提供在线销售卡密的解决方案，支持自动发卡和手工发卡两种模式，并集成了多种主流支付渠道。

项目简介

ZFAKA 是由开发者"资料空白"(zlkb)创建的开源发卡系统，项目定位为永久免费、绝对开源。系统采用 PHP YAF 框架开发，前端使用 LayUI，具有轻量、高效、安全的特点。

官方信息：

• 演示地址：https://faka.zlkb.net/
• 开源协议：LGPL-3.0
• 主要语言：PHP (29.1%)、HTML (35.6%)、CSS (20.3%)、JavaScript (14.9%)

核心功能

会员模块

• 默认关闭注册，后台可灵活开启
• 注册会员可查看历史购买记录
• 支持会员中心管理

购买模块

• 自动发卡：支付成功后系统自动发送卡密
• 手工发卡：适用于需要人工处理的商品

后台模块

• 设置模块：全站配置管理
• 订单模块：订单查询、处理、统计
• 商品模块：商品分类、库存管理
• 卡密管理：支持批量导入导出
• 模板切换：多套首页模板可选
• 功能开关：验证码、注册、登录、找回密码等可后台控制

支付渠道

系统内置多种官方支付接口：

• 支付宝当面付
• 支付宝电脑网站支付
• 微信扫码支付
• 微信 H5 支付
• PayPal 支付

系统环境要求

安装指南

前置条件

重要提示： YAF 扩展的安装是部署过程中的关键环节，请务必仔细配置。

1. 安装 YAF 扩展

   • 通过 pecl 安装：pecl install yaf
   • 或在 php.ini 中启用：extension=yaf.so

2. 配置 YAF 在 php.ini 中添加：

   iniCopy

   yaf.use_namespace=1

安装步骤

1. 下载代码

# 克隆最新测试版
git clone https://github.com/zlkbdotnet/zfaka.git

# 或下载稳定版（推荐生产环境）
# 访问 https://github.com/zlkbdotnet/zfaka/releases

2. 修改配置文件

cd zfaka/conf
mv application.ini.new application.ini

3. 配置目录权限

4. 配置 Nginx

server {
    listen 80;
    server_name your-domain.com;
    root /path/to/zfaka/public;  # 注意：必须指向 public 目录
    index index.php index.html;

    location / {
        if (!-e $request_filename) {
            rewrite ^/(.*)$ /index.php?$1 last;
        }
    }

    location ~ \.php$ {
        fastcgi_pass 127.0.0.1:9000;
        fastcgi_index index.php;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        include fastcgi_params;
    }
}

5. 访问安装向导

浏览器访问 http://your-domain.com/install，按向导完成数据库配置和管理员账号设置。

6. 配置计划任务（可选）

用于定时发送邮件通知：

# 添加到 crontab
*/5 * * * * cd /path/to/zfaka && php cli.php crontab/sendemail

部署方式

Docker 快速部署（推荐）

感谢佰阅部落提供的 Docker 版本：

# 使用 Docker Compose 部署
docker run -d \
  --name zfaka \
  -p 8080:80 \
  -v /path/to/data:/data \
  baiyuetribe/zfaka

后台安全增强

建议操作：

1. 修改默认后台路径
2. 启用后台登录验证码
3. 配置 IP 白名单
4. 定期更换管理员密码
5. 启用 HTTPS 访问

系统升级

升级步骤：

1. 备份数据库和配置文件
2. 下载最新版本代码
3. 替换除 conf/application.ini 外的所有文件
4. 访问后台执行数据库升级
5. 清理缓存目录 /temp

常见问题

Q: 安装时提示 YAF 扩展未安装？ A: 请确认已安装 YAF 扩展并在 php.ini 中设置 yaf.use_namespace=1

Q: 访问首页显示 404？ A: 请检查 Nginx 配置中 root 路径是否指向 public 目录，以及 rewrite 规则是否正确

Q: 支付回调失败？ A: 请确保服务器能正常访问外网，并检查支付接口配置中的回调地址是否正确

同类项目对比

总结

ZFAKA 是一款适合个人和小型企业使用的开源发卡系统，具有部署简单、功能实用、安全可靠的特点。虽然界面美观度不如一些商业方案，但对于追求简洁实用的用户来说是一个不错的选择。

适用场景：

• 个人开发者销售软件授权码
• 小型电商销售虚拟商品
• 在线教育销售课程激活码
• 游戏代售点卡等虚拟物品

项目链接：

• Gitee 镜像：https://gitee.com/yunlovely/zfaka
• 官方演示：https://faka.zlkb.net/
• 技术交流 QQ 群：701035212