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 bool $isSecure Was this request made using HTTPS?
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.

bool
isTrustedProxy(string $ip)

Is this IP a trusted proxy?

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
isIdempotent()

Returns TRUE if the request method is considered idempotent and FALSE if not.

bool
isCacheable()

Returns TRUE if the request method is considered cacheable 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 211
__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 243
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 268
protected string determinePath(array $languages)

Determines the request path.

Parameters

array $languages Locale segments

Return Value

string

at line 310
protected string determineMethod()

Determines the request method.

Return Value

string

at line 328
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 343
string getScriptName()

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

Return Value

string

at line 353
setRoute(Route $route)

Set the route that matched the request.

Parameters

Route $route Route

at line 363
Route|null getRoute()

Returns the route that matched the request.

Return Value

Route|null

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

Sets a request attribute.

Parameters

string $name Attribute name
mixed $value Attribute value

at line 386
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 396
string getRawBody()

Returns the raw request body.

Return Value

string

at line 411
resource getRawBodyAsStream()

Returns the raw request body as a stream.

Return Value

resource

at line 421
Parameters getQuery()

Returns the query string.

Return Value

Parameters

at line 431
Parameters getPost()

Returns the post data.

Return Value

Parameters

at line 441
Cookies getCookies()

Returns the cookies.

Return Value

Cookies

at line 451
Files getFiles()

Returns the files.

Return Value

Files

at line 461
Server getServer()

Returns the files.

Return Value

Server

at line 471
Headers getHeaders()

Returns the files.

Return Value

Headers

at line 481
Body getBody()

Returns the parsed request body.

Return Value

Body

at line 496
protected bool hasFormData()

Returns TRUE if the request has form data and FALSE if not.

Return Value

bool

at line 513
Parameters getData()

Returns the data of the current request method.

Return Value

Parameters

at line 532
setTrustedProxies(array $trustedProxies)

Set the trusted proxies.

Parameters

array $trustedProxies Array of trusted proxy IP addresses

at line 543
protected bool isTrustedProxy(string $ip)

Is this IP a trusted proxy?

Parameters

string $ip IP address

Return Value

bool

at line 561
string getIp()

Returns the ip of the client that made the request.

Return Value

string

at line 600
bool isAjax()

Returns TRUE if the request was made using Ajax and FALSE if not.

Return Value

bool

at line 610
bool isSecure()

Returns TRUE if the request was made using HTTPS and FALSE if not.

Return Value

bool

at line 630
bool isSafe()

Returns TRUE if the request method is considered safe and FALSE if not.

Return Value

bool

at line 640
bool isIdempotent()

Returns TRUE if the request method is considered idempotent and FALSE if not.

Return Value

bool

at line 650
bool isCacheable()

Returns TRUE if the request method is considered cacheable and FALSE if not.

Return Value

bool

at line 660
bool isCGI()

Is PHP running as a CGI program?

Return Value

bool

at line 670
string getBasePath()

Returns the base path of the request.

Return Value

string

at line 687
string getBaseURL()

Returns the base url of the request.

Return Value

string

at line 722
string getPath()

Returns the request path.

Return Value

string

at line 732
bool isClean()

Returns TRUE if the resource was requested with a "clean" URL and FALSE if not.

Return Value

bool

at line 742
array|null getLanguage()

Returns the request language.

Return Value

array|null

at line 752
string|null getLanguagePrefix()

Returns the request language prefix.

Return Value

string|null

at line 762
string getMethod()

Returns the request method that was used.

Return Value

string

at line 772
string getRealMethod()

Returns the real request method that was used.

Return Value

string

at line 782
bool isFaked()

Returns TRUE if the request method has been faked and FALSE if not.

Return Value

bool

at line 792
string|null getUsername()

Returns the basic HTTP authentication username or null.

Return Value

string|null

at line 802
string|null getPassword()

Returns the basic HTTP authentication password or null.

Return Value

string|null

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

Returns the referrer.

Parameters

mixed $default Value to return if no referrer is set

Return Value

mixed