Symfony2 API
Class

Symfony\Component\HttpFoundation\Request

class Request

Request represents an HTTP request.

Properties

ParameterBag $attributes
ParameterBag $request
ParameterBag $query
ServerBag $server
FileBag $files
ParameterBag $cookies
HeaderBag $headers

Methods

__construct(array $query = array(), array $request = array(), array $attributes = array(), array $cookies = array(), array $files = array(), array $server = array(), string $content = null)

Constructor.
initialize(array $query = array(), array $request = array(), array $attributes = array(), array $cookies = array(), array $files = array(), array $server = array(), string $content = null)

Sets the parameters for this request.
static Request createFromGlobals()

Creates a new request with values from PHP's super globals.
static Request create(string $uri, string $method = 'GET', array $parameters = array(), array $cookies = array(), array $files = array(), array $server = array(), string $content = null)

Creates a Request based on a given URI and configuration.
duplicate(array $query = null, array $request = null, array $attributes = null, array $cookies = null, array $files = null, array $server = null)

Clones a request and overrides some of its parameters.
__clone()

Clones the current request.
string __toString()

Returns the request as a string.
overrideGlobals()

Overrides the PHP global variables according to this request instance.
static  trustProxyData()

Trusts $_SERVER entries coming from proxies.
mixed get(string $key, mixed $default = null, type $deep = false)

Gets a "parameter" value.
Session|null getSession()

Gets the Session.
boolean hasPreviousSession()

Whether the request contains a Session which was started in one of the previous requests.
boolean hasSession()

Whether the request contains a Session object.
setSession(Session $session)

Sets the Session.
string getClientIp(Boolean $proxy = false)

Returns the client IP address.
string getScriptName()

Returns current script name.
string getPathInfo()

Returns the path being requested relative to the executed script.
string getBasePath()

Returns the root path from which this request is executed.
string getBaseUrl()

Returns the root url from which this request is executed.
string getScheme()

Gets the request's scheme.
string getPort()

Returns the port on which the request is made.
string getHttpHost()

Returns the HTTP host being requested.
string getRequestUri()

Returns the requested URI.
string getUri()

Generates a normalized URI for the Request.
string getUriForPath(string $path)

Generates a normalized URI for the given path.
string|null getQueryString()

Generates the normalized query string for the Request.
Boolean isSecure()

Checks whether the request is secure or not.
string getHost()

Returns the host name.
setMethod(string $method)

Sets the request method.
string getMethod()

Gets the request method.
string getMimeType(string $format)

Gets the mime type associated with the format.
string getFormat(string $mimeType)

Gets the format associated with the mime type.
setFormat(string $format, string|array $mimeTypes)

Associates a format with mime types.
string getRequestFormat(string $default = 'html')

Gets the request format.
setRequestFormat(string $format)

Sets the request format.
setLocale($locale)

getLocale()

Boolean isMethodSafe()

Checks whether the method is safe or not.
string|resource getContent(Boolean $asResource = false)

Returns the request body content.
array getETags()

Gets the Etags.
isNoCache()

string|null getPreferredLanguage(array $locales = null)

Returns the preferred language.
array getLanguages()

Gets a list of languages acceptable by the client browser.
array getCharsets()

Gets a list of charsets acceptable by the client browser.
array getAcceptableContentTypes()

Gets a list of content types acceptable by the client browser
Boolean isXmlHttpRequest()

Returns true if the request is a XMLHttpRequest.
array splitHttpAcceptHeader(string $header)

Splits an Accept-* HTTP header.

Details

at line 101
public __construct(array $query = array(), array $request = array(), array $attributes = array(), array $cookies = array(), array $files = array(), array $server = array(), string $content = null)

Constructor.

Parameters

array $query The GET parameters
array $request The POST parameters
array $attributes The request attributes (parameters parsed from the PATH_INFO, ...)
array $cookies The COOKIE parameters
array $files The FILES parameters
array $server The SERVER parameters
string $content The raw body data

