PHPackages                             bkrukowski/error-dumper - 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. [Utility &amp; Helpers](/categories/utility)
4. /
5. bkrukowski/error-dumper

ActiveLibrary[Utility &amp; Helpers](/categories/utility)

bkrukowski/error-dumper
=======================

Pretty errors and exceptions in PHP.

v2.6.4(9y ago)11.0kMITPHPPHP ^5.3 || ^7.0

Since Nov 13Pushed 9y agoCompare

[ Source](https://github.com/bkrukowski/error-dumper)[ Packagist](https://packagist.org/packages/bkrukowski/error-dumper)[ RSS](/packages/bkrukowski-error-dumper/feed)WikiDiscussions master Synced 3w ago

READMEChangelog (10)Dependencies (6)Versions (21)Used By (0)

[![Build Status](https://camo.githubusercontent.com/0701406d32dc8720979ecd6918be32dec230947eed08253bf3a2a3becafaacd9/68747470733a2f2f7472617669732d63692e6f72672f626b72756b6f77736b692f6572726f722d64756d7065722e7376673f6272616e63683d6d6173746572)](https://travis-ci.org/bkrukowski/error-dumper)[![Coverage Status](https://camo.githubusercontent.com/1d014cf725c9a292154560763519e9600fff9e8d4b809d1e6db6756ac79857bf/68747470733a2f2f636f766572616c6c732e696f2f7265706f732f6769746875622f626b72756b6f77736b692f6572726f722d64756d7065722f62616467652e7376673f6272616e63683d6d6173746572)](https://coveralls.io/github/bkrukowski/error-dumper?branch=master)[![Codacy Badge](https://camo.githubusercontent.com/43db93ccb126cb9ac7a4ada26b780d76d63e59057e5541695b40476c89d629bc/68747470733a2f2f6170692e636f646163792e636f6d2f70726f6a6563742f62616467652f47726164652f3834376662643030643365373437323039353265356638646364633562613831)](https://www.codacy.com/app/bartlomiej-krukowski/error-dumper?utm_source=github.com&utm_medium=referral&utm_content=bkrukowski/error-dumper&utm_campaign=Badge_Grade)

Pretty error dumper for PHP
===========================

[](#pretty-error-dumper-for-php)

**ErrorDumper** *has been moved to* [awesomite/error-dumper](https://github.com/awesomite/error-dumper), please use new repository.

Requirements
------------

[](#requirements)

- PHP &gt;= 5.3 (also 7.0 is supported)
- no dependencies
- for nicer dump of variables you can add **symfony/var-dumper** to project

Tests
-----

[](#tests)

[100% code coverage](https://coveralls.io/github/bkrukowski/error-dumper) with PHPUnit.

Installation
------------

[](#installation)

### If you use composer

[](#if-you-use-composer)

Add **bkrukowski/error-dumper** to dependencies.

### In other cases

[](#in-other-cases)

Add below code to project:

```
$pathToLib = 'here put path to error-dumper library';
include $pathToLib . 'src' . DIRECTORY_SEPARATOR . 'autoload.inc.php';
```

Usage
-----

[](#usage)

**\[Unsafe\]** Below code is enough:

```
\ErrorDumper\Magic::registerErrorDumper();
```

**\[Safe\]** But you should write something like this (because **all variables like credentials are visible**, when exception or error occur)

```
if ($isInTestEnvironment)
{
    \ErrorDumper\Magic::registerErrorDumper();
}
else
{
    \ErrorDumper\Magic::registerErrorCallback(function ($e) {
        /** @var \Exception|\Throwable $e */
        // save error somewhere, for example:
        // $output = \ErrorDumper\Magic::exportExceptionToLightHtml($exception);
        // \Foo\MyErrorStorage::addHtmlError($output);
        exit(1);
    });
}
```

Editors
-------

[](#editors)

Numbers of lines and names of files are clickable, but you have to set proper editor. Default editor is PhpStorm. If you use something else, put edtor object as argument in `registerErrorDumper` method.

```
\ErrorDumper\Magic::registerErrorDumper(new \ErrorDumper\Editors\MacVim());
```

### Supported editors

[](#supported-editors)

- MacVim
- PhpStorm
- TextMate

Snapshots
---------

[](#snapshots)

Using below code, you can save exception somewhere and display it later:

```
$output = \ErrorDumper\Magic::exportExceptionToLightHtml($exception);
```

### Adding custom information to snapshots

[](#adding-custom-information-to-snapshots)

From version 2.3.0 there is special constant `ErrorDumper\Dumpers\Html::TAG_UNDER_TITLE`. You can put under title whatever you want using `str_replace` function.

Handle only exceptions
----------------------

[](#handle-only-exceptions)

You can choose type of errors to handling. Methods

- `ErrorDumper\Magic::registerErrorDumper`
- `ErrorDumper\Magic::registerErrorCallback`
- `ErrorDumper\Handlers\RegisterErrorHandler::register`

have optional argument `$errorTypes`, default is equal `ErrorDumper\Handlers\RegisterErrorHandler::TYPE_ALL`. This value is equal result of binary multiplication of constants `ErrorDumper\Handlers\RegisterErrorHandler::TYPE_*`. If you want handle only errors, you should put here `ErrorDumper\Handlers\RegisterErrorHandler::TYPE_ERRORS | ErrorDumper\Handlers\RegisterErrorHandler::TYPE_SHUTDOWN_ERRORS`.

Preview
-------

[](#preview)

### Error

[](#error)

[![Preview exception](resources/img/preview-exception.png)](resources/img/preview-exception.png)

### Arguments

[](#arguments)

[![Preview arguments](resources/img/preview-arguments.png)](resources/img/preview-arguments.png)

###  Health Score

31

—

LowBetter than 66% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity15

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity67

Established project with proven stability

 Bus Factor1

Top contributor holds 100% 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 ~20 days

Recently: every ~25 days

Total

20

Last Release

3501d ago

Major Versions

v1.0.0-alpha → v2.0.02015-11-27

PHP version history (3 changes)v1.0.0-alphaPHP &gt;=5.3

v2.5.2PHP ^5.3|^7.0

v2.6.0PHP ^5.3 || ^7.0

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/10114238?v=4)[Bartłomiej Krukowski](/maintainers/bkrukowski)[@bkrukowski](https://github.com/bkrukowski)

---

Top Contributors

[![bkrukowski](https://avatars.githubusercontent.com/u/10114238?v=4)](https://github.com/bkrukowski "bkrukowski (24 commits)")

---

Tags

utilitydebugerrorsexceptions

###  Code Quality

TestsPHPUnit

Code StylePHP\_CodeSniffer

### Embed Badge

![Health badge](/badges/bkrukowski-error-dumper/health.svg)

```
[![Health](https://phpackages.com/badges/bkrukowski-error-dumper/health.svg)](https://phpackages.com/packages/bkrukowski-error-dumper)
```

###  Alternatives

[nette/utils

🛠 Nette Utils: lightweight utilities for string &amp; array manipulation, image handling, safe JSON encoding/decoding, validation, slug or strong password generating etc.

2.1k417.9M1.7k](/packages/nette-utils)[danielstjules/stringy

A string manipulation library with multibyte support

2.4k26.2M192](/packages/danielstjules-stringy)[voku/arrayy

Array manipulation library for PHP, called Arrayy!

4885.6M18](/packages/voku-arrayy)[mage2tv/magento-cache-clean

This package has been migrated to mage-os/magento-cache-clean. Please switch over at your convenience.

5442.1M3](/packages/mage2tv-magento-cache-clean)[vaimo/composer-patches

Applies a patch from a local or remote file to any package that is part of a given composer project. Patches can be defined both on project and on package level. Optional support for patch versioning, sequencing, custom patch applier configuration and patch command for testing/troubleshooting added patches.

3014.5M22](/packages/vaimo-composer-patches)[lodash-php/lodash-php

A port of Lodash to PHP

524741.7k5](/packages/lodash-php-lodash-php)

PHPackages © 2026

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