Http.php

Go to the documentation of this file.

<?php
use MediaWiki\Logger\LoggerFactory;
use MediaWiki\MediaWikiServices;
 
class Http {
    public static $httpEngine = null;
 
    public static function request( $method, $url, array $options = [], $caller = __METHOD__ ) {
        $ret = MediaWikiServices::getInstance()->getHttpRequestFactory()->request(
            $method, $url, $options, $caller );
        return is_string( $ret ) ? $ret : false;
    }
 
    public static function get( $url, array $options = [], $caller = __METHOD__ ) {
        $args = func_get_args();
        if ( isset( $args[1] ) && ( is_string( $args[1] ) || is_numeric( $args[1] ) ) ) {
            // Second was used to be the timeout
            // And third parameter used to be $options
            wfWarn( "Second parameter should not be a timeout.", 2 );
            $options = isset( $args[2] ) && is_array( $args[2] ) ?
                $args[2] : [];
            $options['timeout'] = $args[1];
            $caller = __METHOD__;
        }
        return self::request( 'GET', $url, $options, $caller );
    }
 
    public static function post( $url, array $options = [], $caller = __METHOD__ ) {
        return self::request( 'POST', $url, $options, $caller );
    }
 
    public static function userAgent() {
        return MediaWikiServices::getInstance()->getHttpRequestFactory()->getUserAgent();
    }
 
    public static function isValidURI( $uri ) {
        return MWHttpRequest::isValidURI( $uri );
    }
 
    public static function getProxy() {
        wfDeprecated( __METHOD__, '1.34' );
 
        global $wgHTTPProxy;
        return (string)$wgHTTPProxy;
    }
 
    public static function createMultiClient( array $options = [] ) {
        wfDeprecated( __METHOD__, '1.34' );
 
        global $wgHTTPConnectTimeout, $wgHTTPTimeout, $wgHTTPProxy;
 
        return new MultiHttpClient( $options + [
            'connTimeout' => $wgHTTPConnectTimeout,
            'reqTimeout' => $wgHTTPTimeout,
            'userAgent' => self::userAgent(),
            'proxy' => $wgHTTPProxy,
            'logger' => LoggerFactory::getInstance( 'http' )
        ] );
    }
}