每次你的代码访问外部 API 时，都会引入一个你无法控制的故障点。无论你是获取社交动态、天气小部件，还是处理支付，你的网站性能现在都与第三方紧密相关。
一个常见的错误是将远程请求视为本地数据库查询。如果外部服务器缓慢，你的网站也会变慢。如果外部服务器宕机，你的网站可能会崩溃或无限期挂起。专业的 WordPress® 开发需要一种防御性架构来预判这些故障。通过正确使用 WordPress HTTP API，你可以保护你的网站免受外部不稳定因素的影响。
超越基础：wp_remote_get() 的内部结构
函数 wp_remote_get() 和 wp_remote_post() 是 WP_Http 类的高级封装。它们提供了一种标准化的请求方式，无需担心服务器使用的是 cURL 还是临时流。
当你发出请求时，WordPress 会返回一个响应对象。这个对象是一个关联数组，包含几个关键数据：
- headers：包含来自外部服务器的响应头。
- body：这是实际的有效载荷，通常是 JSON 字符串或 XML。
- response：包含 HTTP 响应代码，例如 200 表示成功，404 表示未找到。
- cookies：目标服务器返回的任何 cookies 都存储在这里。
防御性编程：处理失败状态
一个健壮的集成必须考虑到事情会出错。你永远不应该假设你请求的数据确实存在。
首先，你必须检查 WP_Error。如果请求由于 DNS 问题或连接超时而未能到达服务器，就会发生这种情况。一定要用 is_wp_error() 检查来包装你的请求。
其次，你必须验证 HTTP 响应代码。一个请求在技术上可能成功，但仍然返回 500 Internal Server Error。使用 wp_remote_retrieve_response_code() 来确保你收到的是 200 OK 然后再继续。
最后，验证 body。如果你期望 JSON，使用 json_decode() 并检查结果数据结构是否符合你的预期。尝试遍历 null 或空对象是导致致命错误的常见原因。
性能调优和策略性超时
WordPress 远程请求的默认超时是 5 秒。在前端用户体验中，5 秒是一段漫长的时间。如果 API 需要这么长时间响应，用户很可能已经离开了页面。
你应该使用 'timeout' 参数来快速失败。如果一个非必要的天气 API 在 1.5 秒内没有响应，显示默认图标通常比让用户等待更好。
对于不需要实时发生的重型请求，考虑将它们移到后台进程。使用 WP-Cron 可以在不强制访问者等待外部服务器响应的情况下获取数据。
缓存结果
这是 HTTP API 与我们之前深入探讨的 WordPress Transient 的艺术 的连接点。你几乎不应该在每次页面加载时都发起远程请求。相反，你应该实现一个缓存工作流。
这个过程首先检查对象缓存中是否存在有效的 transient。如果数据丢失或已过期，你才执行远程请求。如果请求成功，你就将结果存储在对象缓存中，设置一个持续时间。
在像 WP Engine 这样的平台上，启用对象缓存可以确保数据库和 API 结果存储在 RAM 中以便即时检索。这可以防止您的网站因发出过多重复请求而被外部 API 屏蔽。虽然系统主要提供新鲜数据，但您也可以使用 Transients API 作为后备方案，在远程服务暂时不可用时提供缓存结果。
结论
一个可靠的远程请求知道如何优雅地失败。通过将 WordPress HTTP API 与智能错误处理和持久对象缓存相结合，您可以在您的网站和外部服务器不可预测的特性之间创建一个缓冲层。这种架构确保您的网站保持快速和稳定，无论网络上发生什么。
