mirror of
https://github.com/silverstripe/silverstripe-framework
synced 2024-10-01 13:48:37 +02:00
dffae1a2e7
This also removes the $global_mimetypes that was generating weird errors when both HTTP and Mailer classes tried to modify and use it. Support of finfo should be straightforward since PHP 5.3 includes that module that default
384 lines
12 KiB
PHP
384 lines
12 KiB
PHP
<?php
|
|
/**
|
|
* A class with HTTP-related helpers.
|
|
* Like Debug, this is more a bundle of methods than a class ;-)
|
|
*
|
|
* @package framework
|
|
* @subpackage misc
|
|
*/
|
|
class HTTP {
|
|
|
|
static $userName;
|
|
static $password;
|
|
|
|
/**
|
|
* Turns a local system filename into a URL by comparing it to the script filename
|
|
*/
|
|
static function filename2url($filename) {
|
|
$slashPos = -1;
|
|
while(($slashPos = strpos($filename, "/", $slashPos+1)) !== false) {
|
|
if(substr($filename, 0, $slashPos) == substr($_SERVER['SCRIPT_FILENAME'],0,$slashPos)) {
|
|
$commonLength = $slashPos;
|
|
} else {
|
|
break;
|
|
}
|
|
}
|
|
|
|
$urlBase = substr($_SERVER['PHP_SELF'], 0, -(strlen($_SERVER['SCRIPT_FILENAME']) - $commonLength));
|
|
$url = $urlBase . substr($filename, $commonLength);
|
|
$protocol = (isset($_SERVER['HTTPS']) && $_SERVER['HTTPS'] != 'off') ? "https" : "http";
|
|
return "$protocol://". $_SERVER['HTTP_HOST'] . $url;
|
|
|
|
// Count the number of extra folders the script is in.
|
|
// $prefix = str_repeat("../", substr_count(substr($_SERVER[SCRIPT_FILENAME],$commonBaseLength)));
|
|
}
|
|
|
|
/**
|
|
* Turn all relative URLs in the content to absolute URLs
|
|
*/
|
|
static function absoluteURLs($html) {
|
|
$html = str_replace('$CurrentPageURL', $_SERVER['REQUEST_URI'], $html);
|
|
return HTTP::urlRewriter($html, '(substr($URL,0,1) == "/") ? ( Director::protocolAndHost() . $URL ) : ( (preg_match("/^[A-Za-z]+:/", $URL)) ? $URL : Director::absoluteBaseURL() . $URL )' );
|
|
}
|
|
|
|
/*
|
|
* Rewrite all the URLs in the given content, evaluating the given string as PHP code
|
|
*
|
|
* Put $URL where you want the URL to appear, however, you can't embed $URL in strings
|
|
* Some example code:
|
|
* '"../../" . $URL'
|
|
* 'myRewriter($URL)'
|
|
* '(substr($URL,0,1)=="/") ? "../" . substr($URL,1) : $URL'
|
|
*/
|
|
static function urlRewriter($content, $code) {
|
|
$attribs = array("src","background","a" => "href","link" => "href", "base" => "href");
|
|
foreach($attribs as $tag => $attrib) {
|
|
if(!is_numeric($tag)) $tagPrefix = "$tag ";
|
|
else $tagPrefix = "";
|
|
|
|
$regExps[] = "/(<{$tagPrefix}[^>]*$attrib *= *\")([^\"]*)(\")/ie";
|
|
$regExps[] = "/(<{$tagPrefix}[^>]*$attrib *= *')([^']*)(')/ie";
|
|
$regExps[] = "/(<{$tagPrefix}[^>]*$attrib *= *)([^\"' ]*)( )/ie";
|
|
}
|
|
$regExps[] = '/(background-image:[^;]*url *\()([^)]+)(\))/ie';
|
|
$regExps[] = '/(background:[^;]*url *\()([^)]+)(\))/ie';
|
|
$regExps[] = '/(list-style-image:[^;]*url *\()([^)]+)(\))/ie';
|
|
$regExps[] = '/(list-style:[^;]*url *\()([^)]+)(\))/ie';
|
|
|
|
// Make
|
|
$code = 'stripslashes("$1") . (' . str_replace('$URL', 'stripslashes("$2")', $code) . ') . stripslashes("$3")';
|
|
|
|
foreach($regExps as $regExp) {
|
|
$content = preg_replace($regExp, $code, $content);
|
|
}
|
|
|
|
return $content;
|
|
}
|
|
|
|
/**
|
|
* Will try to include a GET parameter for an existing URL,
|
|
* preserving existing parameters and fragments.
|
|
* If no URL is given, falls back to $_SERVER['REQUEST_URI'].
|
|
* Uses parse_url() to dissect the URL, and http_build_query() to reconstruct it
|
|
* with the additional parameter. Converts any '&' (ampersand)
|
|
* URL parameter separators to the more XHTML compliant '&'.
|
|
*
|
|
* CAUTION: If the URL is determined to be relative,
|
|
* it is prepended with Director::absoluteBaseURL().
|
|
* This method will always return an absolute URL because
|
|
* Director::makeRelative() can lead to inconsistent results.
|
|
*
|
|
* @param String $varname
|
|
* @param String $varvalue
|
|
* @param String $currentURL Relative or absolute URL (Optional).
|
|
* @param String $separator Separator for http_build_query(). (Optional).
|
|
* @return String Absolute URL
|
|
*/
|
|
public static function setGetVar($varname, $varvalue, $currentURL = null, $separator = '&') {
|
|
$uri = $currentURL ? $currentURL : Director::makeRelative($_SERVER['REQUEST_URI']);
|
|
|
|
$isRelative = false;
|
|
// We need absolute URLs for parse_url()
|
|
if(Director::is_relative_url($uri)) {
|
|
$uri = Director::absoluteBaseURL() . $uri;
|
|
$isRelative = true;
|
|
}
|
|
|
|
// try to parse uri
|
|
$parts = parse_url($uri);
|
|
if(!$parts) {
|
|
throw new InvalidArgumentException("Can't parse URL: " . $uri);
|
|
}
|
|
|
|
// Parse params and add new variable
|
|
$params = array();
|
|
if(isset($parts['query'])) parse_str($parts['query'], $params);
|
|
$params[$varname] = $varvalue;
|
|
|
|
// Generate URI segments and formatting
|
|
$scheme = (isset($parts['scheme'])) ? $parts['scheme'] : 'http';
|
|
$user = (isset($parts['user']) && $parts['user'] != '') ? $parts['user'] : '';
|
|
|
|
if($user != '') {
|
|
// format in either user:pass@host.com or user@host.com
|
|
$user .= (isset($parts['pass']) && $parts['pass'] != '') ? ':' . $parts['pass'] . '@' : '@';
|
|
}
|
|
|
|
$host = (isset($parts['host'])) ? $parts['host'] : '';
|
|
$port = (isset($parts['port']) && $parts['port'] != '') ? ':'.$parts['port'] : '';
|
|
$path = (isset($parts['path']) && $parts['path'] != '') ? $parts['path'] : '';
|
|
|
|
// handle URL params which are existing / new
|
|
$params = ($params) ? '?' . http_build_query($params, null, $separator) : '';
|
|
|
|
// keep fragments (anchors) intact.
|
|
$fragment = (isset($parts['fragment']) && $parts['fragment'] != '') ? '#'.$parts['fragment'] : '';
|
|
|
|
// Recompile URI segments
|
|
$newUri = $scheme . '://' . $user . $host . $port . $path . $params . $fragment;
|
|
|
|
if($isRelative) return Director::makeRelative($newUri);
|
|
|
|
return $newUri;
|
|
}
|
|
|
|
static function RAW_setGetVar($varname, $varvalue, $currentURL = null) {
|
|
$url = self::setGetVar($varname, $varvalue, $currentURL);
|
|
return Convert::xml2raw($url);
|
|
}
|
|
|
|
/**
|
|
* Search for all tags with a specific attribute, then return the value of that attribute in a flat array.
|
|
*
|
|
* @param string $content
|
|
* @param array $attributes an array of tags to attributes, for example "[a] => 'href', [div] => 'id'"
|
|
* @return array
|
|
*/
|
|
public static function findByTagAndAttribute($content, $attributes) {
|
|
$regexes = array();
|
|
|
|
foreach($attributes as $tag => $attribute) {
|
|
$regexes[] = "/<{$tag} [^>]*$attribute *= *([\"'])(.*?)\\1[^>]*>/i";
|
|
$regexes[] = "/<{$tag} [^>]*$attribute *= *([^ \"'>]+)/i";
|
|
}
|
|
|
|
$result = array();
|
|
|
|
if($regexes) foreach($regexes as $regex) {
|
|
if(preg_match_all($regex, $content, $matches)) {
|
|
$result = array_merge_recursive($result, (isset($matches[2]) ? $matches[2] : $matches[1]));
|
|
}
|
|
}
|
|
|
|
return count($result) ? $result : null;
|
|
}
|
|
|
|
static function getLinksIn($content) {
|
|
return self::findByTagAndAttribute($content, array("a" => "href"));
|
|
}
|
|
|
|
static function getImagesIn($content) {
|
|
return self::findByTagAndAttribute($content, array("img" => "src"));
|
|
}
|
|
|
|
/**
|
|
* Get mime type based on extension
|
|
*
|
|
* @uses finfo
|
|
* @deprecated Use HTTP::get_mime_type() instead
|
|
*/
|
|
public static function getMimeType($filename) {
|
|
Deprecation::notice('3.0', 'Use HTTP::get_mime_type() instead.');
|
|
self::get_mime_type($filename);
|
|
}
|
|
|
|
/**
|
|
* Get mime type based on extension
|
|
*
|
|
* @uses finfo
|
|
*/
|
|
public static function get_mime_type($filename) {
|
|
$finfo = new finfo(FILEINFO_MIME_TYPE);
|
|
return $finfo->file(BASE_PATH.DIRECTORY_SEPARATOR.$filename);
|
|
}
|
|
|
|
/**
|
|
* Send an HTTP request to the host.
|
|
*
|
|
* @return String Response text
|
|
*/
|
|
static function sendRequest( $host, $path, $query, $port = 80 ) {
|
|
$socket = fsockopen( $host, $port, $errno, $error );
|
|
|
|
if( !$socket )
|
|
return $error;
|
|
|
|
if( $query )
|
|
$query = '?' . $query;
|
|
|
|
if( self::$userName && self::$password ) {
|
|
$auth = "Authorization: Basic " . base64_encode( self::$userName . ':' . self::$password ) . "\r\n";
|
|
} else {
|
|
$auth = '';
|
|
}
|
|
|
|
$request = "GET {$path}{$query} HTTP/1.1\r\nHost: $host\r\nConnection: Close\r\n{$auth}\r\n";
|
|
|
|
fwrite( $socket, $request );
|
|
$response = stream_get_contents( $socket );
|
|
|
|
return $response;
|
|
}
|
|
|
|
/**
|
|
* Send a HTTP POST request through fsockopen().
|
|
*
|
|
* @param string $host Absolute URI without path, e.g. http://silverstripe.com
|
|
* @param string $path Path with leading slash
|
|
* @param array|string $data Payload for the request
|
|
* @param string $name Parametername for the payload (only if passed as a string)
|
|
* @param string $query
|
|
* @param string $port
|
|
* @return string Raw HTTP-result including headers
|
|
*/
|
|
static function sendPostRequest($host, $path, $data, $name = null, $query = '', $port = 80, $getResponse = true) {
|
|
$socket = fsockopen($host, $port, $errno, $error);
|
|
|
|
if(!$socket)
|
|
return $error;
|
|
|
|
if(self::$userName && self::$password)
|
|
$auth = "Authorization: Basic " . base64_encode(self::$userName . ':' . self::$password) . "\r\n";
|
|
else
|
|
$auth = '';
|
|
|
|
if($query)
|
|
$query = '?' . $query;
|
|
|
|
$dataStr = (is_array($data)) ? http_build_query($data) : $name . '=' . urlencode($data);
|
|
$request = "POST {$path}{$query} HTTP/1.1\r\nHost: $host\r\n{$auth}Content-Type: application/x-www-form-urlencoded\r\nContent-Length: " . strlen($dataStr) . "\r\n\r\n";
|
|
$request .= $dataStr . "\r\n\r\n";
|
|
|
|
fwrite($socket, $request);
|
|
|
|
if($getResponse){
|
|
$response = stream_get_contents($socket);
|
|
return $response;
|
|
}
|
|
|
|
}
|
|
|
|
protected static $cache_age = 0, $modification_date = null;
|
|
protected static $etag = null;
|
|
|
|
/**
|
|
* Set the maximum age of this page in web caches, in seconds
|
|
*/
|
|
static function set_cache_age($age) {
|
|
self::$cache_age = $age;
|
|
}
|
|
|
|
static function register_modification_date($dateString) {
|
|
$timestamp = strtotime($dateString);
|
|
if($timestamp > self::$modification_date)
|
|
self::$modification_date = $timestamp;
|
|
}
|
|
|
|
static function register_modification_timestamp($timestamp) {
|
|
if($timestamp > self::$modification_date)
|
|
self::$modification_date = $timestamp;
|
|
}
|
|
|
|
static function register_etag($etag) {
|
|
self::$etag = $etag;
|
|
}
|
|
|
|
/**
|
|
* Add the appropriate caching headers to the response, including If-Modified-Since / 304 handling.
|
|
*
|
|
* @param SS_HTTPResponse The SS_HTTPResponse object to augment. Omitted the argument or passing a string is deprecated; in these
|
|
* cases, the headers are output directly.
|
|
*/
|
|
static function add_cache_headers($body = null) {
|
|
// Validate argument
|
|
if($body && !($body instanceof SS_HTTPResponse)) {
|
|
user_error("HTTP::add_cache_headers() must be passed an SS_HTTPResponse object", E_USER_WARNING);
|
|
$body = null;
|
|
}
|
|
|
|
// Development sites have frequently changing templates; this can get stuffed up by the code
|
|
// below.
|
|
if(Director::isDev()) return;
|
|
|
|
// The headers have been sent and we don't have an SS_HTTPResponse object to attach things to; no point in us trying.
|
|
if(headers_sent() && !$body) return;
|
|
|
|
// Popuplate $responseHeaders with all the headers that we want to build
|
|
$responseHeaders = array();
|
|
if(function_exists('apache_request_headers')) {
|
|
$requestHeaders = apache_request_headers();
|
|
if(isset($requestHeaders['X-Requested-With']) && $requestHeaders['X-Requested-With'] == 'XMLHttpRequest') self::$cache_age = 0;
|
|
// bdc: now we must check for DUMB IE6:
|
|
if(isset($requestHeaders['x-requested-with']) && $requestHeaders['x-requested-with'] == 'XMLHttpRequest') self::$cache_age = 0;
|
|
}
|
|
|
|
if(self::$cache_age > 0) {
|
|
$responseHeaders["Cache-Control"] = "max-age=" . self::$cache_age . ", must-revalidate";
|
|
$responseHeaders["Pragma"] = "";
|
|
} else {
|
|
$responseHeaders["Cache-Control"] = "no-cache, max-age=0, must-revalidate";
|
|
}
|
|
|
|
if(self::$modification_date && self::$cache_age > 0) {
|
|
$responseHeaders["Last-Modified"] =self::gmt_date(self::$modification_date);
|
|
|
|
// 304 response detection
|
|
if(isset($_SERVER['HTTP_IF_MODIFIED_SINCE'])) {
|
|
$ifModifiedSince = strtotime(stripslashes($_SERVER['HTTP_IF_MODIFIED_SINCE']));
|
|
if($ifModifiedSince >= self::$modification_date) {
|
|
if($body) {
|
|
$body->setStatusCode(304);
|
|
$body->setBody('');
|
|
} else {
|
|
header('HTTP/1.0 304 Not Modified');
|
|
die();
|
|
}
|
|
}
|
|
}
|
|
|
|
$expires = time() + self::$cache_age;
|
|
$responseHeaders["Expires"] = self::gmt_date($expires);
|
|
}
|
|
|
|
if(self::$etag) {
|
|
$responseHeaders['ETag'] = self::$etag;
|
|
}
|
|
|
|
// Now that we've generated them, either output them or attach them to the SS_HTTPResponse as appropriate
|
|
foreach($responseHeaders as $k => $v) {
|
|
if($body) $body->addHeader($k, $v);
|
|
else if(!headers_sent()) header("$k: $v");
|
|
}
|
|
}
|
|
|
|
|
|
/**
|
|
* Return an {@link http://www.faqs.org/rfcs/rfc2822 RFC 2822} date in the
|
|
* GMT timezone (a timestamp is always in GMT: the number of seconds
|
|
* since January 1 1970 00:00:00 GMT)
|
|
*/
|
|
static function gmt_date($timestamp) {
|
|
return gmdate('D, d M Y H:i:s', $timestamp) . ' GMT';
|
|
}
|
|
|
|
/*
|
|
* Return static variable cache_age in second
|
|
*/
|
|
static function get_cache_age() {
|
|
return self::$cache_age;
|
|
}
|
|
|
|
}
|
|
|
|
|