PHP支付方式切换：策略模式实现动态选择

本文深入剖析了如何在PHP中通过策略模式优雅实现支付方式的动态切换，强调“加新支付方式仅需新增一个类文件”的极致解耦目标：通过统一PaymentStrategy接口规范方法签名（如pay、notify、refund的输入输出），确保所有策略行为一致；借助PaymentFactory严格校验类存在性与命名规范，杜绝运行时错误；控制器彻底剥离业务逻辑，仅负责参数传递与依赖注入，不触碰数据库或缓存；策略类专注签名、请求组装与响应解析，保持无状态；并细化异常类型（如InvalidParameterException、NetworkTimeoutException等），使错误可定位、可重试、可映射为精准HTTP状态码——整套设计让支付扩展零侵入、测试可mock、线上易排查，真正实现高内聚、低耦合的工业级支付架构。

定义 PaymentStrategy 接口必须统一方法签名

所有支付策略类必须实现同一接口，否则运行时调用会出错。比如 pay() 方法参数类型、返回值、是否抛异常，都得一致。常见翻车点是微信回调要 $data 数组，支付宝要 $notify_id 字符串，结果策略类各自为政，上下文一调就 fatal error。

正确做法是接口强制收窄输入输出：

• pay(array $params): array —— 统一接收关联数组（含 amount、order_no、return_url 等）
• notify(): array —— 统一返回标准化结构：['status' => 'success', 'order_no' => 'xxx']
• refund(array $params): bool —— 所有退款操作返回布尔值，不混用 string 或 exception

PaymentFactory::make() 必须校验类存在且命名规范

ThinkPHP 6+ 自动加载靠 PSR-4，路径和类名必须严格匹配。硬拼字符串 "AlipayStrategy" 而不检查类是否存在，线上一传 channel=bitcoin 就直接 Class not found。

工厂方法里这几行不能省：

• 用 ucfirst($channel) 转 PascalCase，再拼完整命名空间：app\common\strategy\payment\AlipayStrategy
• 调用前必须 class_exists('app\common\strategy\payment\AlipayStrategy')，不存在就 throw InvalidArgumentException("Unsupported payment channel: {$channel}")
• 禁止用 new $className()，要用 App::make($className, [$config]) 或手动 new 并传入依赖（如配置数组）

控制器里别在策略上调用 Db:: 或 Cache::

策略类不是服务类，它只负责“怎么付”，不负责“存哪”或“查谁”。有人在 AlipayStrategy::pay() 里直接写 Db::name('pay_log')->insert(...)，结果单元测试没法 mock 数据库，一跑就连真实库。

正确姿势是把依赖通过构造函数注入：

• 策略类构造函数接收 array $config 和可选的 LogInterface $logger
• 日志、缓存、数据库操作全交给控制器或专门的服务层处理
• 策略内部只做签名、组装请求、解析响应三件事，保持无状态

异常粒度要细，别用一个 try-catch 包全场

支付失败分很多种：参数错（400）、签名失败（401）、余额不足（402）、网络超时（504）。如果控制器里只写 try { $strategy->pay($params); } catch (\Exception $e) { return json(['msg' => '支付失败']); }，前端根本没法区分该重试还是该提示用户改参数。

建议策略内部按场景 throw 不同异常：

• InvalidParameterException → 返回 400
• SignatureVerifyException → 返回 401
• NetworkTimeoutException → 返回 504，前端自动重试
• 控制器 catch 后映射成对应 HTTP 状态码和 message

最易被忽略的是 notify 回调里的异常处理——这里没用户界面，但错误日志必须带原始 POST 内容和时间戳，否则排查三方平台回调失败时两眼一抹黑。

文中关于的知识介绍，希望对你的学习有所帮助！若是受益匪浅，那就动动鼠标收藏这篇《PHP支付方式切换：策略模式实现动态选择》文章吧，也可关注golang学习网公众号了解相关技术文章。