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 3baa43b44e Merge branch '2.4'
* 2.4: (52 commits)
  Fix #8205 : Deprecate file mode update when calling dumpFile
  Fix #10437: Catch exceptions when reloading a no-cache request
  Fix libxml_use_internal_errors and libxml_disable_entity_loader usage
  removed ini check to make uploadedfile work on gae
  Update OptionsResolver.php
  fixed comment in forms.xml file
  Clean KernelInterface docblocks
  Cast the group name as a string
  Fixed doc of InitAclCommand
  [Form] Fix "Array was modified outside object" in ResizeFormListener.
  Fix IBAN validator
  [Process] Remove unreachable code + avoid skipping tests in sigchild environment
  Fixed bug that incorrectly causes the "required" attribute to be omitted from select even though it contains the "multiple" attribute
  Added travis_retry to .travis.yml
  [Process] fix some typos and refactor some code
  [Process] Fix unit tests in sigchild disabled environment
  [Process] Trow exceptions in case a Process method is supposed to be called after termination
  fixed typo
  [Process] fixed fatal errors in getOutput and getErrorOutput when process was not started
  [Process] Fix escaping on Windows
  ...

Conflicts:
	src/Symfony/Bundle/FrameworkBundle/Command/ServerRunCommand.php
	src/Symfony/Component/Form/Extension/Core/EventListener/ResizeFormListener.php
	src/Symfony/Component/Process/Process.php
	src/Symfony/Component/Process/ProcessPipes.php
	src/Symfony/Component/Process/Tests/AbstractProcessTest.php
2014-03-26 12:51:10 +01:00
..
File Merge branch '2.3' into 2.4 2014-03-26 12:35:33 +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.4' 2014-03-26 12:51:10 +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 [HttpFoundation] Add ability to change JSON encoding options 2014-01-07 13:28:26 +01:00
composer.json Merge branch '2.4' 2014-03-26 12:51:10 +01: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 [HttpFoundation] JsonResponse::setEncodingOptions accepts also integer 2014-01-07 14:19:33 +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