http-message

Kigkonsult\Http\Message package provide PSR server-side

Message class

implements

• Psr\Http\Message\MessageInterface

Stream class

implements

• Psr\Http\Message\StreamInterface

(static) factory methods

• factoryFromString
• factoryFromResource

Response class

implements

• Psr\Http\Message\ResponseInterface
• Fig\Http\Message\StatusCodeInterface

added property:

• rawBody
  - response body (type mixed) before serialization/encoding

with methods:

• getRawBody()
• withRawBody()

MESSAGE class

implements

Psr\Http\Message\MessageInterface

constructor args: body, headers, protocolVersion

body - null|string|StreamInterface

headers - null|string[]

protocolVersion - null|string

 

STREAM class

implements

Psr\Http\Message\StreamInterface

constructor args: content, streamWrapper/resource, mode

content - null|string

streamWrapper - null|string|resource (defaults to 'php://memory')

mode - null|string (defaults to 'wb+')

with a (static) factory methods

factoryFromString( [ content [, streamWrapper [, mode ]]] )

content - null|string

streamWrapper - null|string (defaults to 'php://memory')

mode - null|string (defaults to 'wb+')

factoryFromResource( resource )

resource resource

RESPONSE class

extends

Message

implements

Psr\Http\Message\ResponseInterface

Fig\Http\Message\StatusCodeInterface

constructor args: body, status, headers

body - null|string|resource|StreamInterface

status - null|int (defaults to STATUS_OK, 200)

headers - null|array

 

The Response class has an added property:

rawBody

response body (type mixed) before serialization/encoding

in parallel with (Psr\Http\Message\)ServerRequest::parsedBody and (Psr\Http\Message\)ServerRequest::body

with corresponding methods:

getRawBody() - Return mixed rawBody

isRawBodyEmpty() - Return bool true on empty rawBody

withRawBody() - Return new instance with rawBody

 

Two rawBody/body methods

getResponseBody()

Return mixed

1 rawBody if not empty

2 body if not empty

3 null

isBodyEmpty()

Return bool true if (serialized/encoded) body is empty

 

Also two statusCode methods add added:

assertStatusCode()

static, validates statusCode, throws InvalidArgumentException on error

isBodyLessResponse()

Return bool true on statusCode 1xx, 204 or 304