Download the PHP package jitsu/http without Composer

jitsu/http

This package defines an abstract, object-oriented interface for interacting with HTTP requests and responses, and implements this interface for the request and response data which are traditionally accessible by the PHP script through superglobal variables, global functions, etc. This makes it possible to decouple application code from the specifics of where requests come from and where responses go, enabling dependency injection and unit testing.

Do also take a look at PSR-7, which is designed to meet the same goals and, obviously, has more community traction.

This package is part of Jitsu.

Installation

Install this package with Composer:

Namespace

All classes and interfaces are defined under the namespace Jitsu. The main ones are defined under Jitsu\Http.

API

interface Jitsu\Http\RequestInterface

An abstract interface to an HTTP request.

$request_interface->getMethod()

Get the HTTP method used in the request.

$request_interface->getUri()

Get the raw URI sent in the request.

$request_interface->getProtocol()

Get the protocol/version string used in the request.

$request_interface->getScheme()

Get the scheme used in the request (http or https).

$request_interface->getHeader($name)

Look up a header sent in the request.

Returns the value of the header with the given name (case-insensitive), or null if the header was not sent.

$request_interface->getAllHeaders()

Get all of the headers sent in the request.

Returns an array mapping the original header names to their values.

$request_interface->getBody()

Get the request body as a single string.

$request_interface->getBodyStream()

Get a readable file stream handle to the request body.

$request_interface->getOriginIpAddress()

Get the IP address of the remote endpoint.

$request_interface->getOriginPort()

Get the port number of the remote endpoint.

interface Jitsu\Http\ResponseInterface

An abstract interface to an HTTP response.

$response_interface->setStatus($version, $code, $reason)

Set the HTTP status line of the response.

$response_interface->addHeader($name, $value)

Send an HTTP header in the response.

Does not override previously sent headers with the same name.

$response_interface->flushOutputBuffer()

Flush the PHP output buffer to the body of the response.

$response_interface->sentHeaders()

Determine whether the headers were sent.

If the headers were already sent, they may no longer be modified.

class Jitsu\Http\RequestBase

Implements RequestInterface.

An extension of RequestInterface which offers some utility methods.

$request_base->fullUrl()

Get the full request URL.

This includes the scheme, host name, path, and query string. This is in raw form and not URL-decoded.

$request_base->scheme()

Get the request scheme.

$request_base->protocol()

Get the protocol/version string used in the request.

$request_base->host()

Get the value of the Host header.

$request_base->method()

Get the HTTP method used in the request.

Always returned in upper case (e.g. 'GET', 'PUT', etc.).

$request_base->uri()

Get the raw URI sent in the request.

This consists of the path and query string of the request. Note that this is in raw form and not URL-decoded.

$request_base->path()

Get the path part of the request URI.

Note that this is in raw form and not URL-decoded.

$request_base->queryString()

Get the query string of the request URI.

Note that this is in raw form and not URL-decoded.

$request_base->form($name, $default = null)

Look up a form-encoded parameter from the request.

$request_base->formParams()

Get all of the form-encoded parameters from the request.

Returns an array mapping the names of the form-encoded parameters sent in the request to their values. All keys and values are decoded. The parameters are taken from the appropriate part of the request based on the HTTP method used. For GET, DELETE, etc. they are parsed from the query string, and otherwise they are parsed from the request body.

$request_base->header($name, $default = null)

Look up a header sent in the request.

$request_base->headers()

Get all headers sent in the request.

Returns an array mapping the original header names to their values.

$request_base->contentType()

Get the content type of the request.

$request_base->acceptableContentTypes()

Parse the Accept header into a list of acceptable content types.

Returns an associative array mapping content type strings to their respective quality ratings, ordered in descending order of quality.

$request_base->accepts($content_type)

Return whether the request will accept a certain content type.

$request_base->negotiateContentType($acceptable)

Determine the request's most acceptable content type.

Given an array of acceptable content types, returns the index of the content type with the highest quality rating in the Accept header. Returns null if no content type is acceptable.

$request_base->referer()

Alias of referrer.

Alias of the correctly spelled referrer. See \Jitsu\RequestBase::referrer().

$request_base->referrer()

Get the HTTP referrer URI or null if it was not sent.

$request_base->cookie($name, $default = null)

Look up a cookie sent in the request.

Parses and decodes the cookie value.

$request_base->cookies()

Get the cookies sent in the request.

Parses and decodes the cookie values.

TODO: This is currently not implemented.

$request_base->body()

Return the request body as a single string.

$request_base->bodyStream()

Return a readable file stream handle to the request body.

$request_base->originIpAddress()

Get the IP address of the remote endpoint.

$request_base->originPort()

Get the port number of the remote endpoint.

class Jitsu\Http\ResponseBase

Implements ResponseInterface.

An extension of ResponseInterface which offers some utility methods.

$response_base->setStatusCode($code, $reason = '')

Set the status code of the response.

abstract public function statusCode()

