@@ -69,24 +69,24 @@ Rendering PHP Errors and Exceptions
6969Another feature provided by this component are the "error renderers", which
7070converts PHP errors and exceptions into other formats such as JSON and HTML::
7171
72- use Symfony\Component\ErrorHandler \ErrorRenderer\ErrorRenderer;
73- use Symfony\Component\ErrorHandler \ErrorRenderer\HtmlErrorRenderer;
74- use Symfony\Component\ErrorHandler \ErrorRenderer\JsonErrorRenderer;
72+ use Symfony\Component\ErrorCatcher \ErrorRenderer\ErrorRenderer;
73+ use Symfony\Component\ErrorCatcher \ErrorRenderer\HtmlErrorRenderer;
74+ use Symfony\Component\ErrorCatcher \ErrorRenderer\JsonErrorRenderer;
7575
7676 $renderers = [
7777 new HtmlErrorRenderer(),
7878 new JsonErrorRenderer(),
7979 // ...
8080 ];
81- $errorRenderer = new ErrorRenderer ($renderers);
81+ $errorFormatter = new ErrorFormatter ($renderers);
8282
83- /** @var Symfony\Component\ErrorHandler \Exception\FlattenException */
83+ /** @var Symfony\Component\ErrorCatcher \Exception\FlattenException */
8484 $exception = ...;
8585 /** @var Symfony\Component\HttpFoundation\Request */
8686 $request = ...;
8787
8888 return new Response(
89- $errorRenderer ->render($exception, $request->getRequestFormat()),
89+ $errorFormatter ->render($exception, $request->getRequestFormat()),
9090 $exception->getStatusCode(),
9191 $exception->getHeaders()
9292 );
@@ -96,29 +96,28 @@ Built-in Error Renderers
9696
9797This component provides error renderers for the most common needs:
9898
99- * :class: `Symfony\\ Component\\ ErrorHandler \\ ErrorRenderer\\ HtmlErrorRenderer `
99+ * :class: `Symfony\\ Component\\ ErrorCatcher \\ ErrorRenderer\\ HtmlErrorRenderer `
100100 renders errors in HTML format;
101- * :class: `Symfony\\ Component\\ ErrorHandler\\ ErrorRenderer\\ JsonErrorRenderer `
102- renders errors in JsonErrorRenderer format and it's compliant with the
103- `RFC 7807 `_ standard;
104- * :class: `Symfony\\ Component\\ ErrorHandler\\ ErrorRenderer\\ XmlErrorRenderer `
101+ * :class: `Symfony\\ Component\\ ErrorCatcher\\ ErrorRenderer\\ JsonErrorRenderer `
102+ renders errors in JSON format and it's compliant with the `RFC 7807 `_ standard;
103+ * :class: `Symfony\\ Component\\ ErrorCatcher\\ ErrorRenderer\\ XmlErrorRenderer `
105104 renders errors in XML and Atom formats. It's compliant with the `RFC 7807 `_
106105 standard;
107- * :class: `Symfony\\ Component\\ ErrorHandler \\ ErrorRenderer\\ TxtErrorRenderer `
108- renders errors in regular text format.
106+ * :class: `Symfony\\ Component\\ ErrorCatcher \\ ErrorRenderer\\ TxtErrorRenderer `
107+ renders errors in plain text format.
109108
110109Adding a Custom Error Renderer
111110~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
112111
113112Error renderers are PHP classes that implement the
114- :class: `Symfony\\ Component\\ ErrorHandler \\ ErrorRenderer\\ ErrorRendererInterface `.
113+ :class: `Symfony\\ Component\\ ErrorCatcher \\ ErrorRenderer\\ ErrorRendererInterface `.
115114For example, if you need to render errors in `JSON-LD format `_, create this
116115class anywhere in your project::
117116
118- namespace App\ErrorHandler\ErrorRenderer ;
117+ namespace App\ErrorCatcher ;
119118
120- use Symfony\Component\ErrorHandler \ErrorRenderer\ErrorRendererInterface;
121- use Symfony\Component\ErrorHandler \Exception\FlattenException;
119+ use Symfony\Component\ErrorCatcher \ErrorRenderer\ErrorRendererInterface;
120+ use Symfony\Component\ErrorCatcher \Exception\FlattenException;
122121
123122 class JsonLdErrorRenderer implements ErrorRendererInterface
124123 {
@@ -162,7 +161,7 @@ class anywhere in your project::
162161
163162To enable the new error renderer in the application,
164163:ref: `register it as a service <service-container-creating-service >` and
165- :doc: `tag it </service_container/tags >` with the ``error_handler .renderer ``
164+ :doc: `tag it </service_container/tags >` with the ``error_catcher .renderer ``
166165tag.
167166
168167.. configuration-block ::
171170
172171 # config/services.yaml
173172 services :
174- App\ErrorHandler\ErrorRenderer \JsonLdErrorRenderer :
173+ App\ErrorCatcher \JsonLdErrorRenderer :
175174 arguments : ['%kernel.debug%']
176- tags : ['error_handler .renderer']
175+ tags : ['error_catcher .renderer']
177176
178177 .. code-block :: xml
179178
@@ -185,21 +184,21 @@ tag.
185184 https://symfony.com/schema/dic/services/services-1.0.xsd" >
186185
187186 <services >
188- <service id =" App\ErrorHandler\ErrorRenderer \JsonLdErrorRenderer" >
187+ <service id =" App\ErrorCatcher \JsonLdErrorRenderer" >
189188 <argument >true</argument >
190- <tag name =" error_handler .renderer" />
189+ <tag name =" error_catcher .renderer" />
191190 </service >
192191 </services >
193192 </container >
194193
195194 .. code-block :: php
196195
197196 // config/services.php
198- use App\ErrorHandler\ErrorRenderer \JsonLdErrorRenderer;
197+ use App\ErrorCatcher \JsonLdErrorRenderer;
199198
200199 $container->register(JsonLdErrorRenderer::class)
201200 ->setArguments([true]);
202- ->addTag('error_handler .renderer');
201+ ->addTag('error_catcher .renderer');
203202
204203 .. _`RFC 7807` : https://tools.ietf.org/html/rfc7807
205204.. _`JSON-LD format` : https://en.wikipedia.org/wiki/JSON-LD
0 commit comments