pre_http_request是wordpress中的一个过滤钩子（filter hook），它允许开发者在wordpress执行任何HTTP请求之前拦截这个请求。这个钩子特别有用于修改请求参数、阻止请求的执行或者wordpress插件缓存请求结果等场景。

使用场景

• 修改请求参数：在请求发送之前修改或添加请求头、请求体等。
• 阻止请求：基于特定条件判断是否阻止请求的发送。
• 请求缓存：检查请求的缓存版本是否存在，如果存在则返回缓存数据而不是发起新的请求。

钩子参数

pre_http_request钩子函数可以接收三个参数：

1. $preempt：默认为false。如果在钩子函数中返回非false的值，那么这个返回值将会被用作请求的结果，而实际的HTTP请求将不会被执行。这允许开发者基于缓存或其他逻辑条件阻止请求的发出。
2. $r：包含即将发送的HTTP请求的所有参数的数组。这包括了method（请求方法）、timeout（超时时间）、redirection（重定向次数）、httpversion（HTTP版本）、user-agent（用户代理字符串）、reject_unsafe_urls（是否拒绝不安全的URL）、blocking（是否阻塞）、headers（请求头）、body（请求体）、cookies（请求中的cookie）等。
3. $url：即将被请求的URL。

示例代码

下面是一个使用pre_http_request钩子的示例，该示例演示了如何在发送请求之前修改请求参数：

add_filter('pre_http_request', 'my_custom_pre_http_request', 10, 3);

function my_custom_pre_http_request($preempt, $r, $url) {
    //检查URL是否符合特定条件  if (strpos($url, 'example.com') !== false) {
        //修改请求参数      $r['user-agent'] = 'My Custom User Agent';
    }
    //返回false以继续执行原始请求  return false;
}

在这个例子中，如果请求的URL包含example.com，则修改请求的user-agent。注意，函数最后返回false，这意味着原始的HTTP请求将继续执行。如果你想阻止请求并返回自定义响应，你可以返回一个非false的值，比如一个使用wp_remote_retrieve_body()函数能处理的响应数组。

注意事项

• 使用pre_http_request钩子时，确保返回值的处理逻辑正确。返回非false值将阻止实际的HTTP请求。
• 修改请求参数时要小心，以免引入安全问题或意外的行为。