MediaWiki REL1_32
CurlHttpRequest.php
Go to the documentation of this file.
1<?php
25 const SUPPORTS_FILE_POSTS = true;
26
27 protected $curlOptions = [];
28 protected $headerText = "";
29
35 protected function readHeader( $fh, $content ) {
36 $this->headerText .= $content;
37 return strlen( $content );
38 }
39
46 public function execute() {
47 $this->prepare();
48
49 if ( !$this->status->isOK() ) {
50 return Status::wrap( $this->status ); // TODO B/C; move this to callers
51 }
52
53 $this->curlOptions[CURLOPT_PROXY] = $this->proxy;
54 $this->curlOptions[CURLOPT_TIMEOUT] = $this->timeout;
55
56 // Only supported in curl >= 7.16.2
57 if ( defined( 'CURLOPT_CONNECTTIMEOUT_MS' ) ) {
58 $this->curlOptions[CURLOPT_CONNECTTIMEOUT_MS] = $this->connectTimeout * 1000;
59 }
60
61 $this->curlOptions[CURLOPT_HTTP_VERSION] = CURL_HTTP_VERSION_1_0;
62 $this->curlOptions[CURLOPT_WRITEFUNCTION] = $this->callback;
63 $this->curlOptions[CURLOPT_HEADERFUNCTION] = [ $this, "readHeader" ];
64 $this->curlOptions[CURLOPT_MAXREDIRS] = $this->maxRedirects;
65 $this->curlOptions[CURLOPT_ENCODING] = ""; # Enable compression
66
67 $this->curlOptions[CURLOPT_USERAGENT] = $this->reqHeaders['User-Agent'];
68
69 $this->curlOptions[CURLOPT_SSL_VERIFYHOST] = $this->sslVerifyHost ? 2 : 0;
70 $this->curlOptions[CURLOPT_SSL_VERIFYPEER] = $this->sslVerifyCert;
71
72 if ( $this->caInfo ) {
73 $this->curlOptions[CURLOPT_CAINFO] = $this->caInfo;
74 }
75
76 if ( $this->headersOnly ) {
77 $this->curlOptions[CURLOPT_NOBODY] = true;
78 $this->curlOptions[CURLOPT_HEADER] = true;
79 } elseif ( $this->method == 'POST' ) {
80 $this->curlOptions[CURLOPT_POST] = true;
81 $postData = $this->postData;
82 // Don't interpret POST parameters starting with '@' as file uploads, because this
83 // makes it impossible to POST plain values starting with '@' (and causes security
84 // issues potentially exposing the contents of local files).
85 $this->curlOptions[CURLOPT_SAFE_UPLOAD] = true;
86 $this->curlOptions[CURLOPT_POSTFIELDS] = $postData;
87
88 // Suppress 'Expect: 100-continue' header, as some servers
89 // will reject it with a 417 and Curl won't auto retry
90 // with HTTP 1.0 fallback
91 $this->reqHeaders['Expect'] = '';
92 } else {
93 $this->curlOptions[CURLOPT_CUSTOMREQUEST] = $this->method;
94 }
95
96 $this->curlOptions[CURLOPT_HTTPHEADER] = $this->getHeaderList();
97
98 $curlHandle = curl_init( $this->url );
99
100 if ( !curl_setopt_array( $curlHandle, $this->curlOptions ) ) {
101 $this->status->fatal( 'http-internal-error' );
102 throw new InvalidArgumentException( "Error setting curl options." );
103 }
104
105 if ( $this->followRedirects && $this->canFollowRedirects() ) {
106 Wikimedia\suppressWarnings();
107 if ( !curl_setopt( $curlHandle, CURLOPT_FOLLOWLOCATION, true ) ) {
108 $this->logger->debug( __METHOD__ . ": Couldn't set CURLOPT_FOLLOWLOCATION. " .
109 "Probably open_basedir is set.\n" );
110 // Continue the processing. If it were in curl_setopt_array,
111 // processing would have halted on its entry
112 }
113 Wikimedia\restoreWarnings();
114 }
115
116 if ( $this->profiler ) {
117 $profileSection = $this->profiler->scopedProfileIn(
118 __METHOD__ . '-' . $this->profileName
119 );
120 }
121
122 $curlRes = curl_exec( $curlHandle );
123 if ( curl_errno( $curlHandle ) == CURLE_OPERATION_TIMEOUTED ) {
124 $this->status->fatal( 'http-timed-out', $this->url );
125 } elseif ( $curlRes === false ) {
126 $this->status->fatal( 'http-curl-error', curl_error( $curlHandle ) );
127 } else {
128 $this->headerList = explode( "\r\n", $this->headerText );
129 }
130
131 curl_close( $curlHandle );
132
133 if ( $this->profiler ) {
134 $this->profiler->scopedProfileOut( $profileSection );
135 }
136
137 $this->parseHeader();
138 $this->setStatus();
139
140 return Status::wrap( $this->status ); // TODO B/C; move this to callers
141 }
142
146 public function canFollowRedirects() {
147 $curlVersionInfo = curl_version();
148 if ( $curlVersionInfo['version_number'] < 0x071304 ) {
149 $this->logger->debug( "Cannot follow redirects with libcurl < 7.19.4 due to CVE-2009-0037\n" );
150 return false;
151 }
152
153 return true;
154 }
155}
static prepare( $text, $lang)
Backward-compatibility shim for extensions.
MWHttpRequest implemented using internal curl compiled into PHP.
readHeader( $fh, $content)
This wrapper class will call out to curl (if available) or fallback to regular PHP if necessary for h...
setStatus()
Sets HTTPRequest status member to a fatal value with the error message if the returned integer value ...
parseHeader()
Parses the headers, including the HTTP status code and any Set-Cookie headers.
getHeaderList()
Get an array of the headers.
$content