added Application::abort() to aborts a request early

That simplifies firing 404 pages for instance as you don't need
to add a use statement for the HttpException.

doc/usage.rst

@@ -122,11 +122,9 @@ Dynamic routing
 Now, you can create another controller for viewing individual blog
 posts::
 
-    use Symfony\Component\HttpKernel\Exception\NotFoundHttpException;
-
-    $app->get('/blog/show/{id}', function ($id) use ($blogPosts) {
+    $app->get('/blog/show/{id}', function ($id) use ($app, $blogPosts) {
         if (!isset($blogPosts[$id])) {
-            throw new NotFoundHttpException();
+            $app->abort(404, "Post $id does not exist.");
         }
 
         $post = $blogPosts[$id];
@@ -407,6 +405,17 @@ once a response is returned, the following handlers are ignored.
             // logic to handle the error and return a Response
         });
 
+The error handlers are also called when you use ``abort`` to abort a request
+early::
+
+    $app->get('/blog/show/{id}', function ($id) use ($app, $blogPosts) {
+        if (!isset($blogPosts[$id])) {
+            $app->abort(404, "Post $id does not exist.");
+        }
+
+        return new Response(...);
+    });
+
 Redirects
 ---------
 

src/Silex/Application.php

@@ -21,6 +21,7 @@ use Symfony\Component\HttpKernel\Event\FilterControllerEvent;
 use Symfony\Component\HttpKernel\Exception\MethodNotAllowedHttpException;
 use Symfony\Component\HttpKernel\Exception\NotFoundHttpException;
 use Symfony\Component\HttpKernel\Exception\HttpExceptionInterface;
+use Symfony\Component\HttpKernel\Exception\HttpException;
 use Symfony\Component\HttpKernel\KernelEvents;
 use Symfony\Component\HttpFoundation\Request;
 use Symfony\Component\HttpFoundation\RedirectResponse;
@@ -212,6 +213,17 @@ class Application extends \Pimple implements HttpKernelInterface, EventSubscribe
         $this['dispatcher']->addListener(SilexEvents::AFTER, $callback);
     }
 
+    /**
+     * Aborts the current request by sending a proper HTTP error.
+     *
+     * @param integer $statusCode The HTTP status code
+     * @param array   $headers    An array of HTTP headers
+     */
+    public function abort($statusCode, $message = '', array $headers = array())
+    {
+        throw new HttpException($statusCode, $message, null, $headers);
+    }
+
     /**
      * Registers an error handler.
      *

src/Silex/Extension/SymfonyBridgesExtension.php

@@ -14,8 +14,6 @@ namespace Silex\Extension;
 use Silex\Application;
 use Silex\ExtensionInterface;
 
-use Symfony\Component\Routing\Generator\UrlGenerator;
-
 class SymfonyBridgesExtension implements ExtensionInterface
 {
     public function register(Application $app)

tests/Silex/Tests/ApplicationTest.php

@@ -14,6 +14,7 @@ namespace Silex\Tests;
 use Silex\Application;
 
 use Symfony\Component\HttpFoundation\Request;
+use Symfony\Component\HttpKernel\Exception\HttpException;
 
 /**
  * Application test cases.
@@ -104,6 +105,18 @@ class ApplicationTest extends \PHPUnit_Framework_TestCase
         $this->assertEquals('foobar', $response->getContent());
     }
 
+    public function testAbort()
+    {
+        $app = new Application();
+
+        try {
+            $app->abort(404);
+            $this->fail();
+        } catch (HttpException $e) {
+            $this->assertEquals(404, $e->getStatusCode());
+        }
+    }
+
     /**
     * @dataProvider escapeProvider
     */