Merge pull request symfony#1608 from symfony/exception-handling-note

weaverryan · weaverryan · commit 1e5890943f0d · 2012-07-31T21:03:23.000-07:00
added a note about exception handling with a special status code
diff --git a/book/internals.rst b/book/internals.rst
@@ -377,6 +377,15 @@ and set a new ``Exception`` object, or do nothing:
         // $event->setException($exception);
     }
 
+.. note::
+
+    As Symfony ensures that the Response status code is set to the most
+    appropriate one depending on the exception, setting the status on the
+    response won't work. If you want to overwrite the status code (which you
+    should not without a good reason), set the ``X-Status-Code`` header::
+
+        return new Response('Error', 404 /* ignored */, array('X-Status-Code' => 200));
+
 .. index::
    single: Event Dispatcher
 
