HttpRequestFactory.php

Go to the documentation of this file.

<?php
namespace MediaWiki\Http;
 
use CurlHttpRequest;
use DomainException;
use Http;
use MediaWiki\Logger\LoggerFactory;
use MWHttpRequest;
use PhpHttpRequest;
use Profiler;
use GuzzleHttpRequest;
 
class HttpRequestFactory {
 
    public function create( $url, array $options = [], $caller = __METHOD__ ) {
        if ( !Http::$httpEngine ) {
            Http::$httpEngine = 'guzzle';
        } elseif ( Http::$httpEngine == 'curl' && !function_exists( 'curl_init' ) ) {
            throw new DomainException( __METHOD__ . ': curl (https://secure.php.net/curl) is not ' .
               'installed, but Http::$httpEngine is set to "curl"' );
        }
 
        if ( !isset( $options['logger'] ) ) {
            $options['logger'] = LoggerFactory::getInstance( 'http' );
        }
 
        switch ( Http::$httpEngine ) {
            case 'guzzle':
                return new GuzzleHttpRequest( $url, $options, $caller, Profiler::instance() );
            case 'curl':
                return new CurlHttpRequest( $url, $options, $caller, Profiler::instance() );
            case 'php':
                if ( !wfIniGetBool( 'allow_url_fopen' ) ) {
                    throw new DomainException( __METHOD__ . ': allow_url_fopen ' .
                       'needs to be enabled for pure PHP http requests to ' .
                       'work. If possible, curl should be used instead. See ' .
                       'https://secure.php.net/curl.'
                    );
                }
                return new PhpHttpRequest( $url, $options, $caller, Profiler::instance() );
            default:
                throw new DomainException( __METHOD__ . ': The setting of Http::$httpEngine is not valid.' );
        }
    }
 
    public function canMakeRequests() {
        return function_exists( 'curl_init' ) || wfIniGetBool( 'allow_url_fopen' );
    }
 
}