class Request

Executes requets.

Properties

protected string $scriptName Script name.
protected Parameters $query Get data.
protected Parameters $post Post data.
protected Cookies $cookies Cookie data.
protected Files $files File data.
protected Server $server Server info.
protected Headers $headers Request headers.
protected string $rawBody Raw request body.
protected Parameters $parsedBody Parsed request body.
protected string $contentType Content type.
protected array $trustedProxies Array of trusted proxy IP addresses.
protected string $ip Ip address of the client that made the request.
protected string $basePath Base path of the request.
protected string $baseURL Base URL of the request.
protected string $path Holds the request path.
protected array $language Request language.
protected string $languagePrefix Request language prefix.
protected string $method Which request method was used?
protected string $realMethod The actual request method that was used.
protected Route $route The route that matched the request.
protected array $attributes Request attribuntes.

Methods

__construct(array $request = [], Signer|null $signer = null)

Constructor.

string
stripLocaleSegment(array $languages, string $path)

Strips the locale segment from the path.

string
determinePath(array $languages)

Determines the request path.

string
determineMethod()

Determines the request method.

string
getContentType()

Returns the content type of the request body.

string
getScriptName()

Returns the base name of the script that handled the request.

setRoute(Route $route)

Set the route that matched the request.

Route|null
getRoute()

Returns the route that matched the request.

setAttribute(string $name, mixed $value)

Sets a request attribute.

mixed
getAttribute(string $name, mixed $default = null)

Gets a request attribute.

string
getRawBody()

Returns the raw request body.

resource
getRawBodyAsStream()

Returns the raw request body as a stream.

getQuery()

Returns the query string.

getPost()

Returns the post data.

getCookies()

Returns the cookies.

getFiles()

Returns the files.

getServer()

Returns the files.

getHeaders()

Returns the files.

getBody()

Returns the parsed request body.

bool
hasFormData()

Returns true if the request has form data and false if not.

getData()

Returns the data of the current request method.

setTrustedProxies(array $trustedProxies)

Set the trusted proxies.

string
getIp()

Returns the ip of the client that made the request.

bool
isAjax()

Returns true if the request was made using Ajax and false if not.

bool
isSecure()

Returns true if the request was made using HTTPS and false if not.

bool
isSafe()

Returns true if the request method is considered safe and false if not.

bool
isCGI()

Is PHP running as a CGI program?

string
getBasePath()

Returns the base path of the request.

string
getBaseURL()

Returns the base url of the request.

string
getPath()

Returns the request path.

bool
isClean()

Returns true if the resource was requested with a "clean" URL and false if not.

array|null
getLanguage()

Returns the request language.

string|null
getLanguagePrefix()

Returns the request language prefix.

string
getMethod()

Returns the request method that was used.

string
getRealMethod()

Returns the real request method that was used.

bool
isFaked()

Returns true if the request method has been faked and false if not.

string|null
getUsername()

Returns the basic HTTP authentication username or null.

string|null
getPassword()

Returns the basic HTTP authentication password or null.

mixed
getReferrer(mixed $default = null)

Returns the referrer.

Details

at line 203
__construct(array $request = [], Signer|null $signer = null)

Constructor.

Parameters

array $request Request data and options
Signer|null $signer Signer instance used to validate signed cookies

at line 235
protected string stripLocaleSegment(array $languages, string $path)

Strips the locale segment from the path.

Parameters

array $languages Locale segments
string $path Path

Return Value

string

at line 260
protected string determinePath(array $languages)

Determines the request path.

Parameters

array $languages Locale segments

Return Value

string

at line 302
protected string determineMethod()

Determines the request method.

Return Value

string

at line 320
string getContentType()

Returns the content type of the request body.

An empty string will be returned if the header is missing.

Return Value

string

at line 335
string getScriptName()

Returns the base name of the script that handled the request.

Return Value

string

at line 345
setRoute(Route $route)

Set the route that matched the request.

Parameters

Route $route Route

at line 355
Route|null getRoute()

Returns the route that matched the request.

Return Value

Route|null

at line 366
setAttribute(string $name, mixed $value)

Sets a request attribute.

Parameters

string $name Attribute name
mixed $value Attribute value

at line 378
mixed getAttribute(string $name, mixed $default = null)

Gets a request attribute.

Parameters

string $name Attribute name
mixed $default Default value

Return Value

mixed

at line 388
string getRawBody()

Returns the raw request body.

Return Value

string

at line 403
resource getRawBodyAsStream()

Returns the raw request body as a stream.

Return Value

resource

at line 413
Parameters getQuery()

Returns the query string.

Return Value

Parameters

at line 423
Parameters getPost()

Returns the post data.

Return Value

Parameters

at line 433
Cookies getCookies()

Returns the cookies.

Return Value

Cookies

at line 443
Files getFiles()

Returns the files.

Return Value

Files

at line 453
Server getServer()

Returns the files.

Return Value

Server

at line 463
Headers getHeaders()

Returns the files.

Return Value

Headers

at line 473
Body getBody()

Returns the parsed request body.

Return Value

Body

at line 488
protected bool hasFormData()

Returns true if the request has form data and false if not.

Return Value

bool

at line 505
Parameters getData()

Returns the data of the current request method.

Return Value

Parameters

at line 524
setTrustedProxies(array $trustedProxies)

Set the trusted proxies.

Parameters

array $trustedProxies Array of trusted proxy IP addresses

at line 534
string getIp()

Returns the ip of the client that made the request.

Return Value

string

at line 576
bool isAjax()

Returns true if the request was made using Ajax and false if not.

Return Value

bool

at line 586
bool isSecure()

Returns true if the request was made using HTTPS and false if not.

Return Value

bool

at line 596
bool isSafe()

Returns true if the request method is considered safe and false if not.

Return Value

bool

at line 606
bool isCGI()

Is PHP running as a CGI program?

Return Value

bool

at line 616
string getBasePath()

Returns the base path of the request.

Return Value

string

at line 633
string getBaseURL()

Returns the base url of the request.

Return Value

string

at line 668
string getPath()

Returns the request path.

Return Value

string

at line 678
bool isClean()

Returns true if the resource was requested with a "clean" URL and false if not.

Return Value

bool

at line 688
array|null getLanguage()

Returns the request language.

Return Value

array|null

at line 698
string|null getLanguagePrefix()

Returns the request language prefix.

Return Value

string|null

at line 708
string getMethod()

Returns the request method that was used.

Return Value

string

at line 718
string getRealMethod()

Returns the real request method that was used.

Return Value

string

at line 728
bool isFaked()

Returns true if the request method has been faked and false if not.

Return Value

bool

at line 738
string|null getUsername()

Returns the basic HTTP authentication username or null.

Return Value

string|null

at line 748
string|null getPassword()

Returns the basic HTTP authentication password or null.

Return Value

string|null

at line 759
mixed getReferrer(mixed $default = null)

Returns the referrer.

Parameters

mixed $default Value to return if no referrer is set

Return Value

mixed