Contains the most low-level helpers methods in Kohana:
Class declared in SYSPATH/classes/HTTP.php on line 3.
The $protocollink to thisdefault protocol to use if it cannot be detected
string(8) "HTTP/1.1"Checks the browser cache to see the response needs to be returned, execution will halt and a 304 Not Modified will be sent if the browser cache is up to date.
Request
$request
required - Request Response
$response
required - Response string
$etag
= NULL - Resource ETag Response
publicstaticfunctioncheck_cache(Request$request, Response$response,$etag= null){// Generate an etag if necessaryif($etag== null) {$etag=$response->generate_etag();}// Set the ETag header$response->headers('etag',$etag);// Add the Cache-Control header if it is not already set// This allows etags to be used with max-age, etcif($response->headers('cache-control')) {$response->headers('cache-control',$response->headers('cache-control') .', must-revalidate');}else{$response->headers('cache-control','must-revalidate');}// Check if we have a matching etagif($request->headers('if-none-match') AND (string)$request->headers('if-none-match') ===$etag) {// No need to send data againthrowHTTP_Exception::factory(304)->headers('etag',$etag);}return$response;}
Parses a HTTP header string into an associative array
string
$header_string
required - Header string to parse HTTP_Header
publicstaticfunctionparse_header_string($header_string){// If the PECL HTTP extension is loadedif(extension_loaded('http')) {// Use the fast method to parse header string$headers= version_compare(phpversion('http'),'2.0.0','>=') ?\http\Header::parse($header_string) :http_parse_headers($header_string);returnnewHTTP_Header($headers);}// Otherwise we use the slower PHP parsing$headers= [];// Match all HTTP headersif(preg_match_all('/(\w[^\s:]*):[ ]*([^\r\n]*(?:\r\n[ \t][^\r\n]*)*)/',$header_string,$matches)) {// Parse each matched headerforeach($matches[0]as$key=>$value) {// If the header has not already been setif(!isset($headers[$matches[1][$key]])) {// Apply the header directly$headers[$matches[1][$key]] =$matches[2][$key];}// Otherwise there is an existing entryelse{// If the entry is an arrayif(is_array($headers[$matches[1][$key]])) {// Apply the new entry to the array$headers[$matches[1][$key]][] =$matches[2][$key];}// Otherwise create a new array with the entrieselse{$headers[$matches[1][$key]] = [$headers[$matches[1][$key]],$matches[2][$key],];}}}}// Return the headersreturnnewHTTP_Header($headers);}
Issues a HTTP redirect.
string
$uri
= string(0) "" - URI to redirect to int
$code
= integer 302 - HTTP Status code to use for the redirect
publicstaticfunctionredirect($uri='',$code= 302){$e= HTTP_Exception::factory($code);if(!$einstanceofHTTP_Exception_Redirect)thrownewKohana_Exception('Invalid redirect code \':code\'', [':code'=>$code]);throw$e->location($uri);}
Parses the the HTTP request headers and returns an array containing key value pairs. This method is slow, but provides an accurate representation of the HTTP request.
// Get http headers into the request$request->headers = HTTP::request_headers();
HTTP_Header
publicstaticfunctionrequest_headers(){// If running on apache serverif(function_exists('apache_request_headers')) {// Return the much faster methodreturnnewHTTP_Header(apache_request_headers());}// If the PECL HTTP tools are installedelseif(extension_loaded('http')) {// Return the much faster method$headers= version_compare(phpversion('http'),'2.0.0','>=') ?\http\Env::getRequestHeader() :http_get_request_headers();returnnewHTTP_Header($headers);}// Setup the output$headers= [];// Parse the content typeif(!empty($_SERVER['CONTENT_TYPE'])) {$headers['content-type'] =$_SERVER['CONTENT_TYPE'];}// Parse the content lengthif(!empty($_SERVER['CONTENT_LENGTH'])) {$headers['content-length'] =$_SERVER['CONTENT_LENGTH'];}foreach($_SERVERas$key=>$value) {// If there is no HTTP header here, skipif(strpos($key,'HTTP_') !== 0) {continue;}// This is a dirty hack to ensure HTTP_X_FOO_BAR becomes X-FOO-BAR$headers[str_replace('_','-',substr($key, 5))] =$value;}returnnewHTTP_Header($headers);}
Processes an array of key value pairs and encodes the values to meet RFC 3986
array
$params
= array(0) - Params string
publicstaticfunctionwww_form_urlencode(array$params= []){if(!$params)return;$encoded= [];foreach($paramsas$key=>$value) {$encoded[] =$key.'='. rawurlencode($value);}returnimplode('&',$encoded);}