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 2cd6e002c7 feature#8957 [HttpFoundation] added a way to override the Request class (fabpot)
This PR was merged into the master branch.

Discussion
----------

[HttpFoundation] added a way to override the Request class

| Q             | A
| ------------- | ---
| Bug fix?      | no
| New feature?  | yes
| BC breaks?    | no
| Deprecations? | no
| Tests pass?   | yes
| Fixed tickets | #7461, #7453
| License       | MIT
| Doc PR        | symfony/symfony-docs#3021

This is an alternative implementation for #7461.

I've also reverted #7381 and #7390 as these changes are not needed anymore.

Todo:

 - [ ] add some tests

Commits
-------

464439d [HttpFoundation] added a way to override the Request class
2013-10-01 07:05:57 +02:00
..
File Merge branch '2.3' 2013-09-18 09:05:46 +02:00
Resources/stubs Nsdocblocks 2012-10-20 09:10:30 +02:00
Session [HttpFoundation] Add a way to avoid the session be written at each request 2013-09-30 10:45:51 -07:00
Tests feature#8957 [HttpFoundation] added a way to override the Request class (fabpot) 2013-10-01 07:05:57 +02: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 [http-foudation] Better accept header parsing 2012-11-05 12:25:18 +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' 2013-09-19 11:47:34 +02: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 fixed CS 2012-07-09 14:54:20 +02:00
HeaderBag.php small changes 2013-03-31 20:13:07 +02:00
IpUtils.php [HttpFoundation] refactored code to avoid code duplication 2013-04-20 17:49:57 +02:00
JsonResponse.php Merge branch '2.2' into 2.3 2013-07-17 07:57:53 +02:00
LICENSE updated license year 2013-01-04 17:59:43 +01: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 most of the docblocks/unused namespaces 2012-12-19 08:09:49 +01:00
Request.php feature#8957 [HttpFoundation] added a way to override the Request class (fabpot) 2013-10-01 07:05:57 +02: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 [HttpFoundation] added constants for HTTP status code in Response 2013-08-22 06:10:30 +02: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 Fixed most of the docblocks/unused namespaces 2012-12-19 08:09:49 +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