Pay

Rocket 概况

yansongda/pay 将 输入参数、请求、原始响应、最终响应 抽象成了一种类型 Rocket， 在 Pay 项目中，所有的数据扭转都是通过 Rocket 来实现的。

Rocket 也是由不同的属性组成的，现一一道来

📡 Radar

可以理解为是 🚀 的 雷达，负责导航使用。

该属性，实际上最终为一个 \Psr\Http\Message\RequestInterface 对象， 具体到项目，默认情况下，就是 \Yansongda\Pay\Request。

所有需要请求支付供应商 API 的方法，最终都会使用这个 📡 ，去调用 http 接口请求支付供应商的 API。

🛠 Params

该属性为 array，实际存储的就是输入的所有参数。

例如 查询退款 中的

[
    'out_trade_no' => '1514027114',
    'out_request_no' => '1514027114',
    '_type' => 'refund',
];

Pay 项目中，将所有以 下划线 开始的参数都定义为 特殊参数，此类参数 一定不会在 payload 中出现， 仅会用于特殊参数判断。

⚙️ Payload

该属性类型为 \Yansongda\Supports\Collection，是 🚀 的 有效载荷， 实际存储的是所有需要请求给支付供应商的所有参数。

WARNING

注意，payload 和 params 是不一样的，params 存储的是原封不动的输入参数，payload 是经过一系列插件 "过滤" 后的 有效载荷。

🗝 Direction

🚀 的方向。

实际的作用为：把控最终请求需要解包的类型

例如，支付宝电脑支付中，其最终返回的是一个 Response 对象，不需要直接后端 http 请求支付宝接口的， 所以当使用支付宝电脑支付时，其 Direction 为 Yansongda\Pay\Parser\ResponseParser::class。

绝大多数情况下，均默认为：Yansongda\Pay\Parser\CollectionParser::class

🌟 ️Destination

🚀 的目的地。

实际作用为：最终返回的类

Destination 和 Direction 密切相关。 Direction 直接决定这 Destination 的值和类型。

  • 当 Direction 为 CollectionParser 时

    Destination 最终返回的是 Collection 对象

  • 当 Direction 为 ResponseParser 时

    Destination 最终返回的是 Response 对象

  • 当 Direction 为 ArrayParser 时

    Destination 最终返回的是 array 数组

  • 当 Direction 为 JsonParser 时

    Destination 最终返回的是 string

  • 当 Direction 为 NoHttpRequestParser 时

    Destination 最终返回的是 原样的 Radar

  • 当 Direction 为 OriginResponseParser 时

    Destination 最终返回的是 Rocket 中的 DestinationOrigin

✨ DestinationOrigin

🚀 的原始目的地。

实际作用为：当请求支付供应商的 http 接口后的原始 Response