2011-11-03 20:11:40 +00:00
|
|
|
HttpKernel Component
|
|
|
|
====================
|
|
|
|
|
2011-12-18 13:18:13 +00:00
|
|
|
HttpKernel provides the building blocks to create flexible and fast HTTP-based
|
|
|
|
frameworks.
|
|
|
|
|
|
|
|
``HttpKernelInterface`` is the core interface of the Symfony2 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);
|
2011-11-03 20:11:40 +00:00
|
|
|
}
|
|
|
|
|
2011-12-18 13:18:13 +00:00
|
|
|
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 Symfony2 components. And this will gives you many cool features for
|
|
|
|
free.
|
2011-11-03 20:11:40 +00:00
|
|
|
|
2011-12-18 13:18:13 +00:00
|
|
|
Creating a framework based on the Symfony2 components is really easy. Here is
|
|
|
|
a very simple, but fully-featured framework based on the Symfony2 components:
|
2011-11-03 20:11:40 +00:00
|
|
|
|
2011-12-18 13:18:13 +00:00
|
|
|
$routes = new RouteCollection();
|
|
|
|
$routes->add('hello', new Route('/hello', array('_controller' =>
|
|
|
|
function (Request $request) {
|
|
|
|
return new Response(sprintf("Hello %s", $request->get('name')));
|
|
|
|
}
|
|
|
|
)));
|
2011-11-03 20:11:40 +00:00
|
|
|
|
2011-12-18 13:18:13 +00:00
|
|
|
$request = Request::createFromGlobals();
|
2011-11-03 20:11:40 +00:00
|
|
|
|
2011-12-18 13:18:13 +00:00
|
|
|
$context = new RequestContext();
|
|
|
|
$context->fromRequest($request);
|
2011-11-03 20:11:40 +00:00
|
|
|
|
2011-12-18 13:18:13 +00:00
|
|
|
$matcher = new UrlMatcher($routes, $context);
|
2011-11-03 20:11:40 +00:00
|
|
|
|
2011-12-18 13:18:13 +00:00
|
|
|
$dispatcher = new EventDispatcher();
|
|
|
|
$dispatcher->addSubscriber(new RouterListener($matcher));
|
2011-11-03 20:11:40 +00:00
|
|
|
|
2011-12-18 13:18:13 +00:00
|
|
|
$resolver = new ControllerResolver();
|
2011-11-03 20:11:40 +00:00
|
|
|
|
2011-12-18 13:18:13 +00:00
|
|
|
$kernel = new HttpKernel($dispatcher, $resolver);
|
2011-11-03 20:11:40 +00:00
|
|
|
|
2011-12-18 13:18:13 +00:00
|
|
|
$kernel->handle($request)->send();
|
2011-11-03 20:11:40 +00:00
|
|
|
|
2011-12-18 13:18:13 +00:00
|
|
|
This is all you need to create a flexible framework with the Symfony2
|
|
|
|
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'));
|
2011-11-03 20:11:40 +00:00
|
|
|
|
|
|
|
Want to functional test this small framework?
|
|
|
|
|
2011-12-18 13:18:13 +00:00
|
|
|
$client = new Client($kernel);
|
|
|
|
$crawler = $client->request('GET', '/hello/Fabien');
|
2011-11-03 20:11:40 +00:00
|
|
|
|
2011-12-18 13:18:13 +00:00
|
|
|
$this->assertEquals('Fabien', $crawler->filter('p > span')->text());
|
2011-11-03 20:11:40 +00:00
|
|
|
|
|
|
|
Want nice error pages instead of ugly PHP exceptions?
|
|
|
|
|
2011-12-18 13:18:13 +00:00
|
|
|
$dispatcher->addSubscriber(new ExceptionListener(function (Request $request) {
|
|
|
|
$msg = 'Something went wrong! ('.$request->get('exception')->getMessage().')';
|
2011-11-03 20:11:40 +00:00
|
|
|
|
2011-12-18 13:18:13 +00:00
|
|
|
return new Response($msg, 500);
|
|
|
|
}));
|
2011-11-03 20:11:40 +00:00
|
|
|
|
2011-12-18 13:18:13 +00:00
|
|
|
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.
|
2011-11-03 20:11:40 +00:00
|
|
|
|
|
|
|
Resources
|
|
|
|
---------
|
|
|
|
|
|
|
|
Unit tests:
|
|
|
|
|
|
|
|
https://github.com/symfony/symfony/tree/master/tests/Symfony/Tests/Component/HttpKernel
|