柠檬剧场 · PHP 单体架构优化分析报告

基于静态代码分析的渐进式优化方案 — 不改架构,先治代码
📅 2026-07-08 📦 FastAdmin / ThinkPHP 5 🔍 静态代码分析 📁 app.zgddj.com

1 代码健康度数据画像

448
行注释掉的代码 (仅api/controller)
318
处直接 Db::name() 调用
5
处硬编码密钥/AppSecret
3
处硬编码用户伪造数据
30+
处 config('site') 散落调用
15
处原始 curl/file_get_contents
3
份几乎重复的 User 控制器
1,991
行 最大单文件 (User.php)

1.1 代码规模热力图

文件行数问题等级主要问题
api/controller/User.php1,991严重上帝控制器:登录/注册/提现/签到/分享/支付/绑定全部在一个文件
api/controller/Pay.php1,339严重支付宝+微信+虚拟支付+回调+佣金结算全耦合
api/controller/Video.php1,623警告视频管理+媒体上传+分享+微信短剧媒资混合
common/service/UserService.php1,522严重登录逻辑多项重复 (3套 login/mobileLogin/wxAuthLogin)
api/controller/Adspk.php1,205警告含腾讯广告 API secret 硬编码
admin/controller/user/User.php~600警告与 User1.php / User2.php 大量重复

2 安全类问题 (必须立即修复)

2.1 🔴 密钥硬编码

位置泄露内容风险
api/controller/User.php:1835微信小程序 AppID + AppSecret 明文严重 可伪造小程序登录
api/controller/Paywx.php:239微信小程序 AppID 明文高 泄露应用标识
api/controller/Adspk.php:423腾讯广告 API Secret 明文严重 可操作广告账户
api/controller/Ems.php:32短信接口密码通过 URL 明文传输高 中间人攻击风险
修复方案:所有密钥迁移到 .env 或配置中心。当前 .env 已存放数据库密码,应扩展:
WX_APPID=wxa7b05ba6352e2d8d
WX_APPSECRET=xxx
ADNET_SECRET=xxx
代码中改为 env('WX_APPID') 读取。

2.2 🔴 密码明文日志

User.php:742 — 忘记密码接口将手机号、新密码、验证码完整写入日志:

Log::write($mobile.'|'.$password.'|'.$captcha,'warning');

任何人可读取日志文件获取用户明文密码。

2.3 🔴 生产环境硬编码伪造数据

User.php:107-131 — children() 方法中为 3 个特定 invite 码硬编码了伪造的财务数据:

if($user['invite'] == '10002465'){
    $data['tixianToday'] = '-64.00';
    $data['childMoney'] = '2574.00';
    $data['tixianAll'] = '-2860.00';
    // ...
}

这是典型的"演示/测试数据泄漏到生产环境"。应立即清理,改为通过配置或管理后台控制。

2.4 🟡 SQL 注入风险点

虽然 ThinkPHP 的查询构造器有一定防护,但以下模式存在风险:

  • 直接在 where() 中使用未经校验的 input() 值
  • Db::execute() 拼接用户输入的原生 SQL (UserService.php GapClosing 方法)
  • 建议统一使用 Request::only() + 验证器白名单过滤

3 代码质量问题

3.1 注释掉的代码堆积

仅 api/controller/ 目录就有 448 行 注释掉的代码,典型如:

  • Adspk.php:701-707 — 整段事务代码被注释
  • UserLocation.php:218-269 — 大段设备ID逻辑被注释
  • pay1.php:28-92 — 支付事务被整段注释掉
建议:全面清理注释代码。如需保留历史,依赖 Git 版本历史而非代码注释。

3.2 控制器重复 (User.php / User1.php / User2.php)

admin/controller/user/ 目录下存在 3 个几乎相同的 User 控制器,每个约 600 行,大量代码复制粘贴。同样的 dayCountQuery、pennyCoinQuery 聚合查询在三个文件中重复出现。

建议:抽取公共 trait 或 Service 层,三个控制器只保留差异化逻辑。

3.3 新旧代码并存

旧文件新文件状态
pay1.php (旧支付控制器)Pay.php (新支付控制器)两个都在使用
EmsBak.php (短信备份)Ems.php备份文件残留
Pno.php (有 testNotify 测试方法)—测试代码在生产控制器中

