Debug Class Reference

Static Public Member Functions
static	getRootPath ()
static	backtrace ($return=false, $html=true, $withArgs=true)
static	trace (array $trace, $return=false, $html=true, $withArgs=true)

Static Public Attributes
static	$argLength = 16

Static Protected Member Functions
static	_formatCalledArgument ($arg)

Static Protected Attributes
static	$_filePath

Detailed Description

Magento Debug methods

Definition at line 11 of file Debug.php.

Member Function Documentation

_formatCalledArgument()

static _formatCalledArgument (   $arg )

staticprotected

Format argument in called method

Parameters

mixed

$arg

Returns

string @SuppressWarnings(PHPMD.CyclomaticComplexity)

Definition at line 148 of file Debug.php.

    {
        $out = '';
        if (is_object($arg)) {
            $out .= sprintf("&%s#%s#", get_class($arg), spl_object_hash($arg));
        } elseif (is_resource($arg)) {
            $out .= '#[' . get_resource_type($arg) . ']';
        } elseif (is_array($arg)) {
            $isAssociative = false;
            $args = [];
            foreach ($arg as $k => $v) {
                if (!is_numeric($k)) {
                    $isAssociative = true;
                }
                $args[$k] = self::_formatCalledArgument($v);
            }
            if ($isAssociative) {
                $arr = [];
                foreach ($args as $k => $v) {
                    $arr[] = self::_formatCalledArgument($k) . ' => ' . $v;
                }
                $out .= 'array(' . join(', ', $arr) . ')';
            } else {
                $out .= 'array(' . join(', ', $args) . ')';
            }
        } elseif ($arg === null) {
            $out .= 'NULL';
        } elseif (is_numeric($arg) || is_float($arg)) {
            $out .= $arg;
        } elseif (is_string($arg)) {
            if (strlen($arg) > self::$argLength) {
                $arg = substr($arg, 0, self::$argLength) . "...";
            }
            $arg = strtr($arg, ["\t" => '\t', "\r" => '\r', "\n" => '\n', "'" => '\\\'']);
            $out .= "'" . $arg . "'";
        } elseif (is_bool($arg)) {
            $out .= $arg === true ? 'true' : 'false';
        }

        return $out;
    }

backtrace()

static backtrace (   $return = false,   $html = true,   $withArgs = true  )

static

Prints or returns a backtrace

Parameters

bool	$return	return or print
bool	$html	output in HTML format
bool	$withArgs	add short arguments of methods

Returns

string|bool

Definition at line 50 of file Debug.php.

    {
        $trace = debug_backtrace();
        return self::trace($trace, $return, $html, $withArgs);
    }

getRootPath()

static getRootPath ( )

static

Retrieve real root path with last directory separator

Returns

string

Definition at line 30 of file Debug.php.

    {
        if (self::$_filePath === null) {
            if (defined('BP')) {
                self::$_filePath = BP;
            } else {
                self::$_filePath = dirname(__DIR__);
            }
        }
        return self::$_filePath;
    }

trace()

static trace ( array  $trace,   $return = false,   $html = true,   $withArgs = true  )

static

Prints or return a trace

Parameters

array	$trace	trace array
bool	$return	return or print
bool	$html	output in HTML format
bool	$withArgs	add short arguments of methods

Returns

string|bool @SuppressWarnings(PHPMD.CyclomaticComplexity) @SuppressWarnings(PHPMD.NPathComplexity)

Definition at line 67 of file Debug.php.

    {
        $out = '';
        if ($html) {
            $out .= '<pre>';
        }

        foreach ($trace as $i => $data) {
            // skip self
            if ($i == 0) {
                continue;
            }

            // prepare method arguments
            $args = [];
            if (isset($data['args']) && $withArgs) {
                foreach ($data['args'] as $arg) {
                    $args[] = self::_formatCalledArgument($arg);
                }
            }

            // prepare method's name
            if (isset($data['class']) && isset($data['function'])) {
                if (isset($data['object']) && get_class($data['object']) != $data['class']) {
                    $className = get_class($data['object']) . '[' . $data['class'] . ']';
                } else {
                    $className = $data['class'];
                }
                if (isset($data['object'])) {
                    $className .= sprintf('#%s#', spl_object_hash($data['object']));
                }

                $methodName = sprintf(
                    '%s%s%s(%s)',
                    $className,
                    isset($data['type']) ? $data['type'] : '->',
                    $data['function'],
                    join(', ', $args)
                );
            } elseif (isset($data['function'])) {
                $methodName = sprintf('%s(%s)', $data['function'], join(', ', $args));
            }

            if (isset($data['file'])) {
                $pos = strpos($data['file'], self::getRootPath());
                if ($pos !== false) {
                    $data['file'] = substr($data['file'], strlen(self::getRootPath()) + 1);
                }
                $fileName = sprintf('%s:%d', $data['file'], $data['line']);
            } else {
                $fileName = false;
            }

            if ($fileName) {
                $out .= sprintf('#%d %s called at [%s]', $i, $methodName, $fileName);
            } else {
                $out .= sprintf('#%d %s', $i, $methodName);
            }

            $out .= "\n";
        }

        if ($html) {
            $out .= '</pre>';
        }

        if ($return) {
            return $out;
        } else {
            echo $out;
            return true;
        }
    }

Field Documentation

$_filePath

$_filePath

staticprotected

Definition at line 23 of file Debug.php.

$argLength

$argLength = 16

static

Definition at line 16 of file Debug.php.

---

The documentation for this class was generated from the following file:

• vendor/magento/framework/Debug.php