This repository has been archived on 2023-08-20. You can view files and clone it, but cannot push or open issues or pull requests.
symfony/src/Symfony/Component/HttpFoundation
Fabien Potencier b2e7ca3ca4 Merge branch '2.7'
* 2.7: (36 commits)
  [Debug] fix error message on double exception
  [Validator] make DateTime objects represented as strings in the violation message.
  [RFC] [DebugBundle] [HttpKernel] Avoid using container as dependency for DumpListener
  Upgrade information for the Translation component regarding the new LoggingTranslator class.
  [WebProfilerBundle] Remove usage of app.request in search bar template
  Fix initialized() with aliased services
  fix data type in docblock
  Rename Symfony2 to Symfony
  bumped Symfony version to 2.6.0
  updated VERSION for 2.6.0-BETA2
  updated CHANGELOG for 2.6.0-BETA2
  [Debug] fix ENT_SUBSTITUTE usage
  compare version using PHP_VERSION_ID
  backport #12489
  remove an unneeded check
  Remove block submit_widget
  reformat code as suggested by @fabpot
  Fix typo
  Make `\Request::get` more performant.
  properly set request attributes in controller test
  ...
2014-11-28 11:01:03 +01:00
..
File Merge branch '2.3' into 2.5 2014-10-26 08:41:27 +01:00
Resources/stubs Merge branch '2.5' 2014-07-28 15:20:53 +02:00
Session Merge branch '2.5' into 2.6 2014-11-28 11:00:40 +01:00
Tests Merge branch '2.5' into 2.6 2014-11-28 11:00:40 +01:00
.gitignore Added missing files .gitignore 2013-07-21 14:12:18 +02:00
AcceptHeader.php fixed types in phpdocs 2014-04-16 12:30:19 +02:00
AcceptHeaderItem.php fixed types in phpdocs 2014-04-16 12:30:19 +02:00
ApacheRequest.php [HttpFoundation] do not use server variable PATH_INFO because it is already decoded and thus symfony is fragile to double encoding of the path 2013-04-12 17:03:10 +02:00
BinaryFileResponse.php Merge branch '2.5' 2014-09-22 13:59:59 +02:00
CHANGELOG.md [HttpFoundation] implement different locking strategies for sessions 2014-10-02 20:16:41 +02:00
composer.json updated version to 3.0 2014-11-11 09:37:22 +01:00
Cookie.php fixed types in phpdocs 2014-04-16 12:30:19 +02:00
ExpressionRequestMatcher.php [HttpFoundation] added ExpressionRequestMatcher 2013-09-19 12:59:11 +02:00
FileBag.php Remove aligned '=>' and '=' 2014-10-26 08:30:58 +01:00
HeaderBag.php Merge branch '2.3' into 2.4 2014-06-06 05:56:41 +02:00
IpUtils.php fixed CS 2014-09-22 10:32:35 +02:00
JsonResponse.php Clear json_last_error 2014-09-22 17:58:58 +02:00
LICENSE update year on licenses 2014-01-07 08:19:25 -05:00
ParameterBag.php fixed CS 2014-09-22 10:32:35 +02:00
phpunit.xml.dist removed defaults from PHPUnit configuration 2014-07-07 12:13:42 +02:00
README.md [Doc] Use Markdown syntax highlighting 2014-10-01 07:38:33 +02:00
RedirectResponse.php use meta charset in layouts without legacy http-equiv 2014-10-09 18:42:17 +02:00
Request.php Merge branch '2.5' into 2.6 2014-11-21 17:08:03 +01:00
RequestMatcher.php [HttpFoundation] Add a way to match a specific scheme in RequestMatcher #10556 2014-06-03 23:09:07 +02:00
RequestMatcherInterface.php fixed types in phpdocs 2014-04-16 12:30:19 +02:00
RequestStack.php unified return null usages 2014-04-18 22:38:54 +02:00
Response.php Merge branch '2.3' into 2.5 2014-11-20 14:22:25 +01:00
ResponseHeaderBag.php Merge branch '2.5' 2014-10-26 08:46:28 +01:00
ServerBag.php fix parsing of Authorization header 2014-08-22 18:41:26 +02:00
StreamedResponse.php [HttpFoundation] Allow Cache-Control headers on StreamedResponse 2014-11-02 01:37:08 +01:00

HttpFoundation Component

HttpFoundation defines an object-oriented layer for the HTTP specification.

It provides an abstraction for requests, responses, uploaded files, cookies, sessions, ...

In this example, we get a Request object from the current PHP global variables:

use Symfony\Component\HttpFoundation\Request;
use Symfony\Component\HttpFoundation\Response;

$request = Request::createFromGlobals();
echo $request->getPathInfo();

You can also create a Request directly -- that's interesting for unit testing:

$request = Request::create('/?foo=bar', 'GET');
echo $request->getPathInfo();

And here is how to create and send a Response:

$response = new Response('Not Found', 404, array('Content-Type' => 'text/plain'));
$response->send();

The Request and the Response classes have many other methods that implement the HTTP specification.

Loading

If you are not using Composer but are using PHP 5.3.x, you must add the following to your autoloader:

// SessionHandlerInterface
if (!interface_exists('SessionHandlerInterface')) {
    $loader->registerPrefixFallback(__DIR__.'/../vendor/symfony/src/Symfony/Component/HttpFoundation/Resources/stubs');
}

Resources

You can run the unit tests with the following command:

$ cd path/to/Symfony/Component/HttpFoundation/
$ composer.phar install
$ phpunit