v3.8 升级指南

此版本包含多个 BREAKING CHANGES，建议在升级前仔细阅读以下内容。

重点检查

运行环境

• 确认 PHP 版本 >= 8.2，否则无法安装此版本

简单使用者

• 检查是否有使用微信 MchTransfer 相关插件，命名空间已变更为 Transfer
• v3.8.0-beta.2 起新增微信小程序虚拟支付支持，如需使用请在 wechat.default 配置中增加 virtual_pay 节点（offer_id、app_key、callback_token 等）

自有插件开发者

• 检查是否有自行扩展相关插件，如果有，请对照 breaking changes 检查是否需要更改
• 所有 Plugin 已迁移使用 Trait 方法代替 Functions.php 函数调用
• v3.8.0-beta.3 起所有 Provider 的 _url payload 字段统一为前导 / 格式，各 Provider 的 base URL 常量已去掉尾部 /。如自定义插件中设置了 _url 字段，请遵循前导 / 约定（例如 /v3/pay/transactions/native 而非 v3/pay/transactions/native）

更改版本号

将 composer.json 的 yansongda/pay 版本号更改为 ~3.8.0，随后 composer update 即可。

BREAKING CHANGES

• change: 最低 PHP 版本要求从 8.0 升级到 8.2 (#1139)
• delete: 移除废弃函数 get_alipay_config、get_wechat_config、get_unipay_config，请使用 get_provider_config 代替 (#1139)
• delete: 移除废弃的 Wechat\StartPlugin，请使用 Yansongda\Artful\Plugin\StartPlugin 代替 (#1139)
• delete: 移除废弃的微信 Transfer 插件（因微信支付 API 变更）(#1139)
• change: 重命名 MchTransfer 命名空间为 Transfer (#1139)
• delete: 删除 src/Functions.php 文件，所有辅助函数已迁移到对应的 Trait (#1142, #1143, #1144)