PHPackages                             vinala/whoops - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Framework](/categories/framework)
4. /
5. vinala/whoops

ActiveLibrary[Framework](/categories/framework)

vinala/whoops
=============

php error handling for cool kids

1.2.8(8y ago)08882MITPHPPHP >=5.5.9

Since Mar 15Pushed 8y ago1 watchersCompare

[ Source](https://github.com/vinala/whoops)[ Packagist](https://packagist.org/packages/vinala/whoops)[ Docs](https://github.com/filp/whoops)[ RSS](/packages/vinala-whoops/feed)WikiDiscussions master Synced 3w ago

READMEChangelog (2)Dependencies (2)Versions (39)Used By (2)

whoops
======

[](#whoops)

PHP errors for cool kids

[![Total Downloads](https://camo.githubusercontent.com/88017ccafc0c3e2ba4f3593c5bc611c4445c0280408937ea91182e2786f23440/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f646d2f66696c702f77686f6f70732e737667)](https://packagist.org/packages/filp/whoops)[![Latest Version](https://camo.githubusercontent.com/21a28182d61ebed6ad96cf4503bfdd9c88984109134df77bf10b7e941604531b/687474703a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f66696c702f77686f6f70732e737667)](https://packagist.org/packages/filp/whoops)[![Reference Status](https://camo.githubusercontent.com/59c54497cab2b354180d2da4122c2129b4187f0a6a7ac15124a7fa414e4a79a7/68747470733a2f2f7777772e76657273696f6e6579652e636f6d2f7068702f66696c703a77686f6f70732f7265666572656e63655f62616467652e7376673f7374796c653d666c6174)](https://www.versioneye.com/php/filp:whoops/references)[![Dependency Status](https://camo.githubusercontent.com/8fa0e202c7417b223e3451624f3eb39459fb3d965ba3f33b33dde909fbde0611/68747470733a2f2f7777772e76657273696f6e6579652e636f6d2f7068702f66696c703a77686f6f70732f312e312e352f62616467652e737667)](https://www.versioneye.com/php/filp:whoops/1.1.5)[![Build Status](https://camo.githubusercontent.com/1b1dbd211489dc3cb3cccba62cbf5fa4697b882789b713d475e9bdfe004215c8/68747470733a2f2f7472617669732d63692e6f72672f66696c702f77686f6f70732e7376673f6272616e63683d6d6173746572)](https://travis-ci.org/filp/whoops)[![Scrutinizer Quality Score](https://camo.githubusercontent.com/29f84f8daab9ad1b0b3266b0683463db6351ab8c3b328fd510bda01aade08b68/68747470733a2f2f7363727574696e697a65722d63692e636f6d2f672f66696c702f77686f6f70732f6261646765732f7175616c6974792d73636f72652e706e673f733d36323235633336663261326464316664636131316563633762313062323931303563386336326264)](https://scrutinizer-ci.com/g/filp/whoops)[![Code Coverage](https://camo.githubusercontent.com/063999a71f4e2a25963b3c0390e0212cdde5f45c19b02aff1d0efb50ef48ddb7/68747470733a2f2f7363727574696e697a65722d63692e636f6d2f672f66696c702f77686f6f70732f6261646765732f636f7665726167652e706e673f733d37313166656232303639313434643235326431313162323131393635666662313961376430396138)](https://scrutinizer-ci.com/g/filp/whoops)

---

[![Whoops!](https://camo.githubusercontent.com/47bab97a45fae9600d0d372f9647930e9ea665d06076085eda3a848235902878/687474703a2f2f692e696d6775722e636f6d2f305651706539362e706e67)](https://camo.githubusercontent.com/47bab97a45fae9600d0d372f9647930e9ea665d06076085eda3a848235902878/687474703a2f2f692e696d6775722e636f6d2f305651706539362e706e67)

**whoops** is an error handler 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.

Major version bump
------------------

[](#major-version-bump)

**This is documentation for upcoming Whoops version 2**. It is currently in its pre-release state, available with a separate, [pre-release download tag](https://packagist.org/packages/filp/whoops#dev-master). For documentation on the stable version, see [branch `v1`](https://github.com/filp/whoops/tree/v1).

Features
--------

[](#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](docs/Open%20Files%20In%20An%20Editor.md)
- Includes handlers for different response formats (JSON, XML, SOAP)
- Easy to extend and integrate with existing libraries
- Clean, well-structured & tested code-base

Installing
----------

[](#installing)

If you use Laravel 4, you already have Whoops. There are also community-provided instructions on how to integrate Whoops into [Silex 1](https://github.com/whoops-php/silex-1), [Silex 2](https://github.com/texthtml/whoops-silex), [Phalcon](https://github.com/whoops-php/phalcon), [Laravel 3](https://gist.github.com/hugomrdias/5169713#file-start-php), [Laravel 5](https://mattstauffer.co/blog/bringing-whoops-back-to-laravel-5), [CakePHP 2](https://github.com/oldskool/WhoopsCakephp/tree/cake2), [CakePHP 3](https://github.com/oldskool/WhoopsCakephp), [Zend Framework 2](https://github.com/ghislainf/zf2-whoops), [Yii 1](https://github.com/igorsantos07/yii-whoops), [FuelPHP](https://github.com/indigophp/fuel-whoops), [Slim](https://github.com/zeuxisoo/php-slim-whoops/), [Pimple](https://github.com/texthtml/whoops-pimple), or any framework consuming [StackPHP middlewares](https://github.com/thecodingmachine/whoops-stackphp)or [PSR-7 middlewares](https://github.com/franzliedke/whoops-middleware).

If you are not using any of these frameworks, here's a very simple way to install:

1. Use [Composer](http://getcomposer.org) to install Whoops into your project:

    ```
    composer require filp/whoops
    ```
2. Register the pretty handler in your code:

    ```
    $whoops = new \Whoops\Run;
    $whoops->pushHandler(new \Whoops\Handler\PrettyPageHandler);
    $whoops->register();
    ```

For more options, have a look at the **example files** in `examples/` to get a feel for how things work. Also take a look at the [API Documentation](docs/API%20Documentation.md) and the list of available handers below.

### Available Handlers

[](#available-handlers)

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

- [`PrettyPageHandler`](https://github.com/filp/whoops/blob/master/src/Whoops/Handler/PrettyPageHandler.php) - Shows a pretty error page when something goes pants-up
- [`PlainTextHandler`](https://github.com/filp/whoops/blob/master/src/Whoops/Handler/PlainTextHandler.php) - Outputs plain text message for use in CLI applications
- [`CallbackHandler`](https://github.com/filp/whoops/blob/master/src/Whoops/Handler/CallbackHandler.php) - 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`](https://github.com/filp/whoops/blob/master/src/Whoops/Handler/JsonResponseHandler.php) - Captures exceptions and returns information on them as a JSON string. Can be used to, for example, play nice with AJAX requests.
- [`XmlResponseHandler`](https://github.com/filp/whoops/blob/master/src/Whoops/Handler/XmlResponseHandler.php) - Captures exceptions and returns information on them as a XML string. Can be used to, for example, play nice with AJAX requests.

You can also use pluggable handlers, such as [SOAP handler](https://github.com/whoops-php/soap).

Authors
-------

[](#authors)

This library was primarily developed by [Filipe Dobreira](https://github.com/filp), and is currently maintained by [Denis Sokolov](https://github.com/denis-sokolov). A lot of awesome fixes and enhancements were also sent in by [various contributors](https://github.com/filp/whoops/contributors).

###  Health Score

34

—

LowBetter than 75% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity14

Limited adoption so far

Community24

Small or concentrated contributor base

Maturity70

Established project with proven stability

 Bus Factor2

2 contributors hold 50%+ of commits

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~48 days

Recently: every ~159 days

Total

36

Last Release

3144d ago

Major Versions

0.9.0 → 1.0.02013-04-09

1.1.9 → 2.0.0-alpha12015-12-12

PHP version history (4 changes)0.8.4PHP >=5.3.0

1.1.8PHP >=5.3.0 <6

2.0.0-alpha1PHP >=5.3.3

2.0.0-alpha2PHP >=5.5.9

### Community

Maintainers

![](https://www.gravatar.com/avatar/f64f60963ceb55eeb944b43f2abf3da09320afab9e680da0421e88646e1e272d?d=identicon)[youssefhad](/maintainers/youssefhad)

---

Top Contributors

[![filp](https://avatars.githubusercontent.com/u/382538?v=4)](https://github.com/filp "filp (306 commits)")[![denis-sokolov](https://avatars.githubusercontent.com/u/113721?v=4)](https://github.com/denis-sokolov "denis-sokolov (232 commits)")[![youssefhad](https://avatars.githubusercontent.com/u/10350147?v=4)](https://github.com/youssefhad "youssefhad (46 commits)")[![GrahamCampbell](https://avatars.githubusercontent.com/u/2829600?v=4)](https://github.com/GrahamCampbell "GrahamCampbell (39 commits)")[![staabm](https://avatars.githubusercontent.com/u/120441?v=4)](https://github.com/staabm "staabm (24 commits)")[![SBLAdam](https://avatars.githubusercontent.com/u/81582882?v=4)](https://github.com/SBLAdam "SBLAdam (8 commits)")[![franzliedke](https://avatars.githubusercontent.com/u/249125?v=4)](https://github.com/franzliedke "franzliedke (7 commits)")[![Geolim4](https://avatars.githubusercontent.com/u/1332071?v=4)](https://github.com/Geolim4 "Geolim4 (7 commits)")[![bobdenotter](https://avatars.githubusercontent.com/u/1833361?v=4)](https://github.com/bobdenotter "bobdenotter (5 commits)")[![cs278](https://avatars.githubusercontent.com/u/17377?v=4)](https://github.com/cs278 "cs278 (5 commits)")[![hannesvdvreken](https://avatars.githubusercontent.com/u/1410358?v=4)](https://github.com/hannesvdvreken "hannesvdvreken (4 commits)")[![hugomrdias](https://avatars.githubusercontent.com/u/314190?v=4)](https://github.com/hugomrdias "hugomrdias (4 commits)")[![DanielFatkic](https://avatars.githubusercontent.com/u/135755?v=4)](https://github.com/DanielFatkic "DanielFatkic (3 commits)")[![ExplodingCabbage](https://avatars.githubusercontent.com/u/2358339?v=4)](https://github.com/ExplodingCabbage "ExplodingCabbage (3 commits)")[![flaviocopes](https://avatars.githubusercontent.com/u/11783388?v=4)](https://github.com/flaviocopes "flaviocopes (3 commits)")[![freost](https://avatars.githubusercontent.com/u/773958?v=4)](https://github.com/freost "freost (3 commits)")[![funkjedi](https://avatars.githubusercontent.com/u/9314?v=4)](https://github.com/funkjedi "funkjedi (3 commits)")[![synchrone](https://avatars.githubusercontent.com/u/528545?v=4)](https://github.com/synchrone "synchrone (3 commits)")[![igorsantos07](https://avatars.githubusercontent.com/u/532299?v=4)](https://github.com/igorsantos07 "igorsantos07 (2 commits)")[![jacobbednarz](https://avatars.githubusercontent.com/u/283234?v=4)](https://github.com/jacobbednarz "jacobbednarz (2 commits)")

---

Tags

frameworklibraryexceptionerrorhandlingwhoopszf2lighty

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/vinala-whoops/health.svg)

```
[![Health](https://phpackages.com/badges/vinala-whoops/health.svg)](https://phpackages.com/packages/vinala-whoops)
```

###  Alternatives

[filp/whoops

php error handling for cool kids

13.2k420.3M1.5k](/packages/filp-whoops)[graham-campbell/exceptions

Provides A Powerful Error Response System For Both Development And Production

5871.3M4](/packages/graham-campbell-exceptions)[ikkez/f3-falsum

Pretty error handling for Fat-Free Framework

22148.4k3](/packages/ikkez-f3-falsum)[topshelfcraft/canary

The kinder, cuter, cleverer Craft error handler.

114.4k](/packages/topshelfcraft-canary)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)