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 861804be5f feature #13264 URL manipulations as a Twig extension (fabpot)
This PR was merged into the 2.7 branch.

Discussion
----------

URL manipulations as a Twig extension

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

While working on the new asset component, I realized that the "absolute URL" feature was misplaced and would benefit from being exposed as a Twig function (composition is always a good thing). Then, I wondered if having a Twig function to generate a relative path (like done by the Routing component would also make sense). And here is the corresponding PR.

```jinja
{# generate an absolute URL for the given absolute path #}
{{ absolute_url('/me.png') }}

{# generate a relative path for the given absolute path (based on the current Request) #}
{{ relative_path('/foo/me.png') }}

{# compose as you see fit #}
{{ absolute_url(asset('me.png')) }}
```

As you can see, we require an absolute path for both functions (and we even add the leading slash if it is omitted), not sure if we want to do otherwise.

ping @tobion

Commits
-------

0ec852d added a relative_path Twig function
ee27ed8 added an absolute_url() Twig function
2015-01-10 08:28:57 +01:00
..
File Merge branch '2.3' into 2.5 2015-01-03 09:01:13 +01:00
Resources/stubs Merge branch '2.5' into 2.6 2014-12-22 17:44:09 +01:00
Session Normalizes deprecation notice messages. 2015-01-05 16:02:28 +01:00
Tests feature #13264 URL manipulations as a Twig extension (fabpot) 2015-01-10 08:28:57 +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 Merge branch '2.5' into 2.6 2015-01-03 16:33:07 +01:00
CHANGELOG.md [HttpFoundation] implement different locking strategies for sessions 2014-10-02 20:16:41 +02:00
composer.json bumped min PHP version to 5.3.9 2015-01-09 07:51:41 +01:00
Cookie.php [2.3] CS And DocBlock Fixes 2014-12-22 16:58:09 +01:00
ExpressionRequestMatcher.php [HttpFoundation] added ExpressionRequestMatcher 2013-09-19 12:59:11 +02:00
FileBag.php Remove aligned '=>' and '=' 2014-10-26 08:30:58 +01:00
HeaderBag.php Merge branch '2.3' into 2.5 2014-12-02 21:15:53 +01:00
IpUtils.php [Debug] fix checkip6 2014-12-29 09:16:16 +01:00
JsonResponse.php CS fixes 2014-12-04 20:26:11 +00:00
LICENSE Updated copyright to 2015 2015-01-01 13:56:52 +01:00
ParameterBag.php [2.6] CS Fixes And Removed An Unused Import 2014-12-07 19:23:39 +01:00
phpunit.xml.dist [Tests] Silenced all deprecations in tests for 2.3 2014-12-18 20:00:19 +01:00
README.md [Doc] Use Markdown syntax highlighting 2014-10-01 07:38:33 +02:00
RedirectResponse.php Docblock fixes 2014-11-30 13:33:44 +00:00
Request.php added a relative_path Twig function 2015-01-07 13:33:01 +01:00
RequestMatcher.php [HttpFoundation] Add a way to match a specific scheme in RequestMatcher #10556 2014-06-03 23:09:07 +02:00
RequestMatcherInterface.php Docblock fixes 2014-11-30 13:33:44 +00:00
RequestStack.php unified return null usages 2014-04-18 22:38:54 +02:00
Response.php Merge branch '2.3' into 2.5 2014-12-22 17:29:52 +01:00
ResponseHeaderBag.php Merge branch '2.5' into 2.6 2014-12-22 17:44:09 +01:00
ServerBag.php fix parsing of Authorization header 2014-08-22 18:41:26 +02:00
StreamedResponse.php Docblock fixes 2014-11-30 13:33:44 +00: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