- docker-compose.prod.yml:挂载 epay-ui.css/js/head.php 补丁到 staging(镜像升级不丢) - docker/nginx.conf:补丁静态资源 no-cache,改版立即生效 - patches/: - test.php 修复 paytype JSON 对象导致测试支付页空白 - epay-ui.css 后台全屏/侧栏加宽/导航两列布局覆盖 - epay-ui.js 去除页面容器宽度限制 + 侧栏当前菜单自动滚动 - head.php 资源 ?v= 版本号强制回源 - functions.php is_public_url 白名单等既有补丁 - plugins/ 支付插件源码 - .gitignore 排除 .env 等敏感与临时文件
4.0 KiB
4.0 KiB
plugins/ — Payment Channel Plugins
OVERVIEW
65 payment channel plugins. Each plugin is a self-contained directory with a class file following strict naming conventions. Plugins are dynamically discovered by \lib\Plugin::loadForSubmit() and \lib\Plugin::loadForPay(). No registry or DB — directory presence is activation.
STRUCTURE
plugins/
├── {plugin_name}/ # Plugin directory (e.g. alipay, wxpay, stripe, douyinpay)
│ ├── {plugin_name}_plugin.php # REQUIRED: Plugin class (e.g. alipay_plugin.php)
│ └── inc/
│ └── config.php # OPTIONAL: Channel-specific config
├── alipay/ # 支付宝 (native)
├── alipaycode/ # 支付宝当面付
├── alipayd/ # 支付宝当面付 (daifu)
├── alipayg/ # 支付宝国际
├── alipayhk/ # 支付宝香港
├── wxpay/ # 微信支付 (official)
├── wxpayn/ # 微信支付 (non-official, NPD)
├── wxpaysl/ # 微信支付 (扫呗)
├── wxpayng/ # 微信支付 (non-official, NG)
├── wxpaynp/ # 微信支付 (non-official, NP)
├── qqpay/ # QQ钱包
├── unionpay/ # 银联支付
├── stripe/ # Stripe (international)
├── paypal/ # PayPal
├── douyinpay/ # 抖音支付
├── jdpay/ # 京东支付
├── bepusdt/ # USDT (TRC20)
├── xorpay/ # XOR支付
├── epay/ / epayn/ # 彩虹易支付(中转代理)
├── jeepay/ # Jeepay聚合支付
└── ... # 65 total
PLUGIN CONVENTION
Each plugin must follow this pattern:
File: plugins/{name}/{name}_plugin.php
Class: {name}_plugin (lowercase, underscore suffix)
Optional config: plugins/{name}/inc/config.php
Plugin lifecycle hooks (methods the class should implement):
submit()— Called byloadForSubmit: returns payment page contentpay()— Called byloadForPay: handles payment page displaycallback()— Called on payment gateway callback (async notify)return()— Called on payment gateway return (sync redirect)settle()— Called for settlement/transfer processingcron()— Called bycron.phpfor scheduled tasks
Plugin class is loaded via:
\lib\Plugin::loadForSubmit($channel_type) // step 1: submit order
\lib\Plugin::loadForPay($plugin_id) // step 2: display payment page
\lib\Plugin::loadForSettle($channel_type) // settlement
WHERE TO LOOK
| Task | Location |
|---|---|
| Plugin loader logic | includes/lib/Plugin.php |
| Channel type definitions | includes/lib/Channel.php |
| Plugin config in DB | pre_channel table |
| Payment page fragments | includes/pages/ |
| Example plugin structure | plugins/alipay/ or plugins/epay/ |
CONVENTIONS
- Directory name = plugin name:
plugins/alipay/→ classalipay_plugin - One class per plugin: All logic in
{name}_plugin.php, no subclasses outside this file - Config in
inc/config.php: Channel-specific settings (app ID, secret, gateway URL) — returns PHP array - Payment return/callback: Two URLs — sync return (
return_url) and async notify (notify_url) - Error handling: Use
\lib\Paymenthelper methods, throw\Exceptionon failure - Logging: Write to DB via
$DB, notify via\lib\MsgNotice - No Composer autoloading for plugins: Plugin classes are
required directly byPlugin.php
ANTI-PATTERNS
- DON'T modify
Plugin.phpfor a single channel: Plugin loader is generic. Channel-specific logic goes in the plugin class. - DON'T create subclasses outside
{name}_plugin.php: Keep each plugin self-contained in one file. - DON'T hardcode plugin paths: Always use
PLUGIN_ROOTconstant. - DON'T commit API keys/secrets: Use DB-stored config values, not hardcoded in plugin files.
- DON'T mix plugin and core code: Plugin files should only be loaded via
Plugin.php, neverincluded directly by core.