PHPackages                             portrino/typo3-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. portrino/typo3-whoops

AbandonedArchivedLibrary

portrino/typo3-whoops
=====================

Whoops error/ exception handler for TYPO3 projects

0.1.0(8y ago)93.4k[2 issues](https://github.com/portrino/typo3-whoops/issues)MITPHP

Since Nov 13Pushed 8y ago7 watchersCompare

[ Source](https://github.com/portrino/typo3-whoops)[ Packagist](https://packagist.org/packages/portrino/typo3-whoops)[ RSS](/packages/portrino-typo3-whoops/feed)WikiDiscussions master Synced today

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

TYPO3 Whoops
============

[](#typo3-whoops)

[![Build Status](https://camo.githubusercontent.com/a2e4adf4bb90c6666bb39a9c8dcfd942f4c65077fcc0a801414262f47b0d1742/68747470733a2f2f7472617669732d63692e6f72672f706f727472696e6f2f7479706f332d77686f6f70732e7376673f6272616e63683d6d6173746572)](https://travis-ci.org/portrino/typo3-whoops)[![Latest Stable Version](https://camo.githubusercontent.com/c7755087b0942ccfbf3027e91742ef6ad099783453cee4fe5b225f1496aa22bf/68747470733a2f2f706f7365722e707567782e6f72672f706f727472696e6f2f7479706f332d77686f6f70732f762f737461626c65)](https://packagist.org/packages/portrino/typo3-whoops)[![Total Downloads](https://camo.githubusercontent.com/d0be87249684a942cce08265fb772b62d6c1b3a9d2fe2580b19f14d01b45789d/68747470733a2f2f706f7365722e707567782e6f72672f706f727472696e6f2f7479706f332d77686f6f70732f646f776e6c6f616473)](https://packagist.org/packages/portrino/typo3-whoops)

Use the [whoops](http://filp.github.io/whoops/) error/ exception handler instead of the default DebugExceptionHandler shipped within the TYPO3 core. This supports you with a nicer exception handling output in the frontend or on cli during extension development. Should only be used in a (local) development context!

Getting started
---------------

[](#getting-started)

### Install using composer

[](#install-using-composer)

```
$ composer require --dev portrino/typo3-whoops
```

### Activation

[](#activation)

#### via AdditionalConfiguration.php

[](#via-additionalconfigurationphp)

Add the following lines into your `typo3conf/AdditionalConfiguration.php`:

```
$GLOBALS['TYPO3_CONF_VARS']['SYS']['debugExceptionHandler'] =
    \Portrino\Typo3Whoops\Error\WhoopsExceptionHandler::class;
$GLOBALS['TYPO3_CONF_VARS']['SYS']['productionExceptionHandler'] =
    \Portrino\Typo3Whoops\Error\WhoopsExceptionHandler::class;
```

We **highly recommend** to use a context related condition around it. For example:

```
$applicationContext = \TYPO3\CMS\Core\Utility\GeneralUtility::getApplicationContext()->__toString();
if (strpos($applicationContext, 'Development') !== false) {

    $GLOBALS['TYPO3_CONF_VARS']['SYS']['debugExceptionHandler'] =
        \Portrino\Typo3Whoops\Error\WhoopsExceptionHandler::class;
    $GLOBALS['TYPO3_CONF_VARS']['SYS']['productionExceptionHandler'] =
        \Portrino\Typo3Whoops\Error\WhoopsExceptionHandler::class;

}
```

##### Compatibility for PHP versions &lt; 7

[](#compatibility-for-php-versions--7)

Because the `ExceptionHandlerInterface` under php5.5 and 5.6 differs from the one from php &gt; 7 we provide you a compatible version of the `WhoopsExceptionHandler`.

```
$GLOBALS['TYPO3_CONF_VARS']['SYS']['debugExceptionHandler'] =
    \Portrino\Typo3Whoops\Compatibility\Error\WhoopsExceptionHandler::class;
$GLOBALS['TYPO3_CONF_VARS']['SYS']['productionExceptionHandler'] =
    \Portrino\Typo3Whoops\Compatibility\Error\WhoopsExceptionHandler::class;
```

#### via TYPO3 Console

[](#via-typo3-console)

```
typo3cms configuration:set --path SYS/debugExceptionHandler --value "Portrino\\Typo3Whoops\\Error\\WhoopsExceptionHandler"
typo3cms configuration:set --path SYS/productionExceptionHandler --value "Portrino\\Typo3Whoops\\Error\\WhoopsExceptionHandler"
```

Usage
-----

[](#usage)

Now trigger an exception somewhere in your extension code and you should see php errors for cool kids.

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

Authors
-------

[](#authors)

[![](https://avatars0.githubusercontent.com/u/540478?s=40&v=4)](https://avatars0.githubusercontent.com/u/540478?s=40&v=4)[![](https://avatars0.githubusercontent.com/u/726519?s=40&v=4)](https://avatars0.githubusercontent.com/u/726519?s=40&v=4)

- **Axel Böswetter** - *Initial work* - [EvilBMP](https://github.com/EvilBMP)
- **André Wuttig** - *Bugfixes, Unit Tests, Acceptance Tests, Travis CI Integration* - [aWuttig](https://github.com/aWuttig)

See also the list of [contributors](https://github.com/portrino/typo3-whoops/graphs/contributors) who participated in this project.

###  Health Score

28

—

LowBetter than 57% of packages

Maintenance16

Infrequent updates — may be unmaintained

Popularity22

Limited adoption so far

Community11

Small or concentrated contributor base

Maturity53

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 69.2% 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

Unknown

Total

1

Last Release

3051d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/03867e1d2497d7cb7feb932fb301387e143503bfd17c584ef90347b3d7942cf1?d=identicon)[portrino-dev](/maintainers/portrino-dev)

---

Top Contributors

[![EvilBMP](https://avatars.githubusercontent.com/u/540478?v=4)](https://github.com/EvilBMP "EvilBMP (27 commits)")[![aWuttig](https://avatars.githubusercontent.com/u/726519?v=4)](https://github.com/aWuttig "aWuttig (12 commits)")

---

Tags

errorhandlingwhoopstypo3

###  Code Quality

TestsCodeception

Code StylePHP\_CodeSniffer

### Embed Badge

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

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

###  Alternatives

[filp/whoops

php error handling for cool kids

13.3k394.4M1.3k](/packages/filp-whoops)[nunomaduro/collision

Cli error handling for console/command-line PHP applications.

4.6k324.1M7.1k](/packages/nunomaduro-collision)[zeuxisoo/slim-whoops

PHP whoops error on slim framework

1371.0M26](/packages/zeuxisoo-slim-whoops)[rarst/wps

WordPress plugin for whoops error handler.

129132.3k3](/packages/rarst-wps)[middlewares/whoops

Middleware to use Whoops as error handler

33203.6k25](/packages/middlewares-whoops)[kamranahmedse/laravel-faulty

A minimal package to assist in returning RESTful exceptions in your APIs.

6317.8k](/packages/kamranahmedse-laravel-faulty)

PHPackages © 2026

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