PHPackages                             igorsantos07/yii-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. [Debugging & Profiling](/categories/debugging)
4. /
5. igorsantos07/yii-whoops

AbandonedYii-extension[Debugging & Profiling](/categories/debugging)

igorsantos07/yii-whoops
=======================

Whoops integration class into Yii Framework 1.1

v1.3.1(11y ago)83.0k1[4 issues](https://github.com/igorsantos07/yii-whoops/issues)BSD-3-ClausePHP

Since May 16Pushed 11y ago1 watchersCompare

[ Source](https://github.com/igorsantos07/yii-whoops)[ Packagist](https://packagist.org/packages/igorsantos07/yii-whoops)[ RSS](/packages/igorsantos07-yii-whoops/feed)WikiDiscussions master Synced 3d ago

READMEChangelogDependencies (2)Versions (7)Used By (0)

Yii Error Handler with Whoops
=============================

[](#yii-error-handler-with-whoops)

Integrates the Whoops library into Yii 1.1 and enables further error processing.

Current `CErrorHandler` behaviour is to use internal error views to display development problems, such as the `error` and `exception` views. If you're not in debug mode, it will simply call the vanilla error action and display less stuff in the screen so your users don't get ugly errors.

This new implementation allows you to - if needed - include a last, global error handler before displaying error messages. The `errorAction` is called and, if it can't handle the issue, we take the stage and decide what to do with the error - if you're debugging the application we will give you a really, really nice error page that will help you finding what's wrong :)

Usage
-----

[](#usage)

1. Install it:

    - Using [Composer](http://getcomposer.org/) (it will automatically install Whoops main libraries as well):

    ```
    composer require igorsantos07/yii-whoops:1
    composer install
    ```

    - Or [downloading](https://github.com/igorsantos07/yii-whoops/archive/master.zip) and unpacking it in your `extensions` folder.
2. If you're using Composer, I strongly recomend you to create a `vendor` alias if you haven't yet. Add this to the beginning of your `config/main.php`:

    ```
    Yii::setPathOfAlias('vendor', __DIR__.'/../../vendor');
    ```
3. Replace your `errorHandler` entry at `config/main.php` with the error handler class. Example:

    ```
    'errorHandler' => ['class' => 'vendor.igorsantos07.yii-whoops.WhoopsErrorHandler']
    ```
4. If you're using some custom LogRoute that binds to the application's end, you can disable it using the component's `disabledLogRoutes` property. Just set it to an array containing all the classnames (not aliases!) of each route you want disabled whenever Whoops is launched. By default it disables the famous (Yii Debug Toolbar)[ydtb](http://github.com/malyshev/yii-debug-toolbar); if you want to keep it enabled, override the `defaultDisabledLogRoutes` property.

    ```
    'errorHandler' => [
        'class'             => 'vendor.igorsantos07.yii-whoops.WhoopsErrorHandler',
        'disabledLogRoutes' => 'MyCustomRouteClass'
    ]
    ```
5. There were some changes in the API for further error action handling. If you want to have custom error pages you can as usual include a `errorAction` property into the `errorHandler` above, but with the following differences:

    - `Yii::app()->errorHandler->error` now can be a `CEvent` in case of PHP errors or a normal `Exception`in case of, uh, exceptions. Have that in mind when handling errors in your action, as PHP Errors have no code and etc - however, if you're showing an error page is advised to use the standard 500 code.
    - If your action is unable to handle the error, Whoops will still get to the stage as usual. Example: all API errors in your app will show a small message and redirect the user, while other errors are real problems and should be handled by the framework's error handler. To tell `WhoopsErrorHandler` you've taken care of the issue, call `Yii::app()->errorHandler->handled()`, and then Whoops will not interfere with what the action has done; if after the action he still thinks he should do something, the Whoops error page will be called as usual.

Sample screenshot
-----------------

[](#sample-screenshot)

[ ![](https://camo.githubusercontent.com/de70f4aab4014f804704b6bc780cd923010685c7c0aefd6f73b7beb86f3666fd/687474703a2f2f692e696d6775722e636f6d2f70717438664b342e706e67)](http://i.imgur.com/pqt8fK4.png)

###  Health Score

31

—

LowBetter than 68% of packages

Maintenance10

Infrequent updates — may be unmaintained

Popularity23

Limited adoption so far

Community10

Small or concentrated contributor base

Maturity67

Established project with proven stability

 Bus Factor1

Top contributor holds 96% of commits — single point of failure

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 ~27 days

Total

6

Last Release

4244d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/8768be93b53951c06cbe2de65c60afdbd42d08e8baa886fbc2db3069c8fccc3e?d=identicon)[igorsantos07](/maintainers/igorsantos07)

---

Top Contributors

[![igorsantos07](https://avatars.githubusercontent.com/u/532299?v=4)](https://github.com/igorsantos07 "igorsantos07 (24 commits)")[![nkovacs2](https://avatars.githubusercontent.com/u/9216060?v=4)](https://github.com/nkovacs2 "nkovacs2 (1 commits)")

---

Tags

exceptionerrorhandlingwhoopshandlererror-handlerstack tracetraceyiierror handling

### Embed Badge

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

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

###  Alternatives

[filp/whoops

php error handling for cool kids

13.2k402.4M1.4k](/packages/filp-whoops)[kuria/error

Makes handling and debugging PHP errors suck less

1920.0k2](/packages/kuria-error)[ikkez/f3-falsum

Pretty error handling for Fat-Free Framework

21145.8k3](/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)