donquixote/nicetrace

Library to make human-friendly PHP backtrace arrays.

Maintainers

Details

github.com/donquixote/nicetrace

Homepage

Source

Issues

Installs: 825

Dependents: 1

Suggesters: 0

Security: 0

Stars: 0

Watchers: 2

Forks: 0

Open Issues: 0

0.0.4 2016-03-06 06:06 UTC

MIT 774dd8f40643ee5583dd8c510ead8a511d38e0e7

  • Andreas Hennings <andreas.woop@dqxtech.net>

This package is auto-updated.

Last update: 2024-04-24 12:59:44 UTC

README

PHP library to generate a human-friendly backtrace array.

Inspired from ddebug_backtrace() in the Devel module for Drupal.

The structure of the nicetrace can be seen in nicetrace.php

Development status

This library is quite fresh, and I am still ironing out API details, that is, names of interfaces, method signatures, etc.
You are welcome to participate.

Features

The main design goal is a backtrace array structure that looks nice in recursive array display tools, such as Krumo, or possibly Ladybug.

  • Indices of trace items enhanced with function / method names.
  • Indices for arguments enhanced with parameter names (based on reflection).
  • Indices of trace items reversed, so that the index reflects the depth in the call tree.
  • Arguments inlined, so the array becomes flatter. E.g.
    $backtrace[5]['args'][0] = .. becomes
    $nicetrace[' 8: foo()']['args[0]: $x'] = ...
  • Filename and line number from trace item one level deeper, instead of the "called from".
  • File paths shortened, if known base paths are specified.
  • File basename and line number combined into one array key. E.g.
    $backtrace[5]['file'] = '/../src/MyNamespace/MyFile.php'; $backtrace[5]['line'] = 97; becomes
    $nicetrace[' 8: foo()']['MyClass.php: 97'] = 'src/MyNamespace/MyClass.php';

Basic usage

use Donquixote\Nicetrace\Util\NicetraceUtil;

$backtrace = debug_backtrace();
$nicetrace = NicetraceUtil::backtraceGetNicetrace($backtrace);

// Choose your favourite recursive function/method for recursive printing.
print_r($nicetrace);

Advanced usage

The library allows to create and compose custom BacktraceToNicetrace handlers.

It is recommended to use the fluent interface provided by the Builder class.

use Donquixote\Nicetrace\BacktraceToNicetrace\BacktraceToNicetraceBuilder;

$backtrace = debug_backtrace();
$backtraceToNicetrace = BacktraceToNicetraceBuilder::start()
  ->withClasslessKey()
  ->create();
$nicetrace = NicetraceUtil::backtraceGetNicetrace($backtrace);

// Choose your favourite recursive function/method for recursive printing.
print_r($nicetrace);

The test case gives some examples.