PHPackages                             softius/exceptionist - 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. softius/exceptionist

ActiveLibrary[Debugging & Profiling](/categories/debugging)

softius/exceptionist
====================

Exception handler for PHP 5.3

0.3(12y ago)32.1kMITPHPPHP >=5.3.0

Since Feb 25Pushed 12y ago2 watchersCompare

[ Source](https://github.com/softius/exceptionist)[ Packagist](https://packagist.org/packages/softius/exceptionist)[ Docs](http://github.com/softius/exceptionist)[ RSS](/packages/softius-exceptionist/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (1)Dependencies (1)Versions (4)Used By (0)

exceptionist
============

[](#exceptionist)

Exceptionist provides exception handler for PHP 5.3+. Based on the application environment you can choose to display a detailed error report with stack trace or a mini report just mentioning the exception occured.

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

[](#installation)

Exceptionist is available on packagist. All you need is to add the following lines in your project `composer.json`:

```
	{
    	"require": {
        	"softius/exceptionist": "0.1"
	    }
	}
```

and install via composer:

```
	php composer.phar install

```

Then, you will need to setup `GenericExceptionHandler`. You are adviced to setup the following as early as possible in your script.

```
set_exception_handler(array(new \Exceptionist\GenericExceptionHandler(array('project_root' => 'project_root_dir')), 'handle'));
```

Configuration
-------------

[](#configuration)

`GenericExceptionHandler` accepts a configuration array with the following options:

- `project_root`: defines the project root directory, default is `null`.
- `template_script`: full path of the template to be used. The following built-in templates are available: `\Exceptionist\ExceptionReporter::TEMPLATE_DETAILED`
- `code_block_length`: number of lines to be displayed in each code block, default is 10.

How it works
------------

[](#how-it-works)

`ExceptionHandler` is using `ExceptionReporter` class to generate and display exception reports. This happens only and only if an exception is thrown and not caught within a try/catch block. Templates are available in `templates` which can be copied, modified and adjusted to your needs, if necessary.

###  Health Score

28

—

LowBetter than 54% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity21

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity50

Maturing project, gaining track record

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

Total

3

Last Release

4731d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/586121?v=4)[Iacovos Constantinou](/maintainers/softius)[@softius](https://github.com/softius)

---

Top Contributors

[![softius](https://avatars.githubusercontent.com/u/586121?v=4)](https://github.com/softius "softius (17 commits)")

---

Tags

debugexceptions

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/softius-exceptionist/health.svg)

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

###  Alternatives

[symfony/var-dumper

Provides mechanisms for walking through any arbitrary PHP variable

7.4k855.5M8.0k](/packages/symfony-var-dumper)[barryvdh/laravel-debugbar

PHP Debugbar integration for Laravel

19.2k124.3M624](/packages/barryvdh-laravel-debugbar)[php-debugbar/php-debugbar

Debug bar in the browser for php application

4.4k21.3M40](/packages/php-debugbar-php-debugbar)[fruitcake/laravel-debugbar

PHP Debugbar integration for Laravel

19.1k662.9k29](/packages/fruitcake-laravel-debugbar)[kint-php/kint

Kint - Advanced PHP dumper

2.8k19.3M283](/packages/kint-php-kint)[tracy/tracy

😎 Tracy: the addictive tool to ease debugging PHP code for cool developers. Friendly design, logging, profiler, advanced features like debugging AJAX calls or CLI support. You will love it.

1.8k24.4M1.3k](/packages/tracy-tracy)

PHPackages © 2026

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