Http.php

Go to the documentation of this file.

<?php
use MediaWiki\Logger\LoggerFactory;
 
class Http {
    static public $httpEngine = false;
 
    public static function request( $method, $url, $options = [], $caller = __METHOD__ ) {
        $logger = LoggerFactory::getInstance( 'http' );
        $logger->debug( "$method: $url" );
 
        $options['method'] = strtoupper( $method );
 
        if ( !isset( $options['timeout'] ) ) {
            $options['timeout'] = 'default';
        }
        if ( !isset( $options['connectTimeout'] ) ) {
            $options['connectTimeout'] = 'default';
        }
 
        $req = MWHttpRequest::factory( $url, $options, $caller );
        $status = $req->execute();
 
        if ( $status->isOK() ) {
            return $req->getContent();
        } else {
            $errors = $status->getErrorsByType( 'error' );
            $logger->warning( Status::wrap( $status )->getWikiText( false, false, 'en' ),
                [ 'error' => $errors, 'caller' => $caller, 'content' => $req->getContent() ] );
            return false;
        }
    }
 
    public static function get( $url, $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, $options = [], $caller = __METHOD__ ) {
        return self::request( 'POST', $url, $options, $caller );
    }
 
    public static function userAgent() {
        global $wgVersion;
        return "MediaWiki/$wgVersion";
    }
 
    public static function isValidURI( $uri ) {
        return (bool)preg_match(
            '/^https?:\/\/[^\/\s]\S*$/D',
            $uri
        );
    }
 
    public static function getProxy() {
        global $wgHTTPProxy;
 
        if ( $wgHTTPProxy ) {
            return $wgHTTPProxy;
        }
 
        return "";
    }
 
    public static function createMultiClient( $options = [] ) {
        global $wgHTTPConnectTimeout, $wgHTTPTimeout, $wgHTTPProxy;
 
        return new MultiHttpClient( $options + [
            'connTimeout' => $wgHTTPConnectTimeout,
            'reqTimeout' => $wgHTTPTimeout,
            'userAgent' => self::userAgent(),
            'proxy' => $wgHTTPProxy,
            'logger' => LoggerFactory::getInstance( 'http' )
        ] );
    }
}