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 76fbd89e02 Merge branch '2.3' into 2.4
* 2.3:
  [Process] Fix #9160 : escaping an argument with a trailing backslash on windows fails
  [Process] Fix some unit tests that create the process object instead of delegate it to the implementation
  [Process] Make process tests more accurate on exception messages
  [Process] Fix process status in TTY mode
  [Process] Use assertSame instead of assertEquals to avoid comparison against `null`
  [HttpFoundation] added some unit tests
  10158 get vary multiple
  made Cookie stringification more robust
  [Yaml] fix for a HHVM bug
2014-03-12 19:29:58 +01:00
..
File Merge branch '2.3' into 2.4 2014-02-11 14:52:09 +01:00
Resources/stubs Nsdocblocks 2012-10-20 09:10:30 +02:00
Session Merge branch '2.3' into 2.4 2014-01-01 09:14:50 +01:00
Tests Merge branch '2.3' into 2.4 2014-03-12 19:29:58 +01:00
.gitignore Added missing files .gitignore 2013-07-21 14:12:18 +02:00
AcceptHeader.php [HttpFoundation] fix #6002 2012-11-13 17:57:35 +01:00
AcceptHeaderItem.php fixed CS for lambdas 2013-12-28 08:46:05 +01: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.3' into 2.4 2013-12-26 08:59:03 +01:00
CHANGELOG.md moved RequestStack to HttpFoundation and removed RequestContext 2013-09-08 07:38:03 +02:00
composer.json updated version to 2.4 2013-05-16 09:54:39 +02:00
Cookie.php Merge branch '2.1' into 2.2 2013-04-20 21:05:29 +02:00
ExpressionRequestMatcher.php [HttpFoundation] added ExpressionRequestMatcher 2013-09-19 12:59:11 +02:00
FileBag.php [HttpFoundation] fixed typo 2014-01-28 16:07:56 +01:00
HeaderBag.php unify constructor initialization style throughout symfony 2013-11-11 19:40:07 +01:00
IpUtils.php Improve documentation of X-Forwarded-For header handling 2013-10-16 17:16:00 +02:00
JsonResponse.php Merge branch '2.3' into 2.4 2013-12-31 14:43:26 +01:00
LICENSE update year on licenses 2014-01-07 08:19:25 -05:00
ParameterBag.php Fixed CS 2013-07-21 03:30:39 +01:00
phpunit.xml.dist made usage of Composer autoloader for subtree-split unit tests 2012-11-09 14:10:06 +01:00
README.md updated the composer install command to reflect changes in Composer 2013-09-18 09:27:26 +02:00
RedirectResponse.php fixed acronyms 2013-12-28 09:33:14 +01:00
Request.php Merge branch '2.3' into 2.4 2014-01-05 03:10:50 +01:00
RequestMatcher.php fixed CS 2013-07-01 14:24:43 +02:00
RequestMatcherInterface.php fixed CS 2012-07-09 14:54:20 +02:00
RequestStack.php [HttpKernel] made request stack feature BC 2013-09-17 18:23:22 +02:00
Response.php Merge branch '2.3' into 2.4 2014-03-12 19:29:58 +01:00
ResponseHeaderBag.php [HttpFoundation] Fixed messed up headers 2013-02-26 10:42:13 +01:00
ServerBag.php Merge branch '2.2' into 2.3 (closes #8955) 2013-09-07 18:30:19 +02:00
StreamedResponse.php unify and fix callable phpdoc throughout symfony 2013-11-20 10:25:10 +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