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 30bd397366 minor #16414 removed all @covers annotations (fabpot)
This PR was merged into the 2.3 branch.

Discussion
----------

removed all @covers annotations

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

Some unit tests have a `@covers` PHPUnit annotations. Most of them were added a very long time ago, but since then, we did not use them anymore and the existing ones are not maintained (see #16413). So, I propose to remove them all.

Commits
-------

1e0af36 removed all @covers annotations
2015-11-02 19:22:02 +01:00
..
File remove api tags from code 2015-09-28 19:11:22 +02:00
Resources/stubs [2.3] CS And DocBlock Fixes 2014-12-22 16:58:09 +01:00
Session remove api tags from code 2015-09-28 19:11:22 +02:00
Tests minor #16414 removed all @covers annotations (fabpot) 2015-11-02 19:22:02 +01:00
.gitignore Added missing files .gitignore 2013-07-21 14:12:18 +02:00
AcceptHeader.php [2.3] CS And DocBlock Fixes 2014-12-22 16:58:09 +01: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 [2.3] [HttpFoundation] fixed param order for Nginx's x-accel-redirect 2015-02-16 14:04:09 -03:00
CHANGELOG.md merged branch MidnightLightning/master (PR #7634) 2013-04-20 22:37:19 +02:00
composer.json added the new Composer exclude-from-classmap option 2015-10-30 12:48:51 -07:00
Cookie.php remove api tags from code 2015-09-28 19:11:22 +02:00
FileBag.php remove api tags from code 2015-09-28 19:11:22 +02:00
HeaderBag.php remove api tags from code 2015-09-28 19:11:22 +02:00
IpUtils.php [HttpFoundation] Fixes /0 subnet handling in IpUtils 2015-10-19 13:54:29 +02:00
JsonResponse.php Windows and Intl fixes 2015-08-25 23:41:39 +02:00
LICENSE Updated copyright to 2015 2015-01-01 13:56:52 +01:00
ParameterBag.php fix expected argument type docblock 2015-10-29 19:47:17 +01:00
phpunit.xml.dist [ci] SymfonyTestsListener is now auto-registered 2015-10-11 11:37:49 +02:00
README.md renamed composer.phar to composer to be consistent with the Symfony docs 2015-02-08 08:41:14 +01:00
RedirectResponse.php remove api tags from code 2015-09-28 19:11:22 +02:00
Request.php [HttpFoundation] Fix some typo in the Request doc 2015-10-13 17:57:12 +02:00
RequestMatcher.php remove api tags from code 2015-09-28 19:11:22 +02:00
RequestMatcherInterface.php remove api tags from code 2015-09-28 19:11:22 +02:00
Response.php [Http*] Mock time() to fix transient tests 2015-10-13 16:19:21 +02:00
ResponseHeaderBag.php remove api tags from code 2015-09-28 19:11:22 +02:00
ServerBag.php Handled bearer authorization header in REDIRECT_ form 2015-02-10 11:35:13 +08:00
StreamedResponse.php remove api tags from code 2015-09-28 19:11:22 +02: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 install
$ phpunit