at line 121
public initialize(array $query = array(), array $request = array(), array $attributes = array(), array $cookies = array(), array $files = array(), array $server = array(), string $content = null)

Sets the parameters for this request.

This method also re-initializes all properties.

Parameters

array $query The GET parameters
array $request The POST parameters
array $attributes The request attributes (parameters parsed from the PATH_INFO, ...)
array $cookies The COOKIE parameters
array $files The FILES parameters
array $server The SERVER parameters
string $content The raw body data

at line 150
static public Request createFromGlobals()

Creates a new request with values from PHP's super globals.

Return Value

Request A new request

at line 179
static public Request create(string $uri, string $method = 'GET', array $parameters = array(), array $cookies = array(), array $files = array(), array $server = array(), string $content = null)

Creates a Request based on a given URI and configuration.

Parameters

string $uri The URI
string $method The HTTP method
array $parameters The request (GET) or query (POST) parameters
array $cookies The request cookies ($_COOKIE)
array $files The request files ($_FILES)
array $server The server parameters ($_SERVER)
string $content The raw body data

Return Value

Request A Request instance

at line 263
public duplicate(array $query = null, array $request = null, array $attributes = null, array $cookies = null, array $files = null, array $server = null)

Clones a request and overrides some of its parameters.

Parameters

array $query The GET parameters
array $request The POST parameters
array $attributes The request attributes (parameters parsed from the PATH_INFO, ...)
array $cookies The COOKIE parameters
array $files The FILES parameters
array $server The SERVER parameters

at line 304
public __clone()

Clones the current request.

Note that the session is not cloned as duplicated requests
are most of the time sub-requests of the main one.

at line 320
public string __toString()

Returns the request as a string.

Return Value

string The request

at line 335
public overrideGlobals()

Overrides the PHP global variables according to this request instance.

It overrides $_GET, $_POST, $_REQUEST, $_SERVER, $_COOKIE, and $_FILES.

at line 365
static public trustProxyData()

Trusts $_SERVER entries coming from proxies.

You should only call this method if your application
is hosted behind a reverse proxy that you manage.

at line 386
public mixed get(string $key, mixed $default = null, type $deep = false)

Gets a "parameter" value.

This method is mainly useful for libraries that want to provide some flexibility.

Order of precedence: GET, PATH, POST, COOKIE
Avoid using this method in controllers:
* slow
* prefer to get from a "named" source

Parameters

string $key the key
mixed $default the default value
type $deep is parameter deep in multidimensional array

Return Value

mixed

at line 398
public Session|null getSession()

Gets the Session.

Return Value

Session|null The session

at line 411
public boolean hasPreviousSession()

Whether the request contains a Session which was started in one of the previous requests.

Return Value

boolean

at line 424
public boolean hasSession()

Whether the request contains a Session object.

Return Value

boolean

at line 436
public setSession(Session $session)

Sets the Session.

Parameters

Session $session The Session

at line 450
public string getClientIp(Boolean $proxy = false)

Returns the client IP address.

Parameters

Boolean $proxy Whether the current request has been made behind a proxy or not

Return Value

string The client IP address

at line 472
public string getScriptName()

Returns current script name.

Return Value

string

at line 492
public string getPathInfo()

Returns the path being requested relative to the executed script.

The path info always starts with a /.

Suppose this request is instantiated from /mysite on localhost:

* http://localhost/mysite returns an empty string
* http://localhost/mysite/about returns '/about'
* http://localhost/mysite/about?var=1 returns '/about'

Return Value

string

at line 514
public string getBasePath()

Returns the root path from which this request is executed.

Suppose that an index.php file instantiates this request object:

* http://localhost/index.php returns an empty string
* http://localhost/index.php/page returns an empty string
* http://localhost/web/index.php return '/web'

Return Value

string

at line 535
public string getBaseUrl()

Returns the root url from which this request is executed.

