epay 部署仓库

彩虹易支付(88531 聚合支付平台,pay.88531.cn)的 Docker 部署配置、补丁与支付插件。

目录结构

docker-compose.prod.yml   生产编排(nginx / php / mysql / cron)
docker/                   nginx.conf、php-custom.ini
patches/                  补丁文件(挂载到容器 staging,镜像升级自动同步)
plugins/                  支付插件源码
.env                      环境变量(不入库)

本次修改内容

1. 测试支付页空白修复(patches/test.php)

/user/test.php 由 React 渲染,服务端 paytype 数组键从商户渠道 ID 开始(非 0 起), json_encode 输出为对象 {"1":{...}},前端 .map 调用抛错导致整页白屏。 修复:array_values() 重排索引,输出为 JSON 数组。

2. 后台通道名称乱码修复(数据库)

历史数据导入时 UTF-8 被按 cp1252 二次编码,pay_channel.name、pay_user.username 等字段存的是乱码(如 支付...)。MySQL 的 latin1 即 cp1252,用以下方式还原:

UPDATE pay_channel
SET name = CONVERT(CAST(CONVERT(name USING latin1) AS BINARY) USING utf8mb4)
WHERE name NOT REGEXP '[一-龥]'
  AND CONVERT(CAST(CONVERT(name USING latin1) AS BINARY) USING utf8mb4) REGEXP '[一-龥]';

已修复:pay_channel.name(支付宝官方 / 微信官方支付)、 pay_user.username(New API 接入商户 / CardAuth 接入商户)。 已扫描全库其余文本列,无同类问题。

3. 后台 UI 全屏化(patches/epay-ui.js + patches/epay-ui.css)

  • 去掉页面容器宽度限制:直接从构建产物 JS 中移除 9 处 max-w-[1440px] 及 9 处 max-w-3xl / 4xl / 5xl / [1200px] 页面级容器类 (系统设置、通道密钥、TOTP、批量结算等页原本右侧留白)
  • CSS 末尾追加覆盖规则兜底(.max-w-\[1440px\]{max-width:none} 等)
  • 结果:顶栏、侧栏、内容区铺满整个浏览器窗口,宽屏自适应

4. 后台侧栏优化(patches/epay-ui.js + patches/epay-ui.css)

  • 侧栏宽度 256px → 320px
  • 导航菜单一行 2 个(分组标题独占整行,超长文字省略号,隐藏右侧箭头)
  • 脚本自动把当前页面对应的菜单(aria-current="page")滚动到侧栏可视区中间, 解决菜单多时点击后"回到顶部找不到当前项"的问题
  • 移动端抽屉菜单保持单列

5. 缓存与版本策略

  • docker/nginx.conf:/assets/dist/epay-ui.css|js 设为 no-cache,改版及时生效
  • patches/head.php:后台资源链接带 ?v= 版本号,绕过浏览器与前置反代缓存 (升级补丁后修改此版本号即可强制全端更新)

6. 补丁持久化机制

补丁文件放在 patches/,由 docker-compose.prod.yml 挂载到 /var/www/html-staging/ 对应路径,容器启动时 entrypoint 将 staging 同步到工作目录, 镜像升级/容器重建后补丁不丢失。当前挂载:

补丁 目标路径
patches/functions.php includes/functions.php(is_public_url 白名单)
patches/epay-ui.css assets/dist/epay-ui.css
patches/epay-ui.js assets/dist/epay-ui.js
patches/head.php admin/head.php
patches/test.php user/test.php

日常维护

  • 修改补丁:改 patches/ 下对应文件 → 同步进容器(docker cp)→ 更新 head.php 的 ?v= → 提交推送
  • 容器重建:docker compose -f docker-compose.prod.yml up -d
  • .env 含数据库/管理员密码等敏感信息,禁止提交
S
Description
epay 部署配置与补丁
Readme
618 KiB
0 Stars 1 Watchers 0 Forks
Latest
2026-11-02 16:00:04 +08:00
Languages
PHP 98.9%
Hack 1.1%