CardSystem

安装文档   更新文档

介绍

一款高效安全的发卡平台。

支持的支付渠道

• 支付宝（电脑支付/手机支付/当面付/V2版即时到账/V4版高级手机网站支付）
• 微信支付（扫码支付/H5支付/JSAPI支付）
• QQ钱包
• 易支付
• CoinPayments（支持上千种数字货币）
• Blockchain.com（BTC）
• MugglePay
• PayPal
• 付呗
• 有赞支付
• 恒隆支付
• PayJS
• 黔贵金服
• 云创支付
• 码支付
• 即充宝/JCBPay
• 吉易支付/JIPAYS
• 思狐云支付/UigPay
• 幻兮支付
• ZFBJK支付宝免签约辅助
• ...

更多请参考 card-gateway

源码安装

环境：PHP 8.2+、Composer 2、MySQL 5.7+、Node.js 22+、npm、Git。 PHP 扩展要求见 composer.json。以下命令均在项目根目录执行。

git submodule update --init --recursive
composer install
npm ci
npm run build

复制 .env.example 为 .env，填写数据库配置后执行：

php artisan key:generate
php artisan jwt:secret
php artisan migrate --seed

网站入口设为 public。默认后台账号 [email protected]，密码 123456，请立即修改。

源码更新

先备份数据库和 .env，处理本地修改后执行：

git pull --ff-only
git submodule update --init --recursive
composer install --no-dev --optimize-autoloader
npm ci
npm run build
php artisan migrate --force
php artisan optimize:clear

更新时不要重新执行初始化种子。

开发与测试

在不同终端启动所需服务：

php artisan serve       # 后端：8000
npm run dev:admin       # 管理后台：8081
npm run dev:shop        # 商城：8080

API 默认代理至 http://127.0.0.1:8000，可通过对应前端目录 .env.local 中的 DEV_API_TARGET 修改。 单独编译前端使用 npm run build:admin 或 npm run build:shop。

测试前执行 composer install，并将 DB_* 配置指向名称以 _test 结尾的专用数据库：

composer test
composer test:aws        # 离线测试

构建发布包

需要 tar，并确保子模块已初始化、工作区及子模块无未提交修改。

composer build

输出：build/releases/card-system-3.21.tar.gz。

常见问题

以下命令均在网站根目录执行。

修改 .env 或网站设置后未生效

php artisan cache:clear
php artisan config:clear
php artisan route:clear

忘记后台密码

替换为后台账号和新密码：

php artisan reset:password [email protected] 'your-new-password'

出现 500 错误或未知错误

查看 storage/logs，按日志提示排查。分享日志前请隐去账号、密钥和个人信息。

开启后台登录验证码后无法登录

将 systems 表中 name = vcode_login_admin 的记录的 value 改为 0，然后清理缓存。

普通验证码请求返回 500

查看错误日志，检查 PHP 的 gd、fileinfo 等必要扩展是否启用。

许可证

MIT · 支付网关许可证