The base URL never ends with a /.

This is similar to getBasePath(), except that it also includes the
script filename (e.g. index.php) if one exists.

Return Value

string

at line 551
public string getScheme()

Gets the request's scheme.

Return Value

string

at line 563
public string getPort()

Returns the port on which the request is made.

Return Value

string

at line 581
public string getHttpHost()

Returns the HTTP host being requested.

The port name will be appended to the host if it's non-standard.

Return Value

string

at line 600
public string getRequestUri()

Returns the requested URI.

Return Value

string

at line 618
public string getUri()

Generates a normalized URI for the Request.

Return Value

string A normalized URI for the Request

See also

getQueryString()

at line 637
public string getUriForPath(string $path)

Generates a normalized URI for the given path.

Parameters

string $path A path to use instead of the current one

Return Value

string The normalized URI for the path

at line 652
public string|null getQueryString()

Generates the normalized query string for the Request.

It builds a normalized query string, where keys/value pairs are alphabetized
and have consistent escaping.

Return Value

string|null A normalized query string for the Request

at line 683
public Boolean isSecure()

Checks whether the request is secure or not.

Return Value

Boolean

at line 701
public string getHost()

Returns the host name.

Return Value

string

at line 728
public setMethod(string $method)

Sets the request method.

Parameters

string $method

at line 743
public string getMethod()

Gets the request method.

The method is always an uppercased string.

Return Value

string The request method

at line 764
public string getMimeType(string $format)

Gets the mime type associated with the format.

Parameters

string $format The format

Return Value

string The associated mime type (null if not found)

at line 782
public string getFormat(string $mimeType)

Gets the format associated with the mime type.

Parameters

string $mimeType The associated mime type

Return Value

string The format (null if not found)

at line 809
public setFormat(string $format, string|array $mimeTypes)

Associates a format with mime types.

Parameters

string $format The format
string|array $mimeTypes The associated mime types (the preferred one must be the first as it will be used as the content type)

at line 833
public string getRequestFormat(string $default = 'html')

Gets the request format.

Here is the process to determine the format:

* format defined by the user (with setRequestFormat())
* _format request parameter
* $default

Parameters

string $default The default format

Return Value

string The request format

at line 849
public setRequestFormat(string $format)

Sets the request format.

Parameters

string $format The request format.

at line 854
public setLocale($locale)

Parameters

$locale

at line 863
public getLocale()

at line 879
public Boolean isMethodSafe()

Checks whether the method is safe or not.

Return Value

Boolean

at line 891
public string|resource getContent(Boolean $asResource = false)

Returns the request body content.

Parameters

Boolean $asResource If true, a resource will be returned

Return Value

string|resource The request body content or a resource to read the body stream.

at line 915
public array getETags()

Gets the Etags.

Return Value

array The entity tags

at line 920
public isNoCache()

at line 934
public string|null getPreferredLanguage(array $locales = null)

Returns the preferred language.

Parameters

array $locales An array of ordered available locales

Return Value

string|null The preferred locale

at line 958
public array getLanguages()

Gets a list of languages acceptable by the client browser.

Return Value

array Languages ordered in the user browser preferences

at line 1000
public array getCharsets()

Gets a list of charsets acceptable by the client browser.

Return Value

array List of charsets in preferable order

at line 1016
public array getAcceptableContentTypes()

Gets a list of content types acceptable by the client browser

Return Value

array List of content types in preferable order

at line 1035
public Boolean isXmlHttpRequest()

Returns true if the request is a XMLHttpRequest.

It works if your JavaScript library set an X-Requested-With HTTP header.
It is known to work with Prototype, Mootools, jQuery.

Return Value

Boolean true if the request is an XMLHttpRequest, false otherwise

at line 1047
public array splitHttpAcceptHeader(string $header)

Splits an Accept-* HTTP header.

Parameters

string $header Header to split

Return Value

array Array indexed by the values of the Accept-* header in preferred order