PHPackages                             franz-deleon/fdl-debug - 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. franz-deleon/fdl-debug

ActiveLibrary

franz-deleon/fdl-debug
======================

A super simple, no dependency, extendable PHP debugger helper.

042PHP

Since Aug 18Pushed 3y ago1 watchersCompare

[ Source](https://github.com/franz-deleon/FdlDebug)[ Packagist](https://packagist.org/packages/franz-deleon/fdl-debug)[ RSS](/packages/franz-deleon-fdl-debug/feed)WikiDiscussions develop Synced today

READMEChangelogDependenciesVersions (2)Used By (0)

FdlDebug
========

[](#fdldebug)

[![Build Status](https://camo.githubusercontent.com/cfdfaa64b70706bfeb11edf44cb83275445fdd7412a3083b3d03c64f8d213128/68747470733a2f2f7472617669732d63692e6f72672f6672616e7a2d64656c656f6e2f46646c44656275672e706e673f6272616e63683d646576656c6f70)](https://travis-ci.org/franz-deleon/FdlDebug)

FdlDebug is a super simple PHP debugger outputter with a twist. It's like var\_dump() but more!

#### Sneak peak on usage

[](#sneak-peak-on-usage)

```
\FdlDebug\Front::i()->pr("Hello Yo!"); // outputs: "Hello Yo!"
// procedural style
pr("Hello Yo"); // output: "Hello Yo!"

// Another example. Imagine you are in a large loop and...
for ($i = 0; $i pr("Yes! its at {$i}");

    // you want to print iterations 5006 to 5010
    cond_range(5006, 5)->pr($i); // prints: 5006, 5007, 5008, 5009, 5010

    // you want to print the end of the loop
    cond_from('end')->pr($i); // prints: 10000
}
```

Yep, thats how simple it is to use! You just grab the `Front::i()` instance and call one of the [Debug Methods](#debug-methods).

How to install it.

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

[](#requirements)

- PHP 5.3
- XDebug (optional)

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

[](#installation)

#### Composer

[](#composer)

If your project uses Composer, just add to **composer.json**:

```
"require": {
    "franz-deleon/fdl-debug": "dev-develop"
}
```

or add using command line:

```
$> php composer.phar require franz-deleon/fdl-debug
```

#### GitHub

[](#github)

No Composer, no problemo. Use git.

```
$> cd path/to/lib/fdldebug
$> git clone git@github.com:franz-deleon/FdlDebug.git .
```

#### Enabling for procedural projects

[](#enabling-for-procedural-projects)

If you dont use Composer or use any autoloading, including the **Bootstrapper.php** file will autoload the library for you.

```
include_once 'path/to/fdldebug/Bootstrapper.php';

// call the instance
\FdlDebug\Front::i()->pr('wuzzup'); //outputs: "wuzzup"
```

Conditions
----------

[](#conditions)

Conditions as what I call it is the butter of FdlDebug. It basically adds features on how you call your prints or var\_dumps via the Front instance.

##### 1. Boolean Condition - `condBoolean(bool $booleanExpression)` | `cond_bool(bool $booleanExpression)`

[](#1-boolean-condition---condbooleanbool-booleanexpression--cond_boolbool-booleanexpression)

The Boolean Condition is a simple way of passing boolean expression to determine if your data should be printed.

For example, only print if the condition evaulates to *true*:

```
use \FdlDebug\Front as Fdbug;

$x = rand(1, 10); // assume $x is 5
Fdbug::i()->condBoolean($x === 5)->pr('Yep its 5'); // outputs: Yep its 5
// function hybrid style
cond_bool($x === 5)->pr('Yep its 5');
```

How about if I only want to print if the loop iteration is of even numbers.

```
for ($x = 1; $x condBoolean($x % 2 === 0)->pr("$x is even");
  // function hybrid style
  cond_bool($x % 2 === 0)->pr("$x is even");
}
// outputs:
// 2 is even
// 4 is even
```

##### 2. Loop Range Condition - `loopRange(int $offsetStart [, int $length])` | `cond_range(int $offsetStart [, int $length])`

[](#2-loop-range-condition---looprangeint-offsetstart--int-length--cond_rangeint-offsetstart--int-length)

The Loop Range condition is useful when printing a range of data inside a loop.

For example, only print when the iteration of the loop is the 3rd upto the end.

```
use \FdlDebug\Front as Fdbug;

for ($x = 1; $x loopRange(3)->pr($x);
  // function hybrid style
  cond_range(3)->pr($x);
}
// outputs:
// 3
// 4
// 5
```

`loopRange($range [, int $length])` also accepts a length parameter if you only want to print certain length of ranges

```
for ($x = 1; $x loopRange(2, 2)->pr($x);
  // function hybrid style
  cond_range(2, 2)->pr($x);
}
// outputs:
// 2
// 3
```

For multiple nested loops, you need to add `rangeNestedEnd()` at the end of each nested loop:

```
for ($x = 1; $x loopRange(2, 1)->pr("1st:" . $x);
    // function hybrid style
    cond_range(2, 1)->pr("1st:" . $x);

    for ($y = 1; $y (3, 1)->pr("2nd:" . $y);
        // function hybrid style
        cond_range(3, 1)->pr("2nd:" . $y);
    }

    // the nested end identifier needs to be place here
    Fdbug::i()->(3, 1)->rangeNestedEnd();
    // function hybrid style
    cond_range_nested_end();
}

// outputs
// 2nd:3
// 1st:2
// 2nd:3
```

##### 3. Loop From Condition - `loopFrom(string $expression [, int $length])` | `cond_from(string $expression [, int $length])`

[](#3-loop-from-condition---loopfromstring-expression--int-length--cond_fromstring-expression--int-length)

The Loop From condition is a pretty dynamic condition designed if you dont know the count of your loop iterations.

For example, you want to print the end iteration of a mysql resource.

```
use \FdlDebug\Front as Fdbug;

// asume the end outputs "123"
while ($row = mysql_fetch_assoc()) {
   Fdbug::i()->loopFrom('end')->pr($row['col']);
   // function hybrid style
   cond_from('end')->pr($row['col']);
}
Fdbug::i()->loopFromFlush(); // you need to call loopFromFlush() at the end of the loop
// function hybrid style
cond_from_flush();

// outputs:
// 123
```

When using `loopFrom()`, you need to call `loopFromFlush()` at the end of the loop in order to print the data.

How about if you only want to print the 3rd iteration from the 'end' of the loop?

```
for ($x = 1; $x loopFrom('3rd from end')->pr($x);
}
Fdbug::i()->loopFromFlush();
// outputs:
// 8
// 9
// 10
```

Lets print the middle of the loop.

```
for ($x = 1; $x loopFrom('middle', 1)->pr($x);
}
Fdbug::i()->loopFromFlush();
// outputs:
// 3
```

How about 2 iterations before the median/middle of 5?

```
for ($x = 1; $x loopFrom('2 before median', 1)->pr($x);
}
Fdbug::i()->loopFromFlush();
// outputs:
// 1
```

The `loopFrom(string $expression)` accepts expression type statements so these type of statements are valid:
"*first*", "*beginning*", "*start*", "*middle*", "median", "2 before middle", "2 after median",
"*3rd from start*", "*4th from last*", "*5th from end*", "*end*", "*last*", ...

As you may have noticed, you can also pass a length variable to `loopFrom(strin $expression [, int $length])`

```
for ($x = 1; $x loopFrom('4th from last', 2)->pr($x);
}
Fdbug::i()->loopFromFlush();
// outputs:
// 7
// 8
```

You can also use multiple `loopFrom` conditions (also true for other conditions) while in nested loops.

```
$fdbug = Fdbug::i();
for ($i = 1; $i loopFrom('3rd from end', 1)->pr("3rd-from-end:" . $i);
    for ($x = 1; $x loopFrom('2nd from start', 1)->pr("2nd-from-start:" . $x);
    }
}
$fdbug->loopFromFlush(); // now flush everything!
// outputs:
// 3rd-from-end:3
// 2nd-from-start:2
```

##### Session Instance Condition

[](#session-instance-condition)

In development

#### Chaining Conditions

[](#chaining-conditions)

You can chain conditions if you want.

```
use \FdlDebug\Front as Fdbug;

for ($x = 1; $x condBoolean($x % 2 === 0)
        ->loopRange(3, 4)
        ->pr($x)
    ;
    // procedural style
    cond_bool($x % 2 === 0)
        ->cond_range(3, 4)
        ->pr($x);
}
// outputs:
// 4
// 6
```

### Debug Methods

[](#debug-methods)

- `fd_i()` - function to retrieve the fdldebug instance
- `fd_writer()` - function to retrieve the writer object instance
- `pr(mixed $value)` - alias for printNow()
- `prd(mixed $value)` - same as pr() but dies automatically
- `printObject(object $value)` | `pr_object` - outputs information on an object
- `printNow(mixed $value)` | `pr_now(mixed $value)` - prints something by passing the argument `$value` to the Writer
- `printBackTrace($showVendor = false)` | `pr_backtrace($show_vendor = false)` - prints a php back trace using the Writer
- `printFiles($showVendor = false)` | `pr_files($show_endor = false)` - prints a file trace using the Writer
- `printGlobal(string $globalType = null)` | `pr_global(string $globalType)` - prints data from php's global variables

```
  \\ 'SERVER', 'GET', 'POST', 'FILES', 'REQUEST', 'SESSION', 'ENV', 'COOKIE'
  \FdlDebug\Front::i()->printGlobal('get');
  /** outputs
  outputs:
    array (size=28)
      'APPLICATION_ENV' => string 'local' (length=5)
      'WEB_ENV' => string 'local' (length=5)
      [...]
  */
```

### XDebug Methods (extension)

[](#xdebug-methods-extension)

- `printXdebugTracedVar(string $search, bool $showVendor)` | `prx_trace_var(string $search, bool $showVendor)` - prints a trace of the target variable `$search`. This method makes use of XDebug's tracing functionality by looking at `XDEBUG_TRACE=1`

    Example output:

    ```
    // in Bootstrap.php line 20 of some mvc framework, pretend below is written:
    $hello = "hello world";

    // Now pretend you are in XController.php of some mvc framework
    \FdlDebug\Front::i()->printXdebugTracedVar('hello');
    /** outputs:
    array (size=1)
      1 =>
         array (size=4)
           'file' => string '/someframework/Bootstrap.php' (length=54)
           'line' => string '20' (length=2)
           'var($hello) assignment' =>
             array (size=1)
               0 => string '$hello = 'hello' (length=15)
           'initialization' => string '$hello = 'hello world'' (length=22)
    */
    ```

    \*Please remember that you need to enable XDEBUG\_TRACE. You can use some XDebug browser extensions to enable it or by passing XDEBUG\_TRACE to `http://domain.com/?XDEBUG_TRACE=1` (not recommended)

###  Health Score

17

—

LowBetter than 6% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity8

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity27

Early-stage or recently created project

 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.

### Community

Maintainers

![](https://www.gravatar.com/avatar/59b9877135752fc1bb4f1a171a1d29e0feba8d3c9c62d9cb13914b2b6b3e50a4?d=identicon)[franz-deleon](/maintainers/franz-deleon)

---

Top Contributors

[![franz-deleon](https://avatars.githubusercontent.com/u/715451?v=4)](https://github.com/franz-deleon "franz-deleon (62 commits)")

### Embed Badge

![Health badge](/badges/franz-deleon-fdl-debug/health.svg)

```
[![Health](https://phpackages.com/badges/franz-deleon-fdl-debug/health.svg)](https://phpackages.com/packages/franz-deleon-fdl-debug)
```

PHPackages © 2026

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