分析 WordPress `WP_HTTP` 类的源码：它是如何作为 HTTP 请求的抽象层，支持多种传输方式。

各位听众，大家好！我是今天的主讲人。今天咱们来聊聊WordPress里的一个重要角色：WP_HTTP类。别看它名字平平无奇，它可是WordPress处理HTTP请求的大管家，背后隐藏着不少巧妙的设计。咱们今天就扒一扒它的源码，看看它是怎么玩转各种HTTP传输方式的。

开场白：HTTP请求的那些事儿

在Web开发的世界里，HTTP请求简直是无处不在。你想加载一个网页，提交一个表单，或者更新一下你的社交媒体状态，都离不开HTTP请求。而WordPress作为一个内容管理系统，更是要频繁地和各种服务器打交道，比如更新主题、插件，或者获取远程数据。

但是，HTTP请求这玩意儿，说简单也简单，说复杂也复杂。不同的服务器环境，对HTTP请求的支持程度可能不一样。有的服务器可能只支持fsockopen，有的可能支持curl，有的可能用的是streams。如果WordPress每次都直接用这些底层函数来发送HTTP请求，那代码就太乱了，而且维护起来简直是噩梦。

所以，WordPress需要一个统一的抽象层，来屏蔽底层的差异，让开发者可以轻松地发送HTTP请求，而不用关心底层到底用的是什么技术。这个抽象层，就是WP_HTTP类。

WP_HTTP类：HTTP请求的瑞士军刀

WP_HTTP类就像一把瑞士军刀，它提供了各种工具，让你可以在WordPress里轻松地发送HTTP请求。它主要做了以下几件事：

1. 选择合适的传输方式： 根据服务器环境，自动选择最佳的HTTP传输方式。
2. 处理各种HTTP方法： 支持GET、POST、PUT、DELETE等各种HTTP方法。
3. 设置HTTP头： 可以自定义HTTP请求头，比如User-Agent、Content-Type等。
4. 处理HTTP响应： 可以解析HTTP响应头和响应体。
5. 处理Cookie： 可以管理HTTP Cookie。
6. 处理SSL： 支持SSL加密连接。
7. 错误处理： 提供统一的错误处理机制。

WP_HTTP源码剖析：让我们深入虎穴

咱们现在就来深入WP_HTTP类的源码，看看它到底是怎么实现的。

首先，我们来看看WP_HTTP类的构造函数：

<?php
class WP_HTTP {

    /**
     * Holds the value of the response headers.
     *
     * @since 2.7.0
     * @access public
     * @var array
     */
    public $headers = array();

    /**
     * Holds the value of the response cookies.
     *
     * @since 2.7.0
     * @access public
     * @var array
     */
    public $cookies = array();

    /**
     * Holds the value of the body of the response.
     *
     * @since 2.7.0
     * @access public
     * @var string
     */
    public $body = '';

    /**
     * Holds the value of the response code.
     *
     * @since 2.7.0
     * @access public
     * @var int
     */
    public $response = '';

    /**
     * Holds the value of the errors.
     *
     * @since 2.7.0
     * @access public
     * @var WP_Error
     */
    public $errors;

    /**
     * Constructor.
     *
     * @since 2.7.0
     */
    public function __construct() {
        $this->headers  = new WP_HTTP_Headers( array() );
        $this->cookies  = new WP_HTTP_Cookie();
        $this->errors   = new WP_Error();
    }
}

这个构造函数主要初始化了一些成员变量，比如$headers、$cookies和$errors。其中，$headers是一个WP_HTTP_Headers对象，用于存储HTTP响应头；$cookies是一个WP_HTTP_Cookie对象，用于管理HTTP Cookie；$errors是一个WP_Error对象，用于存储错误信息。

接下来，我们来看看request()方法，这是WP_HTTP类最核心的方法，用于发送HTTP请求：

<?php
    /**
     * Send a HTTP request
     *
     * @since 2.7.0
     *
     * @param string $url URL to retrieve.
     * @param string|array $args Optional. Array or string of arguments.
     * @return array Array containing 'headers', 'body', 'response', 'cookies', 'filename'.
     */
    public function request( $url, $args = array() ) {
        $defaults = array(
            'method'      => 'GET',
            'timeout'     => 5,
            'redirection' => 5,
            'httpversion' => '1.0',
            'user-agent'  => 'WordPress/' . get_bloginfo( 'version' ) . '; ' . get_bloginfo( 'url' ),
            'reject_unsafe_urls' => false,
            'blocking'    => true,
            'headers'     => array(),
            'body'        => null,
            'cookies'     => array(),
            'filename'    => null,
            'stream'      => false,
            'sslverify'   => true,
            'decompress'  => true,
            'sslcertificates' => null,
            'port' => null,
            'localaddress' => null
        );

        $args = wp_parse_args( $args, $defaults );

        $url = esc_url_raw( $url );

        $http_url = wp_http_validate_url( $url );
        if ( is_wp_error( $http_url ) ) {
            return $http_url;
        }

        $args['headers'] = $this->normalize_headers( $args['headers'] );

        $class = $this->get_preferred_transport( $args, $url );
        if ( false === $class ) {
            $this->errors->add( 'no_transport', __( 'No suitable transport found' ) );
            return new WP_Error( 'no_transport', __( 'No suitable transport found' ) );
        }

        $request = new $class();
        return $request->request( $url, $args );
    }

