3.5 KiB
3.5 KiB
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含数据库/管理员密码等敏感信息,禁止提交