Request

About 6 min

Request

Application HTTP Request Class.

The HTTP request class is a representational object for an HTTP request. The Application object will create a HTTP request object upon each execution. This object contains all details of the current request including request data, headers and any request body content.

If you want to generate your own HTTP request object to pass to another method or function that requires one, see Hazaar\HTTP\Request.

Properties

id

public string $id

body

public string $body

session

public bool $session

dispatched

protected bool $dispatched

public  $

method

Request method.

protected string $method = 'GET'

server

Array of server variables, one line per element. Normally comes from $_SERVER but can be set via the constructor.

private array $server

get

Array of GET parameters, one line per element. Normally comes from $_GET but can be set via the constructor.

private array $get

post

Array of POST parameters, one line per element. Normally comes from $_POST but can be set via the constructor.

private array $post

path

The requested path.

private string $path

headers

Array of headers, one line per element.

private array $headers

attributes

An array of custom attributes set on the request.

private array $attributes

Methods

__construct

The Application HTTP request object.

public __construct(?array $server, ?array $get, ?array $post): void

This constructor will initialise the request object. It will parse the request URI and any request parameters and set them as properties of the object.

The constructor will also get all the request headers and the request content and from there will use the Hazaar\Application\Request parent class to determine the name of the Controller and Action that is being requested via it's evaluate() method.

Parameters

Parameter	Type	Description
`$server`	`array`	Optional reference to $_SERVER
`$get`	`array`	Optional reference to $_GET
`$post`	`array`	Optional reference to $_POST

__get

Magic method to get the value of a property.

public __get(string $key): mixed

Parameters

Parameter	Type	Description
`$key`	`string`	the name of the property to get

getId

Retrieves the unique identifier for the request.

public getId(): string

isGet

public isGet(): bool

Test if the request method is GET. This is a convenience method for quickly determining the request method.

isPut

public isPut(): bool

Test if the request method is PUT. This is a convenience method for quickly determining the request method.

isPost

public isPost(): bool

Test if the request method is POST. This is a convenience method for quickly determining the request method.

isDelete

public isDelete(): bool

Test if the request method is DELETE. This is a convenience method for quickly determining the request method.

getHeaders

public getHeaders(): void

Get all the HTTP request headers sent by the client browser.

hasHeader

public hasHeader(string $header): bool

Check if a header was sent in the HTTP request.

Parameters

Parameter	Type	Description
`$header`	`string`

getHeader

public getHeader(string $header): ?string

Get a single header value

Parameters

Parameter	Type	Description
`$header`	`string`

setHeader

Sets a header value for the request.

public setHeader(string $header, string $value): void

Parameters

Parameter	Type	Description
`$header`	`string`	the name of the header to set
`$value`	`string`	the value to assign to the header

getContentType

Return the current request content type.

public getContentType(): string

This is a helpful method for doing a few things in one go as it will only return a content type if the request is a POST method. Otherwise it will safely return a FALSE value.

isXmlHttpRequest

public isXmlHttpRequest(): bool

Test if the request originated from an XMLHttpRequest object. This object is used when sending an AJAX request from withing a JavaScript function. All of the major JavaScript libraries (jQuery, extJS, etc) will set the X-Requested-With header to indicate that the request is an AJAX request.

Using this in your application will allow you to determine how to respond to the request. For example, you might want to forgo rendering a view and instead return a JSON response.

redirectURI

public redirectURI(): ?string

Returns the URI of the page this request was redirected from.

getRequestBody

public getRequestBody(): string

Returns the body of the request. This will normally be null unless the request is a POST or PUT.

getJSONBody

public getJSONBody(?bool $assoc, int $depth = 512): mixed

Returns the JSON decoded body of the request. This will normally be null unless the request is a POST or PUT and content-type is application/json.

Parameters

Parameter	Type	Description
`$assoc`	`bool`
`$depth`	`int`

getURLBody

public getURLBody(): mixed

getXMLBody

public getXMLBody(): ?Element

getRemoteAddr

Get the remote IP address of the requesting host.

public getRemoteAddr(): ?string

This will try to determine the correct IP to return. By default it will return the $_SERVER['REMOTE_ADDR'] value, but if the connection is via a reverse proxy (such as Haproxy) then it will possibly have the standard X-Forwarded-For header, so if that header exists then that value will be returned.

