b2e7ca3ca4
* 2.7: (36 commits) [Debug] fix error message on double exception [Validator] make DateTime objects represented as strings in the violation message. [RFC] [DebugBundle] [HttpKernel] Avoid using container as dependency for DumpListener Upgrade information for the Translation component regarding the new LoggingTranslator class. [WebProfilerBundle] Remove usage of app.request in search bar template Fix initialized() with aliased services fix data type in docblock Rename Symfony2 to Symfony bumped Symfony version to 2.6.0 updated VERSION for 2.6.0-BETA2 updated CHANGELOG for 2.6.0-BETA2 [Debug] fix ENT_SUBSTITUTE usage compare version using PHP_VERSION_ID backport #12489 remove an unneeded check Remove block submit_widget reformat code as suggested by @fabpot Fix typo Make `\Request::get` more performant. properly set request attributes in controller test ... |
||
---|---|---|
.. | ||
Bundle | ||
CacheClearer | ||
CacheWarmer | ||
Config | ||
Controller | ||
DataCollector | ||
Debug | ||
DependencyInjection | ||
Event | ||
EventListener | ||
Exception | ||
Fragment | ||
HttpCache | ||
Log | ||
Profiler | ||
Tests | ||
.gitignore | ||
CHANGELOG.md | ||
Client.php | ||
composer.json | ||
HttpKernel.php | ||
HttpKernelInterface.php | ||
Kernel.php | ||
KernelEvents.php | ||
KernelInterface.php | ||
LICENSE | ||
phpunit.xml.dist | ||
README.md | ||
TerminableInterface.php | ||
UriSigner.php |
HttpKernel Component
HttpKernel provides the building blocks to create flexible and fast HTTP-based frameworks.
HttpKernelInterface
is the core interface of the Symfony full-stack
framework:
interface HttpKernelInterface
{
/**
* Handles a Request to convert it to a Response.
*
* @param Request $request A Request instance
*
* @return Response A Response instance
*/
function handle(Request $request, $type = self::MASTER_REQUEST, $catch = true);
}
It takes a Request
as an input and should return a Response
as an
output. Using this interface makes your code compatible with all frameworks
using the Symfony components. And this will give you many cool features for
free.
Creating a framework based on the Symfony components is really easy. Here is a very simple, but fully-featured framework based on the Symfony components:
$routes = new RouteCollection();
$routes->add('hello', new Route('/hello', array('_controller' =>
function (Request $request) {
return new Response(sprintf("Hello %s", $request->get('name')));
}
)));
$request = Request::createFromGlobals();
$context = new RequestContext();
$context->fromRequest($request);
$matcher = new UrlMatcher($routes, $context);
$dispatcher = new EventDispatcher();
$dispatcher->addSubscriber(new RouterListener($matcher));
$resolver = new ControllerResolver();
$kernel = new HttpKernel($dispatcher, $resolver);
$kernel->handle($request)->send();
This is all you need to create a flexible framework with the Symfony components.
Want to add an HTTP reverse proxy and benefit from HTTP caching and Edge Side Includes?
$kernel = new HttpKernel($dispatcher, $resolver);
$kernel = new HttpCache($kernel, new Store(__DIR__.'/cache'));
Want to functional test this small framework?
$client = new Client($kernel);
$crawler = $client->request('GET', '/hello/Fabien');
$this->assertEquals('Fabien', $crawler->filter('p > span')->text());
Want nice error pages instead of ugly PHP exceptions?
$dispatcher->addSubscriber(new ExceptionListener(function (Request $request) {
$msg = 'Something went wrong! ('.$request->get('exception')->getMessage().')';
return new Response($msg, 500);
}));
And that's why the simple looking HttpKernelInterface
is so powerful. It
gives you access to a lot of cool features, ready to be used out of the box,
with no efforts.
Resources
You can run the unit tests with the following command:
$ cd path/to/Symfony/Component/HttpKernel/
$ composer.phar install
$ phpunit