Http/Response.php

+ Show: +

inherited

+ Classes +
- \Zend_Http_Response

+ Table of Contents +

Zend Framework

LICENSE

+ +

This source file is subject to the new BSD license that is bundled +with this package in the file LICENSE.txt. +It is also available through the world-wide-web at this URL: +http://framework.zend.com/license/new-bsd +If you did not receive a copy of the license and are unable to +obtain it through the world-wide-web, please send an email +to license@zend.com so we can send you a copy immediately.

Category: Zend + +
Copyright: Copyright (c) 2005-2012 Zend Technologies USA Inc. (http://www.zend.com) + +
License: New BSD License + +
Package: Zend_Http + +
Subpackage: Response + +
Version: $Id: Response.php 25081 2012-11-06 20:59:47Z rob $ + +

\Zend_Http_Response
jump to top

Package: Zend\Http\Response

Zend_Http_Response represents an HTTP 1.0 / 1.1 response message.

It +includes easy access to all the response's different elemts, as well as some +convenience methods for parsing and validating HTTP responses.

Children: \Zend_Http_Response_Stream
Copyright: Copyright (c) 2005-2012 Zend Technologies USA Inc. (http://www.zend.com) + +
License: New BSD License + +

Properties

string $body

The HTTP response body

Details

Type: string

int $code

The HTTP response code

Details

Type: int

array $headers = array()

The HTTP response headers array

Default valuearray()Details

Type: array

string $message

The HTTP response code as string +(e.g.

'Not Found' for 404 or 'Internal Server Error' for 500)

Details

Type: string

array $messages = array(100 => 'Continue', 101 => 'Switching Protocols', 200 => 'OK', 201 => 'Created', 202 => 'Accepted', 203 => 'Non-Authoritative Information', 204 => 'No Content', 205 => 'Reset Content', 206 => 'Partial Content', 300 => 'Multiple Choices', 301 => 'Moved Permanently', 302 => 'Found', 303 => 'See Other', 304 => 'Not Modified', 305 => 'Use Proxy', 307 => 'Temporary Redirect', 400 => 'Bad Request', 401 => 'Unauthorized', 402 => 'Payment Required', 403 => 'Forbidden', 404 => 'Not Found', 405 => 'Method Not Allowed', 406 => 'Not Acceptable', 407 => 'Proxy Authentication Required', 408 => 'Request Timeout', 409 => 'Conflict', 410 => 'Gone', 411 => 'Length Required', 412 => 'Precondition Failed', 413 => 'Request Entity Too Large', 414 => 'Request-URI Too Long', 415 => 'Unsupported Media Type', 416 => 'Requested Range Not Satisfiable', 417 => 'Expectation Failed', 500 => 'Internal Server Error', 501 => 'Not Implemented', 502 => 'Bad Gateway', 503 => 'Service Unavailable', 504 => 'Gateway Timeout', 505 => 'HTTP Version Not Supported', 509 => 'Bandwidth Limit Exceeded')

static

List of all known HTTP response codes - used by responseCodeAsText() to +translate numeric codes to messages.

Default value

array(100 => 'Continue', 101 => 'Switching Protocols', 200 => 'OK', 201 => 'Created', 202 => 'Accepted', 203 => 'Non-Authoritative Information', 204 => 'No Content', 205 => 'Reset Content', 206 => 'Partial Content', 300 => 'Multiple Choices', 301 => 'Moved Permanently', 302 => 'Found', 303 => 'See Other', 304 => 'Not Modified', 305 => 'Use Proxy', 307 => 'Temporary Redirect', 400 => 'Bad Request', 401 => 'Unauthorized', 402 => 'Payment Required', 403 => 'Forbidden', 404 => 'Not Found', 405 => 'Method Not Allowed', 406 => 'Not Acceptable', 407 => 'Proxy Authentication Required', 408 => 'Request Timeout', 409 => 'Conflict', 410 => 'Gone', 411 => 'Length Required', 412 => 'Precondition Failed', 413 => 'Request Entity Too Large', 414 => 'Request-URI Too Long', 415 => 'Unsupported Media Type', 416 => 'Requested Range Not Satisfiable', 417 => 'Expectation Failed', 500 => 'Internal Server Error', 501 => 'Not Implemented', 502 => 'Bad Gateway', 503 => 'Service Unavailable', 504 => 'Gateway Timeout', 505 => 'HTTP Version Not Supported', 509 => 'Bandwidth Limit Exceeded')

Details

Type: array

string $version

The HTTP version (1.0, 1.1)

Details

Type: string

Methods

__construct(int $code, array $headers, string $body = null, string $version = '1.1', string $message = null) : void

HTTP response constructor

In most cases, you would use Zend_Http_Response::fromString to parse an HTTP +response string and create a new Zend_Http_Response object.

+ +

NOTE: The constructor no longer accepts nulls or empty values for the code and +headers and will throw an exception if the passed values do not form a valid HTTP +responses.

+ +

If no message is passed, the message will be guessed according to the response code.

Parameters

Name	Type	Description
$code	int	Response code (200, 404, ...) +
$headers	array	Headers array
$body	string	Response body
$version	string	HTTP version
$message	string	Response code as text

Throws

Exception	Description
\Zend_Http_Exception

__toString() : string

Implements magic __toString()

Returns

Type	Description
string

asString(string $br = "\n") : string

Get the entire response as string

Parameters

Name	Type	Description
$br	string	Line breaks (eg. "\n", "\r\n", " ") +

Returns

Type	Description
string

decodeChunkedBody(string $body) : string

static

Decode a "chunked" transfer-encoded body and return the decoded text

Parameters

Name	Type	Description
$body	string

Returns

Type	Description
string

decodeDeflate(string $body) : string

static

Decode a zlib deflated message (when Content-encoding = deflate)

Currently requires PHP with zlib support

Parameters

Name	Type	Description
$body	string

Returns

Type	Description
string

decodeGzip(string $body) : string

static

Decode a gzip encoded message (when Content-encoding = gzip)

Currently requires PHP with zlib support

Parameters

Name	Type	Description
$body	string

Returns

Type	Description
string

extractBody(string $response_str) : string

static

Extract the body from a response string

Parameters

Name	Type	Description
$response_str	string

Returns

Type	Description
string

extractCode(string $response_str) : int

static

Extract the response code from a response string

Parameters

Name	Type	Description
$response_str	string

Returns

Type	Description
int

extractHeaders(string $response_str) : array

static

Extract the headers from a response string

Parameters

Name	Type	Description
$response_str	string

Returns

Type	Description
array

extractMessage(string $response_str) : string

static

Extract the HTTP message from a response

Parameters

Name	Type	Description
$response_str	string

Returns

Type	Description
string

extractVersion(string $response_str) : string

static

Extract the HTTP version from a response

Parameters

Name	Type	Description
$response_str	string

Returns

Type	Description
string

fromString(string $response_str) : \Zend_Http_Response

static

Create a new Zend_Http_Response object from a string

Parameters

Name	Type	Description
$response_str	string

Returns

Type	Description
\Zend_Http_Response

getBody() : string

Get the response body as string

This method returns the body of the HTTP response (the content), as it +should be in it's readable version - that is, after decoding it (if it +was decoded), deflating it (if it was gzip compressed), etc.

+ +

If you want to get the raw body (as transfered on wire) use +$this->getRawBody() instead.

Returns

Type	Description
string

getHeader(\string$header $header) : string | array | null

Get a specific header as string, or null if it is not set

Parameters

Name	Type	Description
$header	\string$header

Returns

Type	Description
string \| array \| null

getHeaders() : array

Get the response headers

Returns

Type	Description
array

getHeadersAsString(boolean $status_line = true, string $br = "\n") : string

Get all headers as string

Parameters

Name	Type	Description
$status_line	boolean	Whether to return the first status line (IE "HTTP 200 OK") +
$br	string	Line breaks (eg. "\n", "\r\n", " ") +

Returns

Type	Description
string

getMessage() : string

Return a message describing the HTTP response code +(Eg.

"OK", "Not Found", "Moved Permanently")

Returns

Type	Description
string

getRawBody() : string

Get the raw response body (as transfered "on wire") as string

If the body is encoded (with Transfer-Encoding, not content-encoding - +IE "chunked" body), gzip compressed, etc. it will not be decoded.

Returns

Type	Description
string

getStatus() : int

Get the HTTP response status code

Returns

Type	Description
int

getVersion() : string

Get the HTTP version of the response

Returns

Type	Description
string

isError() : boolean

Check whether the response is an error

Returns

Type	Description
boolean

isRedirect() : boolean

Check whether the response is a redirection

Returns

Type	Description
boolean

isSuccessful() : boolean

Check whether the response in successful

Returns

Type	Description
boolean

responseCodeAsText(int $code = null, boolean $http11 = true) : string

static

A convenience function that returns a text representation of +HTTP response codes.

Returns 'Unknown' for unknown codes. +Returns array of all codes, if $code is not specified.

+ +

Conforms to HTTP/1.1 as defined in RFC 2616 (except for 'Unknown') +See http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10 for reference

Parameters

Name	Type	Description
$code	int	HTTP response code
$http11	boolean	Use HTTP version 1.1

Returns

Type	Description
string

Http/Response.php

\Zend_Http_Responsejump to top

Properties

Methods

\Zend_Http_Response
jump to top