Class Response

A response to a HTTP request.

ICanBoogie\HTTP\Response implements ICanBoogie\HTTP\ResponseStatus uses ICanBoogie\Accessor\AccessorTrait (not available)

Direct known subclasses

ICanBoogie\HTTP\FileResponse, ICanBoogie\HTTP\RedirectResponse

Namespace: ICanBoogie\HTTP
See: http://tools.ietf.org/html/rfc2616
Located at Response.php

Methods summary


				
				 public 
				
				

				__construct( mixed $body = null, integer|ICanBoogie\HTTP\Status $status = self::STATUS_OK, ICanBoogie\HTTP\Headers|array $headers = [] )

Initializes the $body, $header, $date and $status properties.


				
				 public 
				
				

				__clone( void )

Clones the ICanBoogie\HTTP\Response::$headers and $status properties.


				
				 public 
				
				

				__toString( void )
				

				: string

Renders the response as an HTTP string.


				
				 public 
				
				

				__invoke( void )

Issues the HTTP response.


				
				 protected 
				
				

				finalize( ICanBoogie\HTTP\Headers & $headers, mixed & $body )

Finalize the body.

Subclasses might want to override this method if they wish to alter the header or the body before the response is sent or transformed into a string.

Parameters

$headers: Reference to the final header.
$body: Reference to the final body.


				
				 protected 
				
				

				send_headers( ICanBoogie\HTTP\Headers $headers )


				
				 protected 
				
				

				send_body( mixed $body )

Sends response body.


				
				 protected 
				
				

				set_status( integer|ICanBoogie\HTTP\Status $status )

Sets response status code and optionally status message.


				
				 protected 
				
				

				get_status( void )
				

				: ICanBoogie\HTTP\Status

Returns the response status.


				
				 protected 
				
				

				set_body( string|Closure|null $body )

Sets the response body.

The body can be any data type that can be converted into a string. This includes numeric and objects implementing the ICanBoogie\HTTP\Response::__toString() method.

Parameters

$body

Throws

UnexpectedValueException
when the body cannot be converted to a string.


				
				 protected 
				
				

				assert_body_is_valid(  $body )

Asserts that the a body is valid.


				
				 protected 
				
				

				get_body( void )
				

				: string

Returns the response body.


				
				 protected 
				
				

				set_location( string|null $url )

Sets the value of the Location header field.


				
				 protected 
				
				

				get_location( void )
				

				: string

Returns the value of the Location header field.


				
				 protected 
				
				

				set_content_type( string $content_type )

Sets the value of the Content-Type header field.


				
				 protected 
				
				

				get_content_type( void )
				

				: ICanBoogie\HTTP\Headers\ContentType

Returns the value of the Content-Type header field.


				
				 protected 
				
				

				set_content_length( integer $length )

Sets the value of the Content-Length header field.


				
				 protected 
				
				

				get_content_length( void )
				

				: integer

Returns the value of the Content-Length header field.


				
				 protected 
				
				

				set_date( mixed $time )

Sets the value of the Date header field.


				
				 protected 
				
				

				get_date( void )
				

				: ICanBoogie\HTTP\Headers\Date

Returns the value of the Date header field.


				
				 protected 
				
				

				set_age( integer $age )

Sets the value of the Age header field.


				
				 protected 
				
				

				get_age( void )
				

				: integer

Returns the age of the response.


				
				 protected 
				
				

				set_last_modified( mixed $time )

Sets the value of the Last-Modified header field.


				
				 protected 
				
				

				get_last_modified( void )
				

				: ICanBoogie\HTTP\Headers\Date

Returns the value of the Last-Modified header field.


				
				 protected 
				
				

				set_expires( mixed $time )

Sets the value of the Expires header field.


				
				 protected 
				
				

				get_expires( void )
				

				: ICanBoogie\HTTP\Headers\Date

Returns the value of the Expires header field.


				
				 protected 
				
				

				set_etag( string $value )

Sets the value of the ETag header field.


				
				 protected 
				
				

				get_etag( void )
				

				: string

Returns the value of the ETag header field.


				
				 protected 
				
				

				set_cache_control( string $cache_directives )

Sets the directives of the Cache-Control header field.


				
				 protected 
				
				

				get_cache_control( void )
				

				: ICanBoogie\HTTP\Headers\CacheControl

Returns the Cache-Control header field.


				
				 protected 
				
				

				set_ttl( integer $seconds )

Sets the response's time-to-live for shared caches.


				
				 protected 
				
				

				get_ttl( void )
				

				: integer|null

Returns the response's time-to-live in seconds.

When the responses TTL is <= 0, the response may not be served from cache without first re-validating with the origin.

Returns

integer|null

