v3.6 升级指南
此版本对 SDK 的插件系统进行了大量的重构,主要是为了更好的扩展,减少使用及开发的心智。
重点检查
简单使用者
- 检查是否有使用
find
方法,如果有,请更改为query
方法 - 检查是否有使用
cancel
/close
方法,如果有,请注意参数是否为array
,如果不是,请更改为array
- 检查是否有使用
wap
方法,如果有,请更改为h5
- 检查是否有使用 微信合单支付,如果有,请注意配置是否正确
自有插件开发者
- 检查是否有自行扩展相关插件,如果有,请对照
breaking changes
检查是否需要更改
更改版本号
将 composer.json 的 yansongda/pay 版本号更改为 ~3.6.0
,随后 composer update
即可。
BREAKING CHANGES
- change: 查询API方法由
find
改为query
,同时参数只支持array
(#897) - change: cancel/close 的 API 参数只支持
array
,不再支持string
(#900, #901) - change: 微信合单支付去掉独立的
combine_app_id
,combine_mch_id
配置,复用其它配置(#909) - change: 手机网站支付快捷方式由
wap
改为h5
(#911, #915, #916) - change:
Pay
类对外方法由所改变,如果您有自行扩展相关插件,请检查(#926) - change(internal): 按场景对 支付宝/微信/银联 插件进行分类 && 插件代码优化(#894, #909, #913, #922)
- change(internal): 将 支付/微信/银联 shortcut 从 plugin 文件夹独立出来(#895, #904, #905)
- change(internal): shortcut 完整标明各个插件,不使用 commonPlugin(#886)
- change(internal): DirectionInterface 方法由
parse
改为guide
(#896) - change(internal): 错误代码 const 命名规则统一(#902, #903, #906, #909, #926)
- change(internal): 调整
ProviderInterface
的返回参数,增加了Rocket
返回(#909) - change(internal): 将
call()
方法重命名为shortcut()
(#914) - change(internal):
mergeCommonPlugins
不再作为AbstractProvider
的方法(#918) - change(internal):
AbstractProvider
默认使用HttpClientFactoryInterface
创建 http client(#921) - change(internal): 调整 银联 插件文件夹结构(#923)
- change(internal): 替换为
artful
API 请求框架(#926) - change(internal): 调整微信代金券插件文件结构(#928)