Get the current status code set on this response.

$response_base->setContentType($type)

Set the content type of the response.

$response_base->addCookie($name, $value, $attrs)

Add a cookie to the response.

TODO: This has yet to be implemented.

$response_base->redirect($url, $code, $reason = '')

Issue a redirect to another URL.

Note that this does NOT exit the current process. Keep in mind that relying on the client to respect this header and close the connection for you is potentially a huge security hole.

The response code is also set here. The response code should be a 3XX code.

$response_base->startOutputBuffering()

Start buffering PHP output.

$response_base->clearOutputBuffer()

Discard the contents of the PHP output buffer.

class Jitsu\Http\CurrentRequest

Extends RequestBase.

A sub-class of RequestBase and implementation of RequestInterface for the current HTTP request.

$current_request->getMethod()

$current_request->getUri()

$current_request->getProtocol()

$current_request->getScheme()

$current_request->getHeader($name)

$current_request->getAllHeaders()

$current_request->getBody()

$current_request->getBodyStream()

$current_request->getOriginIpAddress()

$current_request->getOriginPort()

$current_request->method()

$current_request->path()

$current_request->queryString()

$current_request->form($name, $default = null)

$current_request->formParams()

$current_request->cookie($name, $default = null)

$current_request->cookies()

$current_request->originIpAddress()

$current_request->originPort()

$current_request->timestamp()

class Jitsu\Http\CurrentResponse

Extends ResponseBase.

A sub-class of ResponseBase and implementation of ResponseInterface for the current HTTP response.

$current_response->setStatus($version, $code, $reason)

$current_response->setStatusCode($code, $reason = null)

$current_response->statusCode()

$current_response->addHeader($name, $value)

$current_response->addCookie($name, $value, $attrs = array()

$current_response->deleteCookie($name, $attrs)

$current_response->redirect($url, $code, $reason = null)

$current_response->flushOutputBuffer()

$current_response->sentHeaders()

class Jitsu\Request

Get information about the current HTTP request being processed.

The class \Jitsu\Http\CurrentRequest provides the same information through an object-oriented interface. It is recommended to use that instead.

Request::scheme()

Get the URI's scheme (http or https).

Request::protocol()

Get the protocol/version indicated in the HTTP request.

Request::host()

Get the value of the Host header.

Request::method()

Get the HTTP method used in the request (GET, POST, etc.).

Request::uri()

Get the full, raw request URI.

Request::queryString()

Get the query string of the URI.

Request::form($name, $default = null)

Look up a form-encoded parameter from the request.

Request::formParams()

Get all of the request's form-encoded parameters.

Request::header($name, $default = null)

Look up an HTTP header in the request.

Request::headers()

Get all HTTP headers sent with the request.

If PHP is running through Apache (the function apache_request_header is available), this should return the header names in their original case. Otherwise, they will be in lower case.

Request::cookie($name, $default = null)

Look up cookies sent in the request.

Request::cookies()

Get all cookies sent in the request as an array.

Request::body()

Slurp the raw input sent in the request body into a single string.

The result is cached, so this function may be called more than once.

Request::bodyStream()

Return a file stream handle to the request body.

Request::file($name)

Look up information about a file sent in a multipart-form request.

Request::files()

Get information about all files sent in a multipart-form request.

Request::saveFile($name, $dest_path)

Save a file uploaded as a multipart-form parameter.

Saves the file uploaded under the form parameter $name to the path $dest_path on the filesystem.

Request::originIpAddress()

Get the IP address of the remote endpoint.

Request::originPort()

Get the port number of the remote endpoint.

Request::timestamp()

Timestamp of the start of the request.

class Jitsu\Response

Utilities for building the current HTTP response about to be sent.

The class \Jitsu\Http\CurrentResponse provides the same capabilities through an object-oriented interface. It is recommended to use that instead.

Response::setStatus($version, $code, $reason)

Set the response status line.

Note that this is mutually exclusive with code.

Response::setStatusCode($code)

Set the response code.

Automatically sets an appropriate reason string.

Note that this is mutually exclusive with status.

Response::statusCode()

Get the currently set response code.

Response::addHeader($name, $value)

Set a header in the response.

Must be called before output is written, just like PHP header.

Does not override previously sent header with the same name.

Response::addCookie($name, $value, $expires = null, $path = null, $domain = null)

Set a cookie in the response.

Response::deleteCookie($name, $domain = null, $path = null)

Indicate in the response to delete a cookie.

Response::redirect($url, $code)

Issue an HTTP redirect.

Response::startOutputBuffering()

Start buffering PHP output.

Response::flushOutputBuffer()

Flush the PHP output buffer and stop buffering.

Response::clearOutputBuffer()

Discard the contents of the PHP output buffer and stop buffering.

Response::sentHeaders()

Determine whether the headers were sent.

If the headers were already sent, they may no longer be modified.

Response::bodyStream()

Get a handle to a writable file stream to the response body.