PHPackages                             apex/debugger - 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. apex/debugger

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

apex/debugger
=============

Lightweight, portable debugger for use in any application.

2.0(4y ago)18921MITPHPPHP >=8.0

Since Feb 28Pushed 4y ago1 watchersCompare

[ Source](https://github.com/apexpl/debugger)[ Packagist](https://packagist.org/packages/apex/debugger)[ Docs](https://apexpl.io)[ RSS](/packages/apex-debugger/feed)WikiDiscussions master Synced 3w ago

READMEChangelogDependencies (3)Versions (7)Used By (1)

Apex Debugger
=============

[](#apex-debugger)

A lightweight, portable debugger that can easily be used within any application to gather and analyze details of requests. It supports:

- Combines PSR-3 compliant logging for simplicity, so one call will add line item to both debugger and logger.
- Use any numeric debug level to signify the detail of messages when both, adding debug messages and compiling debug sessions.
- Retrieve and analyze session information via command line tool, rendered HTML, or PHP arrays.
- Saves basic request info, debug messages including caller (file, line, class, method), full backtrace, inputs (post, get, cookie, et al), and any optional items.

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

[](#installation)

Install via Composer with:

> `composer require apex/debugger`

Table of Contents
-----------------

[](#table-of-contents)

1. [Debugger](https://github.com/apexpl/debugger/blob/master/docs/debugger.md)
2. Reading Debug Sessions
    1. [Command Line Viewer](https://github.com/apexpl/debugger/blob/master/docs/cli_viewer.md)
    2. [HTML Loader](https://github.com/apexpl/debugger/blob/master/docs/html_loader.md)
    3. [Array Loader](https://github.com/apexpl/debugger/blob/master/docs/array_loader.md)

Basic Usage
-----------

[](#basic-usage)

```
use Apex\Debugger\Debugger;

// Init debugger
$debugger = new Debugger(3);   // 3 = detail level of debug messages to log

// Throughout your code, add debug items.
$debugger->add(3, "My debug line item...", 'notice');   // 'notice' will add to PSR-3 logger as well.

// Add more detailed line at level 5, no logging
$debugger->add(5, 'Detailed item');

// At end of request, or within exception handler, finish up and save debug session
$session = $debugger->finish();

// Within exception handler
function handleException(Exception $e) {
    $debugger->finish($e);
}
```

Reading Debug Sessions
----------------------

[](#reading-debug-sessions)

Simply run the PHP script located at /vendor/bin/debugger in your installation:

`php ./vendor/bin/debugger`

The menu based command line tool will start showing a list of recently saved debug sessions, which you may enter into. The next screen shows another menu allowing you to select the exact information you would like to view regarding the request. Instead of the command line tool, you may also retrieve debug sessions via the [HTML Loader](https://github.com/apexpl/debugger/blob/master/docs/html_loader.md) or the [ArrayLoader](https://github.com/apexpl/debugger/blob/master/docs/array_loader.md).

Follow Apex
-----------

[](#follow-apex)

Loads of good things coming in the near future including new quality open source packages, more advanced articles / tutorials that go over down to earth useful topics, et al. Stay informed by joining the [mailing list](https://apexpl.io/) on our web site, or follow along on Twitter at [@ApexPlatform](https://twitter.com/ApexPlatform).

###  Health Score

30

—

LowBetter than 62% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity15

Limited adoption so far

Community11

Small or concentrated contributor base

Maturity62

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

Recently: every ~84 days

Total

6

Last Release

1605d ago

Major Versions

0.1.5 → 2.02022-01-30

PHP version history (2 changes)0.1PHP >=8.0.0

2.0PHP >=8.0

### Community

Maintainers

![](https://www.gravatar.com/avatar/4fe486d2ed7db571c0519bb0d52b08b5e953a911936e87331e736a381ef96f29?d=identicon)[apex](/maintainers/apex)

---

Top Contributors

[![mdizak](https://avatars.githubusercontent.com/u/59886259?v=4)](https://github.com/mdizak "mdizak (7 commits)")

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/apex-debugger/health.svg)

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

###  Alternatives

[symfony/error-handler

Provides tools to manage errors and ease debugging PHP code

2.7k682.0M762](/packages/symfony-error-handler)[symfony/cache

Provides extended PSR-6, PSR-16 (and tags) implementations

4.2k365.0M3.1k](/packages/symfony-cache)[php-debugbar/php-debugbar

Debug bar in the browser for php application

4.4k26.7M61](/packages/php-debugbar-php-debugbar)[matomo/matomo

Matomo is the leading Free/Libre open analytics platform

21.6k38.2k](/packages/matomo-matomo)[tempest/framework

The PHP framework that gets out of your way.

2.2k31.1k12](/packages/tempest-framework)[ecotone/ecotone

Enterprise architecture layer for Laravel and Symfony — CQRS, Event Sourcing, Durable Workflows (Sagas, Orchestrators), Projections, and Outbox messaging via PHP attributes.

562565.8k42](/packages/ecotone-ecotone)

PHPackages © 2026

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