added information about how to customize error pages according to the HTTP status code

Author: fabpot

cookbook/controller/error_pages.rst

@@ -50,10 +50,21 @@ create a new file with the same name in the
 ``app/Resources/FrameworkBundle/views/Exception`` directory. This is the
 standard way of overriding any template that lives inside a bundle.
 
-The debug-friendly exception pages shown to the developer can even be
-customized in the same way by creating templates such as
-``exception.html.twig`` for the standard HTML exception page or
-``exception.json.twig`` for the JSON exception page.
+You can also provide specific templates according to the HTTP status code. For
+instance, create a
+``app/Resources/FrameworkBundle/views/Exception/error404.html.twig`` template
+to display a special page for 404 (page not found) errors.
+
+Symfony uses the following algorithm to determine which template to use:
+
+* First, it looks for a template for the given format and status code (like
+  ``error404.json.twig``);
+
+* If it does not exist, it looks for a template for the given format (like
+  ``error.json.twig``);
+
+* If it does not exist, it falls back to the HTML template (like
+  ``error.html.twig``).
 
 .. tip::
 
@@ -63,3 +74,10 @@ customized in the same way by creating templates such as
     ``vendor/symfony/src/Symfony/Bundle/FrameworkBundle``. Often, the easiest
     way to customize an error page is to copy it from the ``FrameworkBundle``
     into ``app/Resources/FrameworkBundle/views/Exception`` and then modify it.
+
+.. note::
+
+    The debug-friendly exception pages shown to the developer can even be
+    customized in the same way by creating templates such as
+    ``exception.html.twig`` for the standard HTML exception page or
+    ``exception.json.twig`` for the JSON exception page.