README

This is a fork of digitalnature/php-ref with updates from Juan Manuel Cabello to include PHP8 adaptations, modified to use dd() like in Laravel Framework.

REF, or dd() is a nicer alternative to PHP's print_r / var_dump / or r() itself functions

Demo

DEMO from digitalnature/php-ref

Installation

Start by installing composer. Next do:

$ composer require w3spi5/php-ref-dd

Requirements

PHP 8.x+

Now tell composer to download the bundle by running:

Composer will install the bundle to the directory vendor/w3spi5.

Usage

Basic example:

// include the class (not needed if project runs with Composer because it's auto-loaded)
require '/full/path/to/ref.php';

// display info about defined classes
dd(get_declared_classes());

// display info about global variables
dd($GLOBALS);

To print in text mode you can use the ddt() function instead:

ddt($var);

To terminate the script after the info is dumped, prepend the bitwise NOT operator:

~dd($var);   // html
~ddt($var);  // text

Prepending the error control operator (@) will return the information:

$output = @dd($var);   // html
$output = @ddt($var);  // text

Keyboard shortcuts (javascript must be enabled):

• X - collapses / expands all levels

To modify the global configuration call ref::config():

// example: initially expand first 3 levels
ref::config('expLvl', 3);

Currently available options and their default values:

License

This library is released under the MIT license. See the complete license in the LICENSE file.