Yii适合对接第三方接口但不提供开箱即用封装，需手动处理请求构造、JSON编码、Bearer Token头、URL拼接、响应解析及精准状态判断。
Yii 适合对接第三方接口，但不提供开箱即用的封装——它把 HTTP 客户端能力交给你控制，而不是替你做决策。是否“好用”，取决于你是否清楚关键细节：请求构造、数据编码、响应解析、限频缓存、错误判定。
HTTP 请求必须手动构造，HttpClient 不是万能胶
Yii 的 yii\httpclient\Client 是轻量级封装，不是 Guzzle 全功能替代：
- GET 请求要自己调
$response->getContent()再json_decode()，不能直接拿到数组 - POST 发 JSON 必须显式设
->setFormat(Client::FORMAT_JSON)并加Content-Type: application/json头（某些版本不自动加） - 带 Bearer Token 要手动
->addHeaders(['Authorization' => 'Bearer ' . $token]) - URL 拼接容易出错：baseUrl 是
https://api.x.com/v1，路径写users就变.../v1users，必须写/users
签名、编码、时间戳这些细节决定成败
对接短信、微信、支付等平台时，框架不管业务规则，只管发请求：
- 中文内容必须
urlencode()，否则 MD5 签名值错，平台直接拒收 - 时间戳字段（如
time）需与服务器时间误差 ≤ 5 分钟，否则签名失效 - 微信验证 signature 时，
[$token, $timestamp, $nonce]排序必须用sort($arr, SORT_STRING)，PHP 7.4+ 下 locale 不同会导致结果不一致 - 别用
file_get_contents('xxx')拼 URL 发 GET 请求，这是高危操作，应统一走 HttpClient
状态判断不能靠模糊匹配
很多项目“看着成功”实则失败，因为没认真看返回体：
- 短信平台返回
{"code":0,"msg":"success"}，但另一家可能是{"status":1}或{"result":false} - 不能写
strpos($result, 'success') !== false这类模糊判断 - 必须解析 JSON/XML 后，精准读取字段（如
$data['code'] === 0），并确认该字段在文档中确实代表“发送成功” - XML 接口要用
file_get_contents('php://input')取原始流，$_POST永远为空
限频和验证码必须用共享缓存
别依赖 session 做频率控制，它在负载均衡或微服务下立即失效：
- 手机号维度限频：缓存键
sms:freq:138****1234，TTL 设 60 秒 - IP 维度限频：键
sms:ip:123.123.123.123，TTL 设 3600 秒 - 验证码本体必须存 cache，键
sms:code:138****1234，TTL 严格为 300 秒，且读取后立刻delete - 推荐用 Redis 或 Memcached，避免文件缓存跨机器不同步