3.4 命名混乱

  • Advertisingguration.php — 拼写错误 (应为 AdvertisingConfiguration)
  • TrumpetsSarvice.php — 拼写错误 (应为 TrumpetsService)
  • 中英文混用变量名:$datavideo_order, $datapost, $usersa
  • 方法名中英文混用:videopay(), czpay() (充值拼音缩写), qdmoney() (签到拼音)
  • 不一致的命名风格:Videorecord vs VideoRecord, Videolove vs VideoLove

3.5 Ipaddr.php 正则 Bug

common/library/Ipaddr.php:18 中的管道符使用了全角字符:

if (!preg_match ("/^(10│172.16│192.168)./i", $ips[$i])) {

│ (U+2502 BOX DRAWINGS LIGHT VERTICAL) 应改为 | (U+007C)。导致私有 IP 段过滤失效。

4 性能优化

4.1 N+1 查询模式

在 admin/controller/user/User.php、User1.php、User2.php 中发现典型的 N+1 模式:

// 先查用户列表
$users = Db::name('user')->select();
// 再逐用户查统计数据
foreach($users as $user) {
    $stats = Db::name('money_log')->where('user_id', $user['id'])->sum('money');
}
优化:使用 JOIN + GROUP BY 一次查询完成,或用 Redis 缓存聚合结果。

4.2 SELECT * 滥用

Service 层大量使用 field('*')(AgreementService、UserService、BannerService、AdLogService、PaylogService、LogDownService 等),不限制返回字段:

  • 用户表含大量字段 (password、salt、idcard 等敏感及大字段)
  • 每次查询都传输不需要的列,浪费内存和网络

4.3 缓存策略缺失

  • config('site') 每次请求都重新读取完整配置数组,没有本地缓存
  • 视频列表、分类、Banner 等高频读取数据无缓存层
  • 金币排行榜 (getCoinRank()) 每次实时查询 TOP 50 并计算排名
  • 签到状态 (qdjl) 每次查 DB,应优先用 Redis
建议:config('site') 改用 ThinkPHP 的 Cache::remember() 包装。热点数据统一加缓存层。

4.4 外部 HTTP 调用无超时/重试

15 处 curl_init()/file_get_contents(http://) 调用中:

  • 部分 curl 设置了超时 (CURLOPT_CONNECTTIMEOUT, 10),部分完全没有
  • 无一实现重试/降级逻辑
  • 微信 API、支付宝 API、短信接口等关键调用失败时直接抛异常

4.5 Redis 连接未池化

linkRedis(7) 每次调用创建新连接。高频场景下 (如风控 VolcService) 应使用连接池或单例。

5 架构层面优化

5.1 控制器瘦身 (分层改造)

当前控制器平均 800+ 行,User.php 达 1,991 行。目标模型:

层职责当前状态目标
Controller参数校验、调用 Service、返回响应✅ 杂糅大量业务逻辑≤ 200 行
Service业务逻辑编排、事务管理✅ 已有但不够纯粹无直接 DB 操作
Repository数据访问抽象❌ 不存在,直接用 DB::name新增
ModelORM 映射 + 基础存取✅ 但太薄加 scope 和 accessor

5.2 Repository 模式引入

当前 318 处 Db::name('table') 调用散落各处,表名硬编码,切换数据源或加缓存极其困难。

// 改造前 (当前)
$user = Db::name('user')->where('id', $uid)->find();
$money = Db::name('money_log')->where('user_id', $uid)->sum('money');

// 改造后 (建议)
$user = app(UserRepository::class)->findById($uid);
$money = app(MoneyLogRepository::class)->sumByUser($uid);
// Repository 内部统一加缓存、统一表前缀、统一字段过滤

5.3 Service 层接口化

当前 Service 类直接实例化 Model,无法替换实现,无法单元测试:

class UserService extends BaseService {
    public function __construct() {
        $this->model = new User();  // 硬依赖
    }
}

改为依赖注入接口:

class UserService {
    public function __construct(UserRepositoryInterface $repo) {
        $this->repo = $repo;
    }
}

5.4 统一配置管理

当前配置分散在三处:

  • .env — 数据库、Redis
  • extra/site.php — 业务配置 (网站名、支付参数、功能开关)
  • addons/*/config.php — 插件独立配置

建议统一到 extra/ 下按域拆分,并通过 Config Facade 统一读取。引入配置热更新 (基于 Redis 或 Nacos)。

5.5 统一的 API 响应格式

当前返回格式不一致:

  • 有些地方 $this->success('ok', $data)
  • 有些地方 return json($result)
  • 有些地方 echo 'success' (支付回调)
  • 有些地方 echo json_encode(['code' => false])

建议在 BaseController 中统一 ApiResponse 类,强制所有接口使用一致的 JSON 结构。

5.6 统一异常处理

当前 try-catch 模式混乱:有的捕获 Exception 后 $this->error($e->getMessage()) (泄露内部错误给前端),有的完全不捕获。建议:

  • 定义业务异常类 (BusinessException)
  • 使用 ThinkPHP 的 exception_handle 全局异常处理器
  • 生产环境不暴露内部错误消息

6 数据库与存储优化

🔍 索引审查
  • fa_money_log.user_id + createtime 联合索引 (children() 高频查询)
  • fa_user.invite 唯一索引 (登录/绑定邀请码)
  • fa_user.mobile 索引 (手机号登录)
  • fa_paylog.out_trade_no 索引 (支付回调查询)
🗄️ 读写分离

当前 database.php 中 deploy=0, rw_separate=false。阿里云 RDS 支持只读实例,改 deploy=1 即可启用主从分离,报表查询走从库。

📊 日志表归档

fa_money_log、fa_coin_log、fa_log_play 等流水表持续增长。建议按月分表或定期归档到 ClickHouse。

⚡ 慢查询监控

开启 MySQL slow_query_log,定期分析。当前无任何慢查询监控机制。重点关注聚合查询 (sum/money_log)。

7 登录模块专项优化

当前 UserService 中包含 7 套 不同的登录/注册逻辑,大量重复代码:

方法行数场景问题
register()~40手机号+验证码注册基础版
login()~60手机号验证码登录与 mobileLogin 逻辑 80% 重复
mobileLogin()~120新版手机号登录 (含风控)嵌入风控逻辑,臃肿
authLogin()~50一键登录与 mobileLogin 高度重复
mobileAuthLogin()~120新版一键登录 (含风控)基本是 mobileLogin 复制
wxAuthLogin()~130微信授权登录嵌入复杂上下级绑定逻辑
registerDefault()~80默认设备注册独立一套逻辑
优化方案:抽取 LoginStrategy 策略模式,每种登录方式一个策略类。风控逻辑通过事件/中间件注入,不嵌入业务代码。7 套逻辑合并为 1 套核心流程 + 7 个策略。

8 支付模块专项优化

Pay.php (1,339 行) 核心问题:

  1. 支付方式硬编码 if-else 链:payInfo() 方法中 if($payType==1)...elseif(2)...elseif(8),每增加支付方式需修改核心代码
  2. 回调处理耦合:serverNotice() 方法 180+ 行,同时处理虚拟支付回调、微信支付回调、媒资审核事件三种完全不同的事件
  3. 佣金结算散落:yongjin()、dailiyongjin()、retailerBrokerageSettlement() 分散在多个地方调用
优化方案:
1. 引入支付策略模式 — AlipayStrategy / WechatStrategy / BalanceStrategy / VirtualPayStrategy
2. 回调改为事件驱动 — Event::trigger('payment.success', $order),佣金/统计/通知各自监听
3. 支付通知幂等处理 — 基于 out_trade_no 加 Redis 分布式锁防重复回调

9 优化优先级矩阵

#优化项影响工作量优先级
1 密钥迁移到 .env (AppSecret/API Key) 安全 0.5天 P0 立即
2 删除密码明文日志 + 伪造数据 安全 0.5天 P0 立即
3 修复 Ipaddr.php 正则 Bug 安全 0.1天 P0 立即
4 清理 448 行注释掉的代码 + 废弃文件 可维护性 1天 P1 本周
5 统一 API 响应格式 规范 2天 P1 本周
6 合并 User.php / User1.php / User2.php 重复代码 可维护性 3天 P1 本周
7 SELECT * → 明确字段 + 核心表索引补充 性能 2天 P1 本周
8 config('site') 加缓存 + N+1 查询优化 性能 2天 P2 本月
9 HTTP 外部调用统一加超时/重试/降级 稳定性 2天 P2 本月
10 登录模块策略模式重构 (7→1) 可维护性 5天 P2 本月
11 支付模块策略模式 + 回调事件化 可维护性 5天 P2 本月
12 引入 Repository 层 + Service 接口化 架构 8天 P3 下季度
13 数据库读写分离 性能 2天 P3 下季度
14 统一异常处理 + 全局日志规范化 可靠性 3天 P3 下季度
15 日志表归档 / 分表 性能 3天 P3 下季度
总计:P0 项目 1 天内完成;P1 项目 1 周内完成;P2 项目 3 周内完成;P3 项目可安排在下个迭代周期。

10 推荐技术栈升级 (保持 PHP 生态)

组件当前建议收益
PHP 版本≥ 7.2PHP 8.1+JIT 编译器、枚举、match 表达式、readonly 属性、Fibers
框架ThinkPHP 5.xThinkPHP 8.x 或 Laravel 10中间件、容器、事件系统全面升级;TP5 已停止维护
队列think-queue (Redis)Laravel Horizon + Redis/RabbitMQ可视化管理、失败重试、延迟队列、优先级
缓存原生 RedisLaravel Cache / Symfony Cache标签缓存、自动序列化、多驱动切换
日志think\Log 写文件Monolog + ELK结构化日志、集中收集、全文检索
HTTP 客户端curl / file_get_contentsGuzzleHTTP连接池、重试、并发、中间件
测试无PHPUnit单元测试 + 集成测试覆盖核心业务
代码规范无PHP-CS-Fixer + PHPStan自动格式化、静态分析、类型检查
框架升级风险评估:ThinkPHP 5 → 8 有破坏性变更,但 FastAdmin 社区已提供升级方案。如果升级成本过高,至少将 PHP 升级到 8.1+ 以利用语言层面改进。

11 运维与部署优化

📦 依赖管理
当前 vendor.zip (18MB) 直接提交到仓库。改用 Composer.lock + CI 构建时 composer install,不提交 vendor 目录。
🔄 部署流程
当前为手动 rsync/覆盖部署。建议采用 Git 钩子 + 零停机部署 (符号链接切换 + php-fpm reload)。
📊 运行时监控
无 APM。建议接入阿里云 ARMS 或开源 SkyWalking PHP 探针,监控慢请求、错误率、外部调用耗时。
🛡️ OSS 防盗链
当前资源 URL 直接暴露 OSS 原始地址。应启用 OSS 防盗链 + CDN 鉴权,防止资源被盗用。
🧪 测试环境
当前无独立测试环境。建议Docker化部署,docker-compose up 一键启动完整测试环境。
📋 健康检查
无健康检查端点。建议添加 /health 端点,检查 DB/Redis/外部API连接状态。

12 总结

核心观点

当前 PHP 单体并非"不可救药"——代码已有 Service 层雏形,队列/缓存基础组件完备。主要问题是快速迭代中积累的技术债务,而非架构层面的根本性缺陷。

建议分三步走:

  1. 止血 (1 周内):密钥迁移、密码日志清理、正则 Bug 修复、注释代码清理
  2. 固本 (1 个月内):登录/支付策略模式重构、索引优化、统一响应格式、HTTP 客户端规范化
  3. 强身 (1 季度内):Repository 层引入、PHP 8.1+ 升级、读写分离、测试体系建立

这些优化完成后,代码的可维护性和性能将有显著提升,同时也为未来可能的微服务拆分打下坚实基础。

关键数据对比:
重构前:448 行注释代码 · 5 处密钥泄露 · 318 处分散 DB 调用 · 7 套登录重复逻辑
重构后 (目标):0 注释代码 · 0 密钥泄露 · 集中 Repository · 1 套登录核心 + 策略

报告生成: 2026-07-08 | 分析范围: /home/project/houtai/app.zgddj.com | 框架: FastAdmin (ThinkPHP 5)

基于静态代码分析。P0 项目请立即着手处理。