这个方法接收两个参数：$url是要请求的URL，$args是一个数组，包含了请求的各种选项，比如HTTP方法、超时时间、HTTP头等。

这个方法首先会对URL进行校验，然后对参数进行处理，接着会调用get_preferred_transport()方法来选择合适的HTTP传输方式。如果找到了合适的传输方式，就创建一个对应的对象，并调用其request()方法来发送HTTP请求。

选择合适的传输方式：get_preferred_transport()

get_preferred_transport()方法是WP_HTTP类的一个关键方法，它负责根据服务器环境，选择最佳的HTTP传输方式。

<?php
    /**
     * Retrieve the best transport available for the current environment.
     *
     * @since 3.2.0
     *
     * @param array  $capabilities Optional. Array of capabilities to test for.
     * @param string $url          Optional. The URL to test.
     * @return string|false Class name of the best transport, or false if none is available.
     */
    public function get_preferred_transport( $capabilities = array(), $url = '' ) {
        $transports = array( 'curl', 'streams', 'fsockopen' );

        /**
         * Filter the array of transports to use for HTTP requests.
         *
         * @since 2.7.0
         *
         * @param array $transports An array of transports to use. Default array
         *                          contains 'curl', 'streams', and 'fsockopen'.
         */
        $transports = apply_filters( 'http_api_transports', $transports );

        $test_url = ( ! empty( $url ) && ! preg_match( '/https?://([^/]*.)?example.com/i', $url ) );

        $selected_transport = false;
        foreach ( $transports as $transport ) {
            $class = 'WP_HTTP_' . $transport;

            // Check that the class exists
            if ( ! class_exists( $class ) ) {
                continue;
            }

            $is_available = call_user_func( array( $class, 'test' ), $capabilities, $url );

            if ( $is_available ) {
                $selected_transport = $class;
                break;
            }
        }

        return $selected_transport;
    }

这个方法首先定义了一个$transports数组，包含了三种HTTP传输方式：curl、streams和fsockopen。然后，它会遍历这个数组，依次调用每种传输方式的test()方法，来判断该传输方式是否可用。如果找到了可用的传输方式，就返回对应的类名。

各种HTTP传输方式的实现：WP_HTTP_Curl、WP_HTTP_Streams和WP_HTTP_Fsockopen

WP_HTTP类使用了策略模式，将不同的HTTP传输方式封装成不同的类。这三种传输方式分别对应于WP_HTTP_Curl、WP_HTTP_Streams和WP_HTTP_Fsockopen这三个类。

• WP_HTTP_Curl： 使用curl扩展来发送HTTP请求。curl是一个功能强大的HTTP客户端库，支持各种HTTP特性，比如Cookie、SSL、代理等。
• WP_HTTP_Streams： 使用PHP的streams函数来发送HTTP请求。streams是PHP提供的一种流式I/O机制，可以用于读取和写入各种数据流，包括HTTP数据流。
• WP_HTTP_Fsockopen： 使用PHP的fsockopen函数来发送HTTP请求。fsockopen是一个比较底层的函数，可以直接打开一个socket连接，并发送HTTP请求。

这三个类都实现了WP_HTTP_Transport接口（虽然接口定义可能并不显式存在，但设计思想是符合接口规范的）。它们都包含一个request()方法，用于发送HTTP请求。

HTTP传输方式的选择标准

get_preferred_transport()方法会根据以下标准来选择HTTP传输方式：

1. 是否支持curl扩展： 如果服务器支持curl扩展，并且curl扩展的版本足够高，那么WP_HTTP_Curl通常是首选的传输方式。
2. 是否支持streams函数： 如果服务器不支持curl扩展，但是支持streams函数，那么WP_HTTP_Streams是一个不错的选择。
3. 是否支持fsockopen函数： 如果服务器既不支持curl扩展，也不支持streams函数，那么WP_HTTP_Fsockopen是最后的选择。

代码示例：使用WP_HTTP类发送HTTP请求

下面是一个使用WP_HTTP类发送HTTP请求的代码示例：

<?php
$url = 'https://api.example.com/data';
$args = array(
    'method'  => 'GET',
    'timeout' => 10,
    'headers' => array(
        'Authorization' => 'Bearer YOUR_API_KEY',
    ),
);

$http = new WP_HTTP();
$response = $http->request( $url, $args );

if ( is_wp_error( $response ) ) {
    echo 'Error: ' . $response->get_error_message();
} else {
    echo 'Response Code: ' . $response['response']['code'] . "n";
    echo 'Response Body: ' . $response['body'] . "n";
}

这段代码首先创建了一个WP_HTTP对象，然后调用其request()方法来发送HTTP请求。request()方法的第一个参数是要请求的URL，第二个参数是一个数组，包含了请求的各种选项。

