| 123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272 | <?php/** * @link http://www.yiiframework.com/ * @copyright Copyright (c) 2008 Yii Software LLC * @license http://www.yiiframework.com/license/ */namespace yii\helpers;use yii\base\Arrayable;use yii\base\InvalidValueException;/** * BaseVarDumper provides concrete implementation for [[VarDumper]]. * * Do not use BaseVarDumper. Use [[VarDumper]] instead. * * @author Qiang Xue <qiang.xue@gmail.com> * @since 2.0 */class BaseVarDumper{    private static $_objects;    private static $_output;    private static $_depth;    /**     * Displays a variable.     * This method achieves the similar functionality as var_dump and print_r     * but is more robust when handling complex objects such as Yii controllers.     * @param mixed $var variable to be dumped     * @param int $depth maximum depth that the dumper should go into the variable. Defaults to 10.     * @param bool $highlight whether the result should be syntax-highlighted     */    public static function dump($var, $depth = 10, $highlight = false)    {        echo static::dumpAsString($var, $depth, $highlight);    }    /**     * Dumps a variable in terms of a string.     * This method achieves the similar functionality as var_dump and print_r     * but is more robust when handling complex objects such as Yii controllers.     * @param mixed $var variable to be dumped     * @param int $depth maximum depth that the dumper should go into the variable. Defaults to 10.     * @param bool $highlight whether the result should be syntax-highlighted     * @return string the string representation of the variable     */    public static function dumpAsString($var, $depth = 10, $highlight = false)    {        self::$_output = '';        self::$_objects = [];        self::$_depth = $depth;        self::dumpInternal($var, 0);        if ($highlight) {            $result = highlight_string("<?php\n" . self::$_output, true);            self::$_output = preg_replace('/<\\?php<br \\/>/', '', $result, 1);        }        return self::$_output;    }    /**     * @param mixed $var variable to be dumped     * @param int $level depth level     */    private static function dumpInternal($var, $level)    {        switch (gettype($var)) {            case 'boolean':                self::$_output .= $var ? 'true' : 'false';                break;            case 'integer':                self::$_output .= (string)$var;                break;            case 'double':                self::$_output .= (string)$var;                break;            case 'string':                self::$_output .= "'" . addslashes($var) . "'";                break;            case 'resource':                self::$_output .= '{resource}';                break;            case 'NULL':                self::$_output .= 'null';                break;            case 'unknown type':                self::$_output .= '{unknown}';                break;            case 'array':                if (self::$_depth <= $level) {                    self::$_output .= '[...]';                } elseif (empty($var)) {                    self::$_output .= '[]';                } else {                    $keys = array_keys($var);                    $spaces = str_repeat(' ', $level * 4);                    self::$_output .= '[';                    foreach ($keys as $key) {                        self::$_output .= "\n" . $spaces . '    ';                        self::dumpInternal($key, 0);                        self::$_output .= ' => ';                        self::dumpInternal($var[$key], $level + 1);                    }                    self::$_output .= "\n" . $spaces . ']';                }                break;            case 'object':                if (($id = array_search($var, self::$_objects, true)) !== false) {                    self::$_output .= get_class($var) . '#' . ($id + 1) . '(...)';                } elseif (self::$_depth <= $level) {                    self::$_output .= get_class($var) . '(...)';                } else {                    $id = array_push(self::$_objects, $var);                    $className = get_class($var);                    $spaces = str_repeat(' ', $level * 4);                    self::$_output .= "$className#$id\n" . $spaces . '(';                    if ('__PHP_Incomplete_Class' !== get_class($var) && method_exists($var, '__debugInfo')) {                        $dumpValues = $var->__debugInfo();                        if (!is_array($dumpValues)) {                            throw new InvalidValueException('__debuginfo() must return an array');                        }                    } else {                        $dumpValues = (array) $var;                    }                    foreach ($dumpValues as $key => $value) {                        $keyDisplay = strtr(trim($key), "\0", ':');                        self::$_output .= "\n" . $spaces . "    [$keyDisplay] => ";                        self::dumpInternal($value, $level + 1);                    }                    self::$_output .= "\n" . $spaces . ')';                }                break;        }    }    /**     * Exports a variable as a string representation.     *     * The string is a valid PHP expression that can be evaluated by PHP parser     * and the evaluation result will give back the variable value.     *     * This method is similar to `var_export()`. The main difference is that     * it generates more compact string representation using short array syntax.     *     * It also handles objects by using the PHP functions serialize() and unserialize().     *     * PHP 5.4 or above is required to parse the exported value.     *     * @param mixed $var the variable to be exported.     * @return string a string representation of the variable     */    public static function export($var)    {        self::$_output = '';        self::exportInternal($var, 0);        return self::$_output;    }    /**     * @param mixed $var variable to be exported     * @param int $level depth level     */    private static function exportInternal($var, $level)    {        switch (gettype($var)) {            case 'NULL':                self::$_output .= 'null';                break;            case 'array':                if (empty($var)) {                    self::$_output .= '[]';                } else {                    $keys = array_keys($var);                    $outputKeys = ($keys !== range(0, count($var) - 1));                    $spaces = str_repeat(' ', $level * 4);                    self::$_output .= '[';                    foreach ($keys as $key) {                        self::$_output .= "\n" . $spaces . '    ';                        if ($outputKeys) {                            self::exportInternal($key, 0);                            self::$_output .= ' => ';                        }                        self::exportInternal($var[$key], $level + 1);                        self::$_output .= ',';                    }                    self::$_output .= "\n" . $spaces . ']';                }                break;            case 'object':                if ($var instanceof \Closure) {                    self::$_output .= self::exportClosure($var);                } else {                    try {                        $output = 'unserialize(' . var_export(serialize($var), true) . ')';                    } catch (\Exception $e) {                        // serialize may fail, for example: if object contains a `\Closure` instance                        // so we use a fallback                        if ($var instanceof Arrayable) {                            self::exportInternal($var->toArray(), $level);                            return;                        } elseif ($var instanceof \IteratorAggregate) {                            $varAsArray = [];                            foreach ($var as $key => $value) {                                $varAsArray[$key] = $value;                            }                            self::exportInternal($varAsArray, $level);                            return;                        } elseif ('__PHP_Incomplete_Class' !== get_class($var) && method_exists($var, '__toString')) {                            $output = var_export($var->__toString(), true);                        } else {                            $outputBackup = self::$_output;                            $output = var_export(self::dumpAsString($var), true);                            self::$_output = $outputBackup;                        }                    }                    self::$_output .= $output;                }                break;            default:                self::$_output .= var_export($var, true);        }    }    /**     * Exports a [[Closure]] instance.     * @param \Closure $closure closure instance.     * @return string     */    private static function exportClosure(\Closure $closure)    {        $reflection = new \ReflectionFunction($closure);        $fileName = $reflection->getFileName();        $start = $reflection->getStartLine();        $end = $reflection->getEndLine();        if ($fileName === false || $start === false || $end === false) {            return 'function() {/* Error: unable to determine Closure source */}';        }        --$start;        $source = implode("\n", array_slice(file($fileName), $start, $end - $start));        $tokens = token_get_all('<?php ' . $source);        array_shift($tokens);        $closureTokens = [];        $pendingParenthesisCount = 0;        foreach ($tokens as $token) {            if (isset($token[0]) && $token[0] === T_FUNCTION) {                $closureTokens[] = $token[1];                continue;            }            if ($closureTokens !== []) {                $closureTokens[] = isset($token[1]) ? $token[1] : $token;                if ($token === '}') {                    $pendingParenthesisCount--;                    if ($pendingParenthesisCount === 0) {                        break;                    }                } elseif ($token === '{') {                    $pendingParenthesisCount++;                }            }        }        return implode('', $closureTokens);    }}
 |