SaloonPHP 中 Connector 的 defaultBody() 方法使用解析

在 SaloonPHP 这个优秀的 PHP HTTP 客户端库中，Connector 和 Request 是两个核心概念。最近有开发者发现 Connector 似乎不支持 defaultBody() 方法，这实际上是一个需要澄清的技术点。

问题背景

当开发者需要向 API 发送 POST 请求时，有时会遇到 API 要求将认证密钥放在请求体而非请求头中的情况。这种情况下，开发者可能会尝试在 Connector 中使用 defaultBody() 方法来设置默认的请求体数据。

技术解析

实际上，SaloonPHP 的 Connector 是支持 defaultBody() 方法的，但需要满足以下条件：

1. Connector 必须使用与 Request 相同的 Body 相关 trait/interface
2. 请求体的类型必须是可合并的（如 JSON 格式）

解决方案

要让 Connector 的 defaultBody() 生效，开发者需要：

1. 在 Connector 和 Request 类中都添加相同的 Body 相关 trait（如 HasFormBody）
2. 确保请求方法正确设置为 POST
3. 在 Connector 中定义 defaultBody() 方法返回所需的默认数据

替代方案

如果上述方法不适用，开发者还可以通过 Connector 的 boot 方法手动设置请求体：

public function boot(PendingRequest $pendingRequest): void
{
    $connector = $pendingRequest->getConnector();
    $pendingRequest->setBody(new FormBodyRepository($connector->getCredentials()));
}

最佳实践

1. 对于需要共享默认请求体数据的场景，优先考虑在 Connector 中实现 defaultBody()
2. 确保 Connector 和 Request 使用相同的 Body 处理机制
3. 对于特殊需求，灵活使用 boot 方法进行定制

通过正确理解和使用这些特性，开发者可以更高效地构建基于 SaloonPHP 的 API 集成代码。