如果请求成功，request()方法会返回一个数组，包含了HTTP响应头、响应体、响应码等信息。如果请求失败，request()方法会返回一个WP_Error对象，包含了错误信息。

深度解析：WP_HTTP_Curl的内部实现

咱们再来深入了解一下WP_HTTP_Curl的内部实现。WP_HTTP_Curl类主要使用了PHP的curl_setopt()函数来设置curl选项，并使用curl_exec()函数来执行curl请求。

以下是WP_HTTP_Curl类request()方法的一些关键代码片段：

<?php
// ... (省略部分代码)

$ch = curl_init();

// 设置URL
curl_setopt( $ch, CURLOPT_URL, $url );

// 设置HTTP方法
switch ( $r['method'] ) {
    case 'POST':
        curl_setopt( $ch, CURLOPT_POST, true );
        break;
    case 'PUT':
        curl_setopt( $ch, CURLOPT_CUSTOMREQUEST, 'PUT' );
        break;
    case 'DELETE':
        curl_setopt( $ch, CURLOPT_CUSTOMREQUEST, 'DELETE' );
        break;
    case 'HEAD':
        curl_setopt( $ch, CURLOPT_NOBODY, true );
        break;
    default:
        curl_setopt( $ch, CURLOPT_HTTPGET, true );
        break;
}

// 设置HTTP头
$headers = array();
foreach ( $r['headers'] as $name => $value ) {
    $headers[] = $name . ': ' . $value;
}
curl_setopt( $ch, CURLOPT_HTTPHEADER, $headers );

// 设置请求体
if ( ! empty( $r['body'] ) ) {
    curl_setopt( $ch, CURLOPT_POSTFIELDS, $r['body'] );
}

// 设置超时时间
curl_setopt( $ch, CURLOPT_TIMEOUT, $r['timeout'] );

// 设置SSL验证
curl_setopt( $ch, CURLOPT_SSL_VERIFYPEER, $r['sslverify'] );

// ... (省略部分代码)

// 执行curl请求
$response = curl_exec( $ch );

// ... (省略部分代码)

curl_close( $ch );

这段代码展示了WP_HTTP_Curl类如何使用curl_setopt()函数来设置URL、HTTP方法、HTTP头、请求体、超时时间、SSL验证等选项，并使用curl_exec()函数来执行curl请求。

表格总结：WP_HTTP类的重要方法和属性

为了方便大家理解，我用一个表格来总结一下WP_HTTP类的重要方法和属性：

方法/属性	描述
$headers	存储HTTP响应头的数组。
$cookies	存储HTTP Cookie的数组。
$body	存储HTTP响应体的字符串。
$response	存储HTTP响应码的整数。
$errors	存储错误信息的WP_Error对象。
request( $url, $args )	发送HTTP请求的核心方法。接收URL和请求选项作为参数，返回包含HTTP响应信息的数组或WP_Error对象。
get_preferred_transport( $capabilities, $url )	根据服务器环境，选择最佳的HTTP传输方式。返回传输方式的类名。

WP_HTTP的优点和缺点

• 优点：

  • 抽象性： 屏蔽了底层HTTP传输方式的差异，提供了统一的API。
  • 灵活性： 可以根据服务器环境，自动选择最佳的HTTP传输方式。
  • 可扩展性： 可以通过过滤器来添加自定义的HTTP传输方式。

• 缺点：

  • 性能： 相比于直接使用底层函数，WP_HTTP类可能会有一些性能损耗。
  • 复杂性： WP_HTTP类的代码比较复杂，需要一定的学习成本。

最佳实践：使用WP_HTTP类的一些建议

• 尽量使用curl扩展： 如果服务器支持curl扩展，并且curl扩展的版本足够高，那么尽量使用curl扩展来发送HTTP请求。curl扩展的性能和功能都比较好。
• 设置合理的超时时间： 为了避免HTTP请求长时间阻塞，应该设置合理的超时时间。
• 处理错误： 在发送HTTP请求之后，一定要检查是否发生了错误，并进行相应的处理。
• 使用缓存： 对于一些不经常变化的数据，可以使用缓存来减少HTTP请求的次数。

总结：WP_HTTP类的重要性

WP_HTTP类是WordPress处理HTTP请求的重要组成部分。它提供了一个统一的抽象层，屏蔽了底层HTTP传输方式的差异，让开发者可以轻松地发送HTTP请求。理解WP_HTTP类的源码，可以帮助我们更好地理解WordPress的工作原理，并编写出更高效、更健壮的WordPress插件和主题。

结束语：HTTP请求的未来

随着Web技术的不断发展，HTTP请求也在不断演进。HTTP/2、HTTP/3等新协议的出现，为Web应用带来了更高的性能和更好的用户体验。作为WordPress开发者，我们需要不断学习新的HTTP技术，并将其应用到我们的项目中，才能更好地满足用户的需求。

今天的分享就到这里，谢谢大家的聆听！希望对你有所帮助。