whoops

php errors for cool kids

---

whoops is an error handler base/framework for PHP. Out-of-the-box, it provides a pretty error interface that helps you debug your web projects, but at heart it's a simple yet powerful stacked error handling system.

(current) Features

• Flexible, stack-based error handling
• Stand-alone library with (currently) no required dependencies
• Simple API for dealing with exceptions, trace frames & their data
• Includes a pretty rad error page for your webapp projects
• Includes the ability to open referenced files directly in your editor and IDE
• Includes handlers for different response formats (JSON, XML, SOAP)
• Includes a Silex Service Provider for painless integration with Silex
• Includes a Phalcon Service Provider for painless integration with Phalcon
• Includes a Module for equally painless integration with Zend Framework 2
• Easy to extend and integrate with existing libraries
• Clean, well-structured & tested code-base

Installing

Use Composer to install Whoops into your project:

composer require filp/whoops:1

Whoops can be easily integrated into many web frameworks.

If you use Laravel 4, you already have Whoops. For other frameworks, see instructions on how to integrate Whoops into Silex, Phalcon, Laravel 3 (thanks, @hugomrdias), CakePHP (thanks, @oldskool), Zend Framework 2.

If you are not using any of these frameworks, have a look at the example files in examples/ to get a feel for how things work. I promise it's really simple!

If you want to edit some more, take a look at the API Documentation and the list of available handers below.

Available Handlers

whoops currently ships with the following built-in handlers, available in the Whoops\Handler namespace:

• PrettyPageHandler - Shows a pretty error page when something goes pants-up
• CallbackHandler - Wraps a closure or other callable as a handler. You do not need to use this handler explicitly, whoops will automatically wrap any closure or callable you pass to Whoops\Run::pushHandler
• JsonResponseHandler - Captures exceptions and returns information on them as a JSON string. Can be used to, for example, play nice with AJAX requests.
• XmlResponseHandler - Captures exceptions and returns information on them as a XML string. Can be used to, for example, play nice with AJAX requests.
• SoapResponseHandler - Captures exceptions and returns information on them as a SOAP string. Might be used for SOAP Webservices.

Authors

This library was primarily developed by Filipe Dobreira.

A lot of awesome fixes and enhancements were also sent in by contributors, which you can find in this page right here.