sfExceptionFormatsPlugin - 1.0.0

Renders exceptions as the appropriate content type.

You are currently browsing
the website for symfony 1

Visit the Symfony2 website

« Back to the Plugins Home


Forgot your password?
Create an account



advanced search
Information Readme Releases Changelog Contribute
Show source

The sfExceptionFormatsPlugin extends symfony 1.1's integration of multiple request formats to include exception and error 500 pages.

For example, if a request that includes a sf_method parameter with the value of xml throws an exception, the plugin will output the following response:

<?xml version="1.0" encoding="UTF-8"?>
<error code="500" message="Internal Server Error"/>

Very little information is betrayed here. If you request the same URL using a debug controller, you will see a bit more:

<?xml version="1.0" encoding="UTF-8"?>
<error code="500" message="Internal Server Error">
  <debug exception="sfException" message="Something unexpected happened" />

Customizing the error responses

You can easily customize how exceptions for each format are rendered by adding a template file to your project or application's config directory. For example, placing a exception.json.php file in /config will customize how JSON exceptions are rendered when debug mode is on. An error_500.json.php file in the same directory would render when debug mode is off.

The offending exception object is available in all custom templates as $exception.