* $Author:: $ *
* -------------------------------------------------------------------- *
* Copyright (c) 2003 - 2009 by Roland Haeder *
- * Copyright (c) 2009 - 2011 by Mailer Developer Team *
+ * Copyright (c) 2009 - 2012 by Mailer Developer Team *
* For more information visit: http://mxchange.org *
* *
* This program is free software; you can redistribute it and/or modify *
die();
} // END - if
+// Initialize HTTP handling
+function initHttp () {
+ // Initialize array
+ $GLOBALS['http_header'] = array();
+}
+
// Sends out all headers required for HTTP/1.1 reply
function sendHttpHeaders () {
// Used later
$now = gmdate('D, d M Y H:i:s') . ' GMT';
// Send HTTP header
- sendHeader('HTTP/1.1 ' . getHttpStatus());
+ addHttpHeader('HTTP/1.1 ' . getHttpStatus());
// General headers for no caching
- sendHeader('Expires: ' . $now); // RFC2616 - Section 14.21
- sendHeader('Last-Modified: ' . $now);
- sendHeader('Cache-Control: no-store, no-cache, must-revalidate, pre-check=0, post-check=0, max-age=0'); // HTTP/1.1
- sendHeader('Pragma: no-cache'); // HTTP/1.0
- sendHeader('Connection: Close');
- sendHeader('Content-Type: ' . getContentType() . '; charset=UTF-8');
- sendHeader('Content-Language: ' . getLanguage());
+ addHttpHeader('Expires: ' . $now); // RFC2616 - Section 14.21
+ addHttpHeader('Last-Modified: ' . $now);
+ addHttpHeader('Cache-Control: no-store, no-cache, must-revalidate, pre-check=0, post-check=0, max-age=0'); // HTTP/1.1
+ addHttpHeader('Pragma: no-cache'); // HTTP/1.0
+ addHttpHeader('Connection: Close');
+
+ // There shall be no output mode in raw output-mode
+ if (!isRawOutputMode()) {
+ // Send content-type not in raw output-mode
+ addHttpHeader('Content-Type: ' . getContentType() . '; charset=UTF-8');
+ } // END - if
+
+ // Add language
+ addHttpHeader('Content-Language: ' . getLanguage());
+}
+
+// Checks whether the URL is full-qualified (http[s]:// + hostname [+ request data])
+function isFullQualifiedUrl ($url) {
+ // Is there cache?
+ if (!isset($GLOBALS[__FUNCTION__][$url])) {
+ // Determine it
+ $GLOBALS[__FUNCTION__][$url] = ((substr($url, 0, 7) == 'http://') || (substr($url, 0, 8) == 'https://'));
+ } // END - if
+
+ // Return cache
+ return $GLOBALS[__FUNCTION__][$url];
}
// Generates the full GET URL from given base URL and data array
// Init URL
$getUrl = $baseUrl;
+ // Is it full-qualified?
+ if (!isFullQualifiedUrl($getUrl)) {
+ // Need to prepend a slash?
+ if (substr($getUrl, 0, 1) != '/') {
+ // Prepend it
+ $getUrl = '/' . $getUrl;
+ } // END - if
+
+ // Prepend http://hostname from mxchange.org server
+ $getUrl = getServerUrl() . $getUrl;
+ } // END - if
+
// Add data
$body = http_build_query($requestData, '', '&');
// There should be data, else we don't need to extend $baseUrl with $body
if (!empty($body)) {
- // Do we have a question-mark in the script?
+ // Is there a question-mark in the script?
if (!isInString('?', $baseUrl)) {
// No, so first char must be question mark
$body = '?' . $body;
return $url;
}
-// Send a HEAD request
+// Sends a HTTP request (GET, POST, HEAD are currently supported)
+function sendHttpRequest ($requestType, $baseUrl, $requestData = array(), $removeHeader = FALSE) {
+ // Init response
+ $response = array();
+
+ // Start "detecting" the request type
+ switch ($requestType) {
+ case 'HEAD': // Send a HTTP/1.1 HEAD request
+ $response = sendHeadRequest($baseUrl, $requestData);
+ break;
+
+ case 'GET': // Send a HTTP/1.1 GET request
+ $response = sendGetRequest($baseUrl, $requestData, $removeHeader);
+ break;
+
+ case 'POST': // Send a HTTP/1.1 POST request
+ $response = sendPostRequest($baseUrl, $requestData, $removeHeader);
+ break;
+
+ default: // Unsupported HTTP request, this is really bad and needs fixing
+ reportBug(__FUNCTION__, __LINE__, 'Unsupported request detected. requestType=' . $requestType . ',baseUrl=' . $baseUrl . ',requestData()=' . count($requestData));
+ break;
+ } // END - switch
+
+ // Return response
+ return $response;
+}
+
+// Sends a HEAD request
function sendHeadRequest ($baseUrl, $requestData = array()) {
// Generate full GET URL
$getUrl = generateGetUrlFromBaseUrlData($baseUrl, $requestData);
+ // Is there http[s]:// in front of the URL?
+ if (isFullQualifiedUrl($getUrl)) {
+ // Remove http[s]://<hostname> from URL
+ $getUrl = removeHttpHostNameFromUrl($getUrl);
+ } elseif (substr($getUrl, 0, 1) != '/') {
+ // Prepend a slash
+ $getUrl = '/' . $getUrl;
+ }
+
// Extract hostname and port from script
$host = extractHostnameFromUrl($baseUrl);
- // Remove http[s]://<hostname> from url
- $getUrl = removeHttpHostNameFromUrl($getUrl);
-
// Generate HEAD request header
- $request = 'HEAD ' . trim($getUrl) . ' HTTP/1.1' . getConfig('HTTP_EOL');
+ $request = 'HEAD ' . (isProxyUsed() === TRUE ? $baseUrl : '') . trim($getUrl) . ' HTTP/1.1' . getConfig('HTTP_EOL');
$request .= 'Host: ' . $host . getConfig('HTTP_EOL');
$request .= 'Referer: ' . getUrl() . '/admin.php' . getConfig('HTTP_EOL');
if (isConfigEntrySet('FULL_VERSION')) {
}
// Send a GET request
-function sendGetRequest ($baseUrl, $requestData = array(), $removeHeader = false) {
+function sendGetRequest ($baseUrl, $requestData = array(), $removeHeader = FALSE) {
// Generate full GET URL
$getUrl = generateGetUrlFromBaseUrlData($baseUrl, $requestData);
+ // Is there http[s]:// in front of the URL?
+ if (isFullQualifiedUrl($getUrl)) {
+ // Remove http[s]://<hostname> from url
+ $getUrl = removeHttpHostNameFromUrl($getUrl);
+ } elseif (substr($getUrl, 0, 1) != '/') {
+ // Prepend a slash
+ $getUrl = '/' . $getUrl;
+ }
+
// Extract hostname and port from script
$host = extractHostnameFromUrl($baseUrl);
- // Remove http[s]://<hostname> from url
- $getUrl = removeHttpHostNameFromUrl($getUrl);
-
// Generate GET request header
- $request = 'GET ' . trim($getUrl) . ' HTTP/1.1' . getConfig('HTTP_EOL');
+ $request = 'GET ' . (isProxyUsed() === TRUE ? $baseUrl : '') . trim($getUrl) . ' HTTP/1.1' . getConfig('HTTP_EOL');
$request .= 'Host: ' . $host . getConfig('HTTP_EOL');
$request .= 'Referer: ' . getUrl() . '/admin.php' . getConfig('HTTP_EOL');
if (isConfigEntrySet('FULL_VERSION')) {
$response = sendRawRequest($host, $request);
// Should we remove header lines?
- if ($removeHeader === true) {
+ if ($removeHeader === TRUE) {
// Okay, remove them
$response = removeHttpHeaderFromResponse($response);
} // END - if
return $response;
}
-// Send a POST request
-function sendPostRequest ($baseUrl, $requestData, $removeHeader = false) {
+// Send a POST request, sometimes even POST requests have no parameters
+function sendPostRequest ($baseUrl, $requestData = array(), $removeHeader = FALSE) {
+ // Copy baseUrl to getUrl
+ $getUrl = $baseUrl;
+
+ // Is there http[s]:// in front of the URL?
+ if (isFullQualifiedUrl($getUrl)) {
+ // Remove http[s]://<hostname> from url
+ $getUrl = removeHttpHostNameFromUrl($getUrl);
+ } elseif (substr($getUrl, 0, 1) != '/') {
+ // Prepend a slash
+ $getUrl = '/' . $getUrl;
+ }
+
// Extract host name from script
$host = extractHostnameFromUrl($baseUrl);
// Construct request body
$body = http_build_query($requestData, '', '&');
- // Remove http(s)://$host from base URL
- $baseUrl = removeHttpHostNameFromUrl($baseUrl);
-
// Generate POST request header
- $request = 'POST ' . trim($baseUrl) . ' HTTP/1.0' . getConfig('HTTP_EOL');
+ $request = 'POST ' . (isProxyUsed() === TRUE ? $baseUrl : '') . trim($baseUrl) . ' HTTP/1.0' . getConfig('HTTP_EOL');
$request .= 'Host: ' . $host . getConfig('HTTP_EOL');
$request .= 'Referer: ' . getUrl() . '/admin.php' . getConfig('HTTP_EOL');
if (isConfigEntrySet('FULL_VERSION')) {
$response = sendRawRequest($host, $request);
// Should we remove header lines?
- if ($removeHeader === true) {
+ if ($removeHeader === TRUE) {
// Okay, remove them
$response = removeHttpHeaderFromResponse($response);
} // END - if
return $response;
}
-// Sends a raw request to another host
+// Sends a raw request (string) to given host (hostnames will be solved)
function sendRawRequest ($host, $request) {
//* DEBUG: */ die('host='.$host.',request=<pre>'.$request.'</pre>');
// Init errno and errdesc with 'all fine' values
// Initialize array
$response = array('', '', '');
- // Default is not to use proxy
- $useProxy = false;
-
// Default is non-broken HTTP server implementation
- $GLOBALS['is_http_server_broken'] = false;
-
- // Are proxy settins set?
- if (isProxyUsed()) {
- // Then use it
- $useProxy = true;
- } // END - if
+ $GLOBALS['is_http_server_broken'] = FALSE;
// Load include
loadIncludeOnce('inc/classes/resolver.class.php');
$port = $portArray[1];
} elseif (count($portArray) > 2) {
// This should not happen!
- debug_report_bug(__FUNCTION__, __LINE__, 'Invalid ' . $host . '. Please report this to the Mailer-Project team.');
+ reportBug(__FUNCTION__, __LINE__, 'Invalid ' . $host . '. Please report this to the Mailer-Project team.');
}
// Get resolver instance
$resolver = new HostnameResolver();
+ // Get proxy host
+ $proxyHost = compileRawCode(getProxyHost());
+
// Open connection
- if ($useProxy === true) {
+ if (isProxyUsed() === TRUE) {
// Resolve hostname into IP address
- $ip = $resolver->resolveHostname(compileRawCode(getProxyHost()));
+ $ip = $resolver->resolveHostname($proxyHost);
// Connect to host through proxy connection
- $fp = fsockopen($ip, bigintval(getProxyPort()), $errno, $errdesc, 30);
+ $resource = fsockopen($ip, bigintval(getProxyPort()), $errno, $errdesc, 30);
} else {
// Resolve hostname into IP address
$ip = $resolver->resolveHostname($host);
// Connect to host directly
- $fp = fsockopen($ip, $port, $errno, $errdesc, 30);
+ $resource = fsockopen($ip, $port, $errno, $errdesc, 30);
}
+ //* DEBUG: */ logDebugMessage(__FUNCTION__, __LINE__, 'ip=' . $ip . ',host=' . $host . ',isProxyUsed()=' . intval(isProxyUsed()));
// Is there a link?
- if (!is_resource($fp)) {
+ if (!is_resource($resource)) {
// Failed!
logDebugMessage(__FUNCTION__, __LINE__, $errdesc . ' (' . $errno . ')');
return $response;
- } elseif ((!stream_set_blocking($fp, 0)) || (!stream_set_timeout($fp, 1))) {
+ } elseif ((!stream_set_blocking($resource, 0)) || (!stream_set_timeout($resource, 1))) {
// Cannot set non-blocking mode or timeout
logDebugMessage(__FUNCTION__, __LINE__, socket_strerror(socket_last_error()));
return $response;
}
- // Do we use proxy?
- if ($useProxy === true) {
+ // Shall proxy be used?
+ if (isProxyUsed() === TRUE) {
// Setup proxy tunnel
- $response = setupProxyTunnel($host, $port, $fp);
+ $response = setupProxyTunnel($host, $proxyHost, $port, $resource);
// If the response is invalid, abort
if ((count($response) == 3) && (empty($response[0])) && (empty($response[1])) && (empty($response[2]))) {
} // END - if
// Write request
- fwrite($fp, $request);
+ fwrite($resource, $request);
// Start counting
- $start = microtime(true);
+ $start = microtime(TRUE);
// Read response
- while (!feof($fp)) {
+ while (!feof($resource)) {
// Get info from stream
- $info = stream_get_meta_data($fp);
+ $info = stream_get_meta_data($resource);
// Is it timed out? 15 seconds is a really patient...
- if (($info['timed_out'] == true) || (microtime(true) - $start) > 15) {
+ if (($info['timed_out'] == TRUE) || (microtime(TRUE) - $start) > 15) {
// Timeout
logDebugMessage(__FUNCTION__, __LINE__, 'Timed out to get data from host ' . $host);
} // END - if
// Get line from stream
- $line = fgets($fp, 128);
+ $line = fgets($resource, 128);
// Ignore empty lines because of non-blocking mode
if (empty($line)) {
} // END - if
// Add it to response
- $response[] = $line;
+ //* DEBUG: */ print 'line='.$line.'<br />';
+ array_push($response, $line);
} // END - while
// Close socket
- fclose($fp);
+ fclose($resource);
// Time request if debug-mode is enabled
if (isDebugModeEnabled()) {
// Add debug message...
- logDebugMessage(__FUNCTION__, __LINE__, 'Request took ' . (microtime(true) - $start) . ' seconds and returned ' . count($response) . ' line(s).');
+ logDebugMessage(__FUNCTION__, __LINE__, 'Request took ' . (microtime(TRUE) - $start) . ' seconds and returned ' . count($response) . ' line(s).');
} // END - if
// Skip first empty lines
}
} // END - foreach
- //* DEBUG: */ debugOutput('<strong>Request:</strong><pre>'.print_r($request, true).'</pre>');
- //* DEBUG: */ debugOutput('<strong>Response:</strong><pre>'.print_r($response, true).'</pre>');
+ //* DEBUG: */ debugOutput('<strong>Request:</strong><pre>'.print_r($request, TRUE).'</pre>');
+ //* DEBUG: */ debugOutput('<strong>Response:</strong><pre>'.print_r($response, TRUE).'</pre>');
// Proxy agent found or something went wrong?
if (!isset($response[0])) {
// No response, maybe timeout
$response = array('', '', '');
logDebugMessage(__FUNCTION__, __LINE__, 'Invalid empty response array, maybe timed out?');
- } elseif ((substr(strtolower($response[0]), 0, 11) == 'proxy-agent') && ($useProxy === true)) {
+ } elseif ((substr(strtolower($response[0]), 0, 11) == 'proxy-agent') && (isProxyUsed() === TRUE)) {
// Proxy header detected, so remove two lines
array_shift($response);
array_shift($response);
}
// Sets up a proxy tunnel for given hostname and through resource
-function setupProxyTunnel ($host, $port, $resource) {
+function setupProxyTunnel ($host, $proxyHost, $port, $resource) {
// Initialize array
$response = array('', '', '');
// Generate CONNECT request header
$proxyTunnel = 'CONNECT ' . $host . ':' . $port . ' HTTP/1.0' . getConfig('HTTP_EOL');
$proxyTunnel .= 'Host: ' . $host . getConfig('HTTP_EOL');
+ $proxyTunnel .= 'Proxy-Connection: Keep-Alive' . getConfig('HTTP_EOL');
// Use login data to proxy? (username at least!)
if (getProxyUsername() != '') {
//* DEBUG: */ debugOutput('<strong>proxyTunnel=</strong><pre>' . $proxyTunnel.'</pre>');
// Write request
- fwrite($fp, $proxyTunnel);
+ fwrite($resource, $proxyTunnel);
// Got response?
- if (feof($fp)) {
+ if (feof($resource)) {
// No response received
return $response;
} // END - if
// Read the first line
- $resp = trim(fgets($fp, 10240));
+ $resp = trim(fgets($resource, 10240));
$respArray = explode(' ', $resp);
- if ((strtolower($respArray[0]) !== 'http/1.0') || ($respArray[1] != '200')) {
+ if (((strtolower($respArray[0]) !== 'http/1.0') && (strtolower($respArray[0]) !== 'http/1.1')) || ($respArray[1] != '200')) {
// Invalid response!
return $response;
} // END - if
// Check array for chuncked encoding
function unchunkHttpResponse ($response) {
// Default is not chunked
- $isChunked = false;
+ $isChunked = FALSE;
// Check if we have chunks
foreach ($response as $line) {
// Entry found?
if ((isInStringIgnoreCase('transfer-encoding', $line)) && (isInStringIgnoreCase('chunked', $line))) {
// Found!
- $isChunked = true;
+ $isChunked = TRUE;
break;
} // END - if
} // END - foreach
// Is it chunked?
- if ($isChunked === true) {
+ if ($isChunked === TRUE) {
// Good, we still have the HTTP headers in there, so we need to get rid
// of them temporarly
- //* DEBUG: */ die('<pre>'.htmlentities(print_r(removeHttpHeaderFromResponse($response), true)).'</pre>');
+ //* DEBUG: */ die('<pre>'.htmlentities(print_r(removeHttpHeaderFromResponse($response), TRUE)).'</pre>');
$tempResponse = http_chunked_decode(implode('', removeHttpHeaderFromResponse($response)));
// We got a string back from http_chunked_decode(), so we need to convert it back to an array
//* DEBUG: */ die('tempResponse['.strlen($tempResponse).']=<pre>'.replaceReturnNewLine(htmlentities($tempResponse)).'</pre>');
// Re-add the headers
- $response = merge_array($GLOBALS['http_headers'], stringToArray("\n", $tempResponse));
+ $response = merge_array($GLOBALS['http_headers'], stringToArray(chr(10), $tempResponse));
} // END - if
// Return the unchunked array
array_shift($response2);
// Add full line to temporary global array
- $GLOBALS['http_headers'][] = $line;
+ array_push($GLOBALS['http_headers'], $line);
// Trim it for testing
$lineTest = trim($line);
// Returns the flag if a broken HTTP server implementation was detected
function isBrokenHttpServerImplentation () {
// Determine it
- $isBroken = ((isset($GLOBALS['is_http_server_broken'])) && ($GLOBALS['is_http_server_broken'] === true));
+ $isBroken = ((isset($GLOBALS['is_http_server_broken'])) && ($GLOBALS['is_http_server_broken'] === TRUE));
// ... and return it
return $isBroken;
}
+// Extract host from script name
+function extractHostnameFromUrl (&$script) {
+ // Use default SERVER_URL by default... ;) So?
+ $url = getServerUrl();
+
+ // Is this URL valid?
+ if (substr($script, 0, 7) == 'http://') {
+ // Use the hostname from script URL as new hostname
+ $url = substr($script, 7);
+ $extract = explode('/', $url);
+ $url = $extract[0];
+ // Done extracting the URL :)
+ } // END - if
+
+ // Extract host name
+ $host = str_replace('http://', '', $url);
+ if (isInString('/', $host)) {
+ $host = substr($host, 0, strpos($host, '/'));
+ } // END - if
+
+ // Generate relative URL
+ //* DEBUG: */ debugOutput('SCRIPT=' . $script);
+ if (substr(strtolower($script), 0, 7) == 'http://') {
+ // But only if http:// is in front!
+ $script = substr($script, (strlen($url) + 7));
+ } elseif (substr(strtolower($script), 0, 8) == 'https://') {
+ // Does this work?!
+ $script = substr($script, (strlen($url) + 8));
+ }
+
+ //* DEBUG: */ debugOutput('SCRIPT=' . $script);
+ if (substr($script, 0, 1) == '/') {
+ $script = substr($script, 1);
+ } // END - if
+
+ // Return host name
+ return $host;
+}
+
+// Adds a HTTP header to array
+function addHttpHeader ($header) {
+ // Send the header
+ //* DEBUG: */ logDebugMessage(__FUNCTION__ . ': header=' . $header);
+ array_push($GLOBALS['http_header'], trim($header));
+}
+
+// Flushes all HTTP headers
+function flushHttpHeaders () {
+ // Is the header already sent?
+ if (headers_sent()) {
+ // Then abort here
+ reportBug(__FUNCTION__, __LINE__, 'Headers already sent!');
+ } elseif ((!isset($GLOBALS['http_header'])) || (!is_array($GLOBALS['http_header']))) {
+ // Not set or not an array
+ reportBug(__FUNCTION__, __LINE__, 'Headers not set or not an array, isset()=' . isset($GLOBALS['http_header']) . ', please report this.');
+ }
+
+ // Flush all headers if found
+ foreach ($GLOBALS['http_header'] as $header) {
+ // Send a single header
+ header($header);
+ } // END - foreach
+
+ // Mark them as flushed
+ $GLOBALS['http_header'] = array();
+}
+
//-----------------------------------------------------------------------------
// Automatically re-created functions, all taken from user comments on www.php.net
//-----------------------------------------------------------------------------
* dechunk an HTTP 'transfer-encoding: chunked' message.
*
* @param $chunk The encoded message
- * @return $dechunk The decoded message. If $chunk wasn't encoded properly debug_report_bug() is being called
+ * @return $dechunk The decoded message. If $chunk wasn't encoded properly reportBug() is being called
* @author Marques Johansson (initial author)
* @author Roland Haeder (heavy modifications and simplification)
* @link http://php.net/manual/en/function.http-chunked-decode.php#89786
if (!isHexadecimal($chunkLenHex)) {
// Please help debugging this
//* DEBUG: */ die('ABORT:chunkLenHex=<pre>'.replaceReturnNewLine(htmlentities($chunkLenHex)).'</pre>');
- debug_report_bug(__FUNCTION__, __LINE__, 'Value ' . $chunkLenHex . ' is no valid hexa-decimal string.');
+ reportBug(__FUNCTION__, __LINE__, 'Value ' . $chunkLenHex . ' is no valid hexa-decimal string.');
// This won't be reached
return $chunk;
}
} // END - if
+// Getter for request method
+function getHttpRequestMethod () {
+ // Console is default
+ $requestMethod = 'console';
+
+ // Is it set?
+ if (isset($_SERVER['REQUEST_METHOD'])) {
+ // Get current request method
+ $requestMethod = $_SERVER['REQUEST_METHOD'];
+ } // END - if
+
+ // Return it
+ return $requestMethod;
+}
+
+// Checks if 'content_type' is set
+function isContentTypeSet () {
+ return isset($GLOBALS['content_type']);
+}
+
+// Setter for content type
+function setContentType ($contentType) {
+ //* DEBUG: */ logDebugMessage(__FUNCTION__, __LINE__, 'contentType=' . $contentType);
+ $GLOBALS['content_type'] = (string) $contentType;
+}
+
+// Getter for content type
+function getContentType () {
+ // Is it there?
+ if (!isContentTypeSet()) {
+ // Please fix this
+ reportBug(__FUNCTION__, __LINE__, 'content_type not set in GLOBALS array.');
+ } // END - if
+
+ // Return it
+ //* DEBUG: */ logDebugMessage(__FUNCTION__, __LINE__, 'content_type=' . $GLOBALS['content_type']);
+ return $GLOBALS['content_type'];
+}
+
// [EOF]
?>