..code-block::xml

..code-block::php

InputArgument::REQUIRED The argument is required

InputArgument::OPTIONAL The argument is optional and therefore can be omitted

InputArgument::IS_ARRAY The argument cancancontain an indefinite number of arguments and must be used at the end of the argument list

InputArgument::IS_ARRAY The argument can contain an indefinite number of arguments and must be used at the end of the argument list

You can combine ``IS_ARRAY`` with ``REQUIRED`` and ``OPTIONAL`` like this::

Request

The most common way to create request is to base it on the current PHP global

The most common way to createarequest is to base it on the current PHP global

variables with

:method:`Symfony\\Component\\HttpFoundation\\Request::createFromGlobals`::

* ``server``: equivalent of ``$_SERVER``;

* ``headers``: mostly equivalent to a sub-set of ``$_SERVER``

(``$request->headers->get('Content-Type')``).

(``$request->headers->get('User-Agent')``).

Each property is a:class:`Symfony\\Component\\HttpFoundation\\ParameterBag`

instance (or a sub-class of), which is a data holder class:

parameter value converted to integer;

*:method:`Symfony\\Component\\HttpFoundation\\ParameterBag::filter`: Filters the

parameter by using the PHP``filter_var()`` function.

parameter by using the PHP:phpfunction:`filter_var` function.

All getters takes up to three arguments: the first one is the parameter name

and the second one is the default value to return if the parameter does not

``foo[bar]=bar`` in a special way as it creates an array. So you can get the

``foo`` parameter and you will get back an array with a ``bar`` element. But

sometimes, you might want to get the value for the "original" parameter name:

``foo[bar]``. This is possible with all the `ParameterBag` getters like

``foo[bar]``. This is possible with all the ``ParameterBag`` getters like

:method:`Symfony\\Component\\HttpFoundation\\Request::get` via the third

argument::

:class:`Symfony\\Component\\HttpFoundation\\ParameterBag`. This is mostly used

to attach information that belongs to the Request and that needs to be

accessed from many different points in your application. For information

on how this is used in the Symfony2 framework, see:ref:`read more<book-fundamentals-attributes>`.

on how this is used in the Symfony2 framework, see

:ref:`the Symfony2 book<book-fundamentals-attributes>`.

Identifying a Request

Simulating a Request

Instead of creating aRequest based on the PHP globals, you can also simulate

aRequest::

Instead of creating arequest based on the PHP globals, you can also simulate

arequest::

The:method:`Symfony\\Component\\HttpFoundation\\Request::create` method

creates a request based on apath info, a method and some parameters (the

creates a request based on aURI, a method and some parameters (the

query parameters or the request ones depending on the HTTP method); and of

course, you can also override all other variables as well (by default, Symfony

creates sensible defaults for all the PHP global variables).

..tip::

You can also duplicate an existingquery via

You can also duplicate an existingrequest via

:method:`Symfony\\Component\\HttpFoundation\\Request::duplicate` or

change a bunch of parameters with a single call to

:method:`Symfony\\Component\\HttpFoundation\\Request::initialize`.

Accessing the Session

If you have a session attached to theRequest, you can access it via the

If you have a session attached to therequest, you can access it via the

:method:`Symfony\\Component\\HttpFoundation\\Request::getSession` method;

the

:method:`Symfony\\Component\\HttpFoundation\\Request::hasPreviousSession`

method tells you if the request contains aSession which was started in one of

method tells you if the request contains asession which was started in one of

the previous requests.

Accessing `Accept-*` Headers Data

returns the list of accepted languages ordered by descending quality;

*:method:`Symfony\\Component\\HttpFoundation\\Request::getCharsets`:

returns the list of accepted charsets ordered by descending quality;

returns the list of accepted charsets ordered by descending quality.

..versionadded::2.2

The:class:`Symfony\\Component\\HttpFoundation\\AcceptHeader` class is new in Symfony 2.2.

Accessing other Data

The Request class has many other methods that you can use to access the

request information. Have a look at the API for more information about them.

The ``Request`` class has many other methods that you can use to access the

request information. Have a look at

:class:`the Request API<Symfony\\Component\\HttpFoundation\\Request>`

for more information about them.

Response