Skip to content
This repository

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP

[READ-ONLY] Subtree split of the Symfony HttpKernel Component -- clone into Symfony/Component/ (master at symfony/symfony)

feature #10725 [Debug] Handled errors (nicolas-grekas)

This PR was squashed before being merged into the 2.5-dev branch (closes #10725).

Discussion
----------

[Debug] Handled errors

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

Enhance error handling and thus displaying for catchable PHP errors.
Code is tricky thanks to https://bugs.php.net/54275

Before:

![capture du 2014-04-17 10 03 40](https://cloud.githubusercontent.com/assets/243674/2729324/4de3eedc-c607-11e3-8b23-c88657bbecd0.png)

After:

![capture du 2014-04-17 10 03 14](https://cloud.githubusercontent.com/assets/243674/2729326/534ec504-c607-11e3-82dd-49b7770b1e75.png)

Commits
-------

0279fbf [Debug] Handled errors
latest commit c3cc3cac49
Fabien Potencier fabpot authored April 19, 2014
Octocat-spinner-32 Bundle Merge branch '2.3' into 2.4 April 18, 2014
Octocat-spinner-32 CacheClearer made {@inheritdoc} annotations consistent across the board April 16, 2014
Octocat-spinner-32 CacheWarmer Merge branch '2.3' into 2.4 April 16, 2014
Octocat-spinner-32 Config [HttpKernel] tweaked previous merge April 07, 2013
Octocat-spinner-32 Controller Merge branch '2.3' into 2.4 March 27, 2014
Octocat-spinner-32 DataCollector [Debug] Handled errors April 19, 2014
Octocat-spinner-32 Debug [EventDispatcher] Added TraceableEventDispatcher from HttpKernel December 28, 2013
Octocat-spinner-32 DependencyInjection Merge branch '2.4' April 16, 2014
Octocat-spinner-32 Event fixed types in phpdocs April 16, 2014
Octocat-spinner-32 EventListener feature #10725 [Debug] Handled errors (nicolas-grekas) April 19, 2014
Octocat-spinner-32 Exception Merge branch '2.4' April 16, 2014
Octocat-spinner-32 Fragment feature #10725 [Debug] Handled errors (nicolas-grekas) April 19, 2014
Octocat-spinner-32 HttpCache Merge branch '2.4' April 18, 2014
Octocat-spinner-32 Log fixed types in phpdocs April 16, 2014
Octocat-spinner-32 Profiler Merge branch '2.3' into 2.4 April 18, 2014
Octocat-spinner-32 Tests Merge branch '2.4' April 16, 2014
Octocat-spinner-32 .gitignore Fix gitignore March 04, 2014
Octocat-spinner-32 CHANGELOG.md [EventDispatcher][HttpKernel] Move RegisterListenersPass from HttpKer… December 18, 2013
Octocat-spinner-32 Client.php Merge branch '2.3' into 2.4 January 01, 2014
Octocat-spinner-32 HttpKernel.php [Debug] Handled errors April 19, 2014
Octocat-spinner-32 HttpKernelInterface.php made phpdoc types consistent with those defined in Hack April 15, 2014
Octocat-spinner-32 Kernel.php Merge branch '2.4' April 16, 2014
Octocat-spinner-32 KernelEvents.php updated doc April 17, 2014
Octocat-spinner-32 KernelInterface.php fixed types in phpdocs April 16, 2014
Octocat-spinner-32 LICENSE update year on licenses January 07, 2014
Octocat-spinner-32 README.md updated the composer install command to reflect changes in Composer September 18, 2013
Octocat-spinner-32 TerminableInterface.php fixed CS July 09, 2012
Octocat-spinner-32 UriSigner.php Merge branch '2.3' into 2.4 April 16, 2014
Octocat-spinner-32 composer.json [Debug] Handled errors April 19, 2014
Octocat-spinner-32 phpunit.xml.dist made usage of Composer autoloader for subtree-split unit tests November 09, 2012
README.md

HttpKernel Component

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);
}

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 give you many cool features for free.

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:

$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 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'));

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
Something went wrong with that request. Please try again.