The number of seconds to live, or null is no freshness information is present.


				
				 protected 
				
				

				get_is_validateable( void )
				

				: boolean

Checks that the response includes header fields that can be used to validate the response with the origin server using a conditional GET request.


				
				 protected 
				
				

				get_is_cacheable( void )
				

				: boolean

Checks that the response is worth caching under any circumstance.

Responses marked private with an explicit Cache-Control directive are considered not cacheable.

Responses with neither a freshness lifetime (Expires, max-age) nor cache validator (Last-Modified, ETag) are considered not cacheable.

Returns

boolean


				
				 protected 
				
				

				get_is_fresh( void )
				

				: boolean

Checks if the response is fresh.

Constants summary

Constants inherited from ICanBoogie\HTTP\ResponseStatus

STATUS_ACCEPTED, STATUS_BAD_GATEWAY, STATUS_BAD_REQUEST, STATUS_CONFLICT, STATUS_CONTINUE, STATUS_CREATED, STATUS_EXPECTATION_FAILED, STATUS_FORBIDDEN, STATUS_FOUND, STATUS_GATEWAY_TIMEOUT, STATUS_GONE, STATUS_HTTP_VERSION_NOT_SUPPORTED, STATUS_INTERNAL_SERVER_ERROR, STATUS_I_M_A_TEAPOT, STATUS_LENGTH_REQUIRED, STATUS_METHOD_NOT_ALLOWED, STATUS_MOVED_PERMANENTLY, STATUS_MULTIPLE_CHOICES, STATUS_NON_AUTHORITATIVE_INFORMATION, STATUS_NOT_ACCEPTABLE, STATUS_NOT_FOUND, STATUS_NOT_IMPLEMENTED, STATUS_NOT_MODIFIED, STATUS_NO_CONTENT, STATUS_OK, STATUS_PARTIAL_CONTENT, STATUS_PAYMENT_REQUIRED, STATUS_PRECONDITION_FAILED, STATUS_PROXY_AUTHENTICATION_REQUIRED, STATUS_REQUESTED_RANGE_NOT_SATISFIABLE, STATUS_REQUEST_ENTITY_TOO_LARGE, STATUS_REQUEST_TIMEOUT, STATUS_REQUEST_URI_TOO_LONG, STATUS_RESET_CONTENT, STATUS_SEE_OTHER, STATUS_SERVICE_UNAVAILABLE, STATUS_SWITCHING_PROTOCOLS, STATUS_TEMPORARY_REDIRECT, STATUS_UNAUTHORIZED, STATUS_UNSUPPORTED_MEDIA_TYPE, STATUS_USE_PROXY

Properties summary


				
				public  
				

				
$headers				

				: ICanBoogie\HTTP\Headers

Response headers.


				
				public  
				

				
$version				

				: string

The HTTP protocol version (1.0 or 1.1), defaults to '1.0'

'1.0'

Magic properties


				
				public  
				

				
$status				

				: ICanBoogie\HTTP\Status


				
				public  
				

				
$body				

				: mixed

The body of the response.


				
				public  
				

				
$ttl				

				: integer

Adjusts the s-maxage part of the Cache-Control header field definition according to the Age header field definition.


				
				public  
				

				
$age				

				: integer

Shortcut to the Age header field definition.


				
				public  
				

				
$cache_control				

				: ICanBoogie\HTTP\Headers\CacheControl

Shortcut to the Cache-Control header field definition.


				
				public  
				

				
$content_length				

				: integer

Shortcut to the Content-Length header field definition.


				
				public  
				

				
$content_type				

				: ICanBoogie\HTTP\Headers\ContentType

Shortcut to the Content-Type header field definition.


				
				public  
				

				
$date				

				: ICanBoogie\HTTP\Headers\Date

Shortcut to the Date header field definition.


				
				public  
				

				
$etag				

				: string

Shortcut to the ETag header field definition.


				
				public  
				

				
$expires				

				: ICanBoogie\HTTP\Headers\Date

Shortcut to the Expires header field definition.


				
				public  
				

				
$last_modified				

				: ICanBoogie\HTTP\Headers\Date

Shortcut to the Last-Modified header field definition.


				
				public  
				

				
$location				

				: string

Shortcut to the Location header field definition.


				
				public  read-only
				

				
$is_cacheable				

				: boolean

ICanBoogie\HTTP\Response::get_is_cacheable()


				
				public  read-only
				

				
$is_fresh				

				: boolean

ICanBoogie\HTTP\Response::get_is_fresh()


				
				public  read-only
				

				
$is_private				

				: boolean

get_is_private()


				
				public  read-only
				

				
$is_validateable				

				: boolean

ICanBoogie\HTTP\Response::get_is_validateable()