Packages

  • Nette
    • Application
      • Diagnostics
      • Responses
      • Routers
      • UI
    • Caching
      • Storages
    • ComponentModel
    • Config
      • Adapters
      • Extensions
    • Database
      • Diagnostics
      • Drivers
      • Reflection
      • Table
    • DI
      • Diagnostics
    • Diagnostics
    • Forms
      • Controls
      • Rendering
    • Http
    • Iterators
    • Latte
      • Macros
    • Loaders
    • Localization
    • Mail
    • Reflection
    • Security
      • Diagnostics
    • Templating
    • Utils
      • PhpGenerator
  • NetteModule
  • None
  • PHP

Classes

  • DebugBar
  • DebugBlueScreen
  • Debugger
  • DebugHelpers
  • FireLogger
  • Logger

Interfaces

  • IBarPanel
  • Overview
  • Package
  • Class
  • Tree
  • Deprecated
  1: <?php
  2: 
  3: /**
  4:  * This file is part of the Nette Framework (http://nette.org)
  5:  *
  6:  * Copyright (c) 2004 David Grudl (http://davidgrudl.com)
  7:  *
  8:  * For the full copyright and license information, please view
  9:  * the file license.txt that was distributed with this source code.
 10:  * @package Nette\Diagnostics
 11:  */
 12: 
 13: 
 14: 
 15: /**
 16:  * Rendering helpers for Debugger.
 17:  *
 18:  * @author     David Grudl
 19:  * @package Nette\Diagnostics
 20:  */
 21: final class DebugHelpers
 22: {
 23: 
 24:     /**
 25:      * Returns link to editor.
 26:      * @return Html
 27:      */
 28:     public static function editorLink($file, $line)
 29:     {
 30:         if (Debugger::$editor && is_file($file)) {
 31:             $dir = dirname(strtr($file, '/', DIRECTORY_SEPARATOR));
 32:             $base = isset($_SERVER['SCRIPT_FILENAME']) ? dirname(dirname(strtr($_SERVER['SCRIPT_FILENAME'], '/', DIRECTORY_SEPARATOR))) : dirname($dir);
 33:             if (substr($dir, 0, strlen($base)) === $base) {
 34:                 $dir = '...' . substr($dir, strlen($base));
 35:             }
 36:             return Html::el('a')
 37:                 ->href(strtr(Debugger::$editor, array('%file' => rawurlencode($file), '%line' => $line)))
 38:                 ->title("$file:$line")
 39:                 ->setHtml(htmlSpecialChars(rtrim($dir, DIRECTORY_SEPARATOR)) . DIRECTORY_SEPARATOR . '<b>' . htmlSpecialChars(basename($file)) . '</b>');
 40:         } else {
 41:             return Html::el('span')->setText($file);
 42:         }
 43:     }
 44: 
 45: 
 46:     /**
 47:      * Internal dump() implementation.
 48:      * @param  mixed  variable to dump
 49:      * @param  int    current recursion level
 50:      * @return string
 51:      */
 52:     public static function htmlDump(&$var, $level = 0)
 53:     {
 54:         static $tableUtf, $tableBin, $reBinary = '#[^\x09\x0A\x0D\x20-\x7E\xA0-\x{10FFFF}]#u';
 55:         if ($tableUtf === NULL) {
 56:             foreach (range("\x00", "\xFF") as $ch) {
 57:                 if (ord($ch) < 32 && strpos("\r\n\t", $ch) === FALSE) {
 58:                     $tableUtf[$ch] = $tableBin[$ch] = '\\x' . str_pad(dechex(ord($ch)), 2, '0', STR_PAD_LEFT);
 59:                 } elseif (ord($ch) < 127) {
 60:                     $tableUtf[$ch] = $tableBin[$ch] = $ch;
 61:                 } else {
 62:                     $tableUtf[$ch] = $ch; $tableBin[$ch] = '\\x' . dechex(ord($ch));
 63:                 }
 64:             }
 65:             $tableBin["\\"] = '\\\\';
 66:             $tableBin["\r"] = '\\r';
 67:             $tableBin["\n"] = '\\n';
 68:             $tableBin["\t"] = '\\t';
 69:             $tableUtf['\\x'] = $tableBin['\\x'] = '\\\\x';
 70:         }
 71: 
 72:         if (is_bool($var)) {
 73:             return '<span class="php-bool">' . ($var ? 'TRUE' : 'FALSE') . "</span>\n";
 74: 
 75:         } elseif ($var === NULL) {
 76:             return "<span class=\"php-null\">NULL</span>\n";
 77: 
 78:         } elseif (is_int($var)) {
 79:             return "<span class=\"php-int\">$var</span>\n";
 80: 
 81:         } elseif (is_float($var)) {
 82:             $var = var_export($var, TRUE);
 83:             if (strpos($var, '.') === FALSE) {
 84:                 $var .= '.0';
 85:             }
 86:             return "<span class=\"php-float\">$var</span>\n";
 87: 
 88:         } elseif (is_string($var)) {
 89:             if (Debugger::$maxLen && strlen($var) > Debugger::$maxLen) {
 90:                 $s = htmlSpecialChars(substr($var, 0, Debugger::$maxLen), ENT_NOQUOTES, 'ISO-8859-1') . ' ... ';
 91:             } else {
 92:                 $s = htmlSpecialChars($var, ENT_NOQUOTES, 'ISO-8859-1');
 93:             }
 94:             $s = strtr($s, preg_match($reBinary, $s) || preg_last_error() ? $tableBin : $tableUtf);
 95:             $len = strlen($var);
 96:             return "<span class=\"php-string\">\"$s\"</span>" . ($len > 1 ? " ($len)" : "") . "\n";
 97: 
 98:         } elseif (is_array($var)) {
 99:             $s = '<span class="php-array">array</span>(' . count($var) . ") ";
100:             $space = str_repeat($space1 = '   ', $level);
101:             $brackets = range(0, count($var) - 1) === array_keys($var) ? "[]" : "{}";
102: 
103:             static $marker;
104:             if ($marker === NULL) {
105:                 $marker = uniqid("\x00", TRUE);
106:             }
107:             if (empty($var)) {
108: 
109:             } elseif (isset($var[$marker])) {
110:                 $brackets = $var[$marker];
111:                 $s .= "$brackets[0] *RECURSION* $brackets[1]";
112: 
113:             } elseif ($level < Debugger::$maxDepth || !Debugger::$maxDepth) {
114:                 $s .= "<code>$brackets[0]\n";
115:                 $var[$marker] = $brackets;
116:                 foreach ($var as $k => &$v) {
117:                     if ($k === $marker) {
118:                         continue;
119:                     }
120:                     $k = strtr($k, preg_match($reBinary, $k) || preg_last_error() ? $tableBin : $tableUtf);
121:                     $k = htmlSpecialChars(preg_match('#^\w+$#', $k) ? $k : "\"$k\"");
122:                     $s .= "$space$space1<span class=\"php-key\">$k</span> => " . self::htmlDump($v, $level + 1);
123:                 }
124:                 unset($var[$marker]);
125:                 $s .= "$space$brackets[1]</code>";
126: 
127:             } else {
128:                 $s .= "$brackets[0] ... $brackets[1]";
129:             }
130:             return $s . "\n";
131: 
132:         } elseif (is_object($var)) {
133:             if ($var instanceof Closure) {
134:                 $rc = new ReflectionFunction($var);
135:                 $arr = array();
136:                 foreach ($rc->getParameters() as $param) {
137:                     $arr[] = '$' . $param->getName();
138:                 }
139:                 $arr = array('file' => $rc->getFileName(), 'line' => $rc->getStartLine(), 'parameters' => implode(', ', $arr));
140:             } else {
141:                 $arr = (array) $var;
142:             }
143:             $s = '<span class="php-object">' . get_class($var) . "</span>(" . count($arr) . ") ";
144:             $space = str_repeat($space1 = '   ', $level);
145: 
146:             static $list = array();
147:             if (empty($arr)) {
148: 
149:             } elseif (in_array($var, $list, TRUE)) {
150:                 $s .= "{ *RECURSION* }";
151: 
152:             } elseif ($level < Debugger::$maxDepth || !Debugger::$maxDepth || $var instanceof Closure) {
153:                 $s .= "<code>{\n";
154:                 $list[] = $var;
155:                 foreach ($arr as $k => &$v) {
156:                     $m = '';
157:                     if ($k[0] === "\x00") {
158:                         $m = ' <span class="php-visibility">' . ($k[1] === '*' ? 'protected' : 'private') . '</span>';
159:                         $k = substr($k, strrpos($k, "\x00") + 1);
160:                     }
161:                     $k = strtr($k, preg_match($reBinary, $k) || preg_last_error() ? $tableBin : $tableUtf);
162:                     $k = htmlSpecialChars(preg_match('#^\w+$#', $k) ? $k : "\"$k\"");
163:                     $s .= "$space$space1<span class=\"php-key\">$k</span>$m => " . self::htmlDump($v, $level + 1);
164:                 }
165:                 array_pop($list);
166:                 $s .= "$space}</code>";
167: 
168:             } else {
169:                 $s .= "{ ... }";
170:             }
171:             return $s . "\n";
172: 
173:         } elseif (is_resource($var)) {
174:             $type = get_resource_type($var);
175:             $s = '<span class="php-resource">' . htmlSpecialChars($type) . " resource</span> ";
176: 
177:             static $info = array('stream' => 'stream_get_meta_data', 'curl' => 'curl_getinfo');
178:             if (isset($info[$type])) {
179:                 $space = str_repeat($space1 = '   ', $level);
180:                 $s .= "<code>{\n";
181:                 foreach (call_user_func($info[$type], $var) as $k => $v) {
182:                     $s .= $space . $space1 . '<span class="php-key">' . htmlSpecialChars($k) . "</span> => " . self::htmlDump($v, $level + 1);
183:                 }
184:                 $s .= "$space}</code>";
185:             }
186:             return $s . "\n";
187: 
188:         } else {
189:             return "<span>unknown type</span>\n";
190:         }
191:     }
192: 
193: 
194:     /**
195:      * Dumps variable.
196:      * @param  string
197:      * @return string
198:      */
199:     public static function clickableDump($dump, $collapsed = FALSE)
200:     {
201:         return '<pre class="nette-dump">' . preg_replace_callback(
202:             '#^( *)((?>[^(\r\n]{1,200}))\((\d+)\) <code>#m',
203:             create_function('$m', 'extract($GLOBALS[0]['.array_push($GLOBALS[0], array('collapsed'=>$collapsed)).'-1], EXTR_REFS);
204:                 return "$m[1]<a href=\'#\' rel=\'next\'>$m[2]($m[3]) "
205:                     . (($m[1] || !$collapsed) && ($m[3] < 7)
206:                     ? \'<abbr>&#x25bc;</abbr> </a><code>\'
207:                     : \'<abbr>&#x25ba;</abbr> </a><code class="nette-collapsed">\');
208:             '),
209:             self::htmlDump($dump)
210:         ) . '</pre>';
211:     }
212: 
213: 
214:     public static function findTrace(array $trace, $method, & $index = NULL)
215:     {
216:         $m = explode('::', $method);
217:         foreach ($trace as $i => $item) {
218:             if (isset($item['function']) && $item['function'] === end($m)
219:                 && isset($item['class']) === isset($m[1])
220:                 && (!isset($item['class']) || $item['class'] === $m[0] || $m[0] === '*' || is_subclass_of($item['class'], $m[0]))
221:             ) {
222:                 $index = $i;
223:                 return $item;
224:             }
225:         }
226:     }
227: 
228: }
229: 
Nette Framework 2.0.12 (for PHP 5.2, un-prefixed) API API documentation generated by ApiGen 2.8.0