isMobileDevice

Detect if a request originated on a mobile device.

public isMobileDevice(): bool

This method will return true to indicate that the requesting device is a mobile browser. It uses the freely available script from detectmobilebrowsers.com

referer

Get the referer URL from the HTTP request headers.

public referer(): ?string

getPath

Return the request path.

public getPath(bool $stripFilename): string

Parameters

Parameter	Type	Description
`$stripFilename`	`bool`	If true, this will cause the function to return anything before the last '/' (including the '/') which is the full directory path name. (Similar to dirname()).

getProtocol

public getProtocol(): string

getReferer

public getReferer(): ?string

getUserAgent

public getUserAgent(): ?string

setPath

Sets the path of the request.

public setPath(string $path): void

Parameters

Parameter	Type	Description
`$path`	`string`	the path of the request

get

Retrieve a value from the GET parameters.

public get(string $key): ?string

This method attempts to retrieve the value of the specified key from the $_GET superglobal. If the key does not exist, it returns null.

Parameters

Parameter	Type	Description
`$key`	`string`	the key of the GET parameter to retrieve

post

Retrieve a value from the POST parameters.

public post(string $key): ?string

This method attempts to retrieve the value of the specified key from the $_POST superglobal. If the key does not exist, it returns null.

Parameters

Parameter	Type	Description
`$key`	`string`	the key of the POST parameter to retrieve

param

Retrieve a parameter value from the request (GET or POST).

public param(string $key): ?string

This method attempts to retrieve the value of the specified key from the GET parameters first. If the key does not exist in GET, it will then attempt to retrieve it from the POST parameters.

Parameters

Parameter	Type	Description
`$key`	`string`	the key of the parameter to retrieve

getInt

Retrieve an integer value from the request.

public getInt(string $key): ?int

This method attempts to retrieve a parameter value from the request (via GET or POST), and returns it as an integer. If the parameter is not set, null is returned.

Parameters

Parameter	Type	Description
`$key`	`string`	The key of the request value to return

getFloat

Retrieve an float value from the request.

public getFloat(string $key): float

The most common requests will not provide data typing and data value will always be a string. This method will automatically return the requested value as an float unless it is NULL or not set. In which case either NULL or the default value will be returned.

Parameters

Parameter	Type	Description
`$key`	`string`	the key of the request value to return

getBool

Retrieve a boolean value from the request.

public getBool(string $key): bool

This method attempts to retrieve a parameter value from the request (via GET or POST), and returns it as a boolean using Hazaar\Util\Boolean::from().

Parameters

Parameter	Type	Description
`$key`	`string`	The key of the request value to return

has

Check to see if a request value has been set.

public has(string $keys, bool $checkAny): bool

Parameters

Parameter	Type	Description
`$keys`	`string`	the key of the request value to check for
`$checkAny`	`bool`	The check type when $key is an array. TRUE means that ANY key must exist. FALSE means ALL keys must exist.

getParams

Return an array of request parameters as key/value pairs.

public getParams(?array $filterIn, ?array $filterOut): void

Parameters

Parameter	Type	Description
`$filterIn`	`array`	only include parameters with keys specified in this filter
`$filterOut`	`array`	exclude parameters with keys specified in this filter

hasParams

Check if the request has any parameters.

public hasParams(): bool

count

Returns the number of parameters in the request.

public count(): int

isEmpty

public isEmpty(): bool

getMethod

public getMethod(): string

Returns the method used to initiate this request on the server. .

getRequestHeaders

Get the current request headers.

public getRequestHeaders(): void

This function will return the current request headers as an associative array.

setAttribute

Sets a request attribute.

public setAttribute(string $key, mixed $value): void

This method allows storing custom data or attributes within the request object. Attributes are often used to pass data between different parts of the application during the lifecycle of a request.

Parameters

Parameter	Type	Description
`$key`	`string`	the name of the attribute to set
`$value`	`mixed`	the value of the attribute

getAttribute

Retrieves a specific attribute by key.

public getAttribute(string $key): mixed

This method searches the request attributes for the given key and returns its value. If the key does not exist in the attributes list, it returns null.

Parameters

Parameter	Type	Description
`$key`	`string`	the key of the attribute to retrieve

Generated by Hazaar API Doc Generator on Sun, 01 Mar 2026 09:22:26 +0000