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 7eb4fdee64 merged branch msonnabaum/request-get-encodings (PR #8185)
This PR was merged into the master branch.

Discussion
----------

[HttpFoundation] Added Request::getEncodings() method

| Q             | A
| ------------- | ---
| Bug fix?      | no
| New feature?  | yes
| BC breaks?    | no
| Deprecations? | no
| Tests pass?   | yes
| Fixed tickets |
| License       | MIT
| Doc PR        |

We needed access to the Accept-Encoding information in Drupal, and I was surprised to see that there wasn't a method on the request object to access this.

This PR adds that method.

Commits
-------

28a8443 [HttpFoundation] Added Request::getEncodings() method
2013-06-13 09:24:40 +02:00
..
File [HttpFoundation] UploadedFile error message 2013-06-06 17:05:59 +02:00
Resources/stubs Nsdocblocks 2012-10-20 09:10:30 +02:00
Session [HttpFoundation][NamespacedAttributeBag] Refactoring of resolveKey() method 2013-05-10 16:58:21 +04:00
Tests [HttpFoundation] Added Request::getEncodings() method 2013-06-03 09:39:44 -05:00
.gitignore made usage of Composer autoloader for subtree-split unit tests 2012-11-09 14:10:06 +01: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.2' 2013-04-17 07:31:37 +02:00
CHANGELOG.md merged branch MidnightLightning/master (PR #7634) 2013-04-20 22:37:19 +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
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 [HttpFoundation] added a note about JSON responses as arrays (refs #6970) 2013-04-25 14:33:17 +02:00
LICENSE updated license year 2013-01-04 17:59:43 +01:00
ParameterBag.php Fixed most of the docblocks/unused namespaces 2012-12-19 08:09:49 +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 made usage of Composer autoloader for subtree-split unit tests 2012-11-09 14:10:06 +01:00
RedirectResponse.php Fixed most of the docblocks/unused namespaces 2012-12-19 08:09:49 +01:00
Request.php [HttpFoundation] Added Request::getEncodings() method 2013-06-03 09:39:44 -05:00
RequestMatcher.php [HttpFoundation] Avoid a few unnecessary str_replace() calls 2013-05-05 10:01:43 +02:00
RequestMatcherInterface.php fixed CS 2012-07-09 14:54:20 +02:00
Response.php Fixed typos 2013-04-21 13:23:54 +00:00
ResponseHeaderBag.php [HttpFoundation] Fixed messed up headers 2013-02-26 10:42:13 +01:00
ServerBag.php Reverted a part of f5e7f24819 2013-05-06 10:11:45 +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 --dev
$ phpunit