2 /***************************************************************************
3 * Copyright (C) 2003-2007 Polytechnique.org *
4 * http://opensource.polytechnique.org/ *
6 * This program is free software; you can redistribute it and/or modify *
7 * it under the terms of the GNU General Public License as published by *
8 * the Free Software Foundation; either version 2 of the License, or *
9 * (at your option) any later version. *
11 * This program is distributed in the hope that it will be useful, *
12 * but WITHOUT ANY WARRANTY; without even the implied warranty of *
13 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the *
14 * GNU General Public License for more details. *
16 * You should have received a copy of the GNU General Public License *
17 * along with this program; if not, write to the Free Software *
19 * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA *
20 ***************************************************************************/
22 /** Ligth debugging tool to generate execution backtrace
26 static public $bt = array();
28 public $traces = array();
29 public $totaltime = 0.0;
30 public $error = false
;
32 function __construct($name, array $init = array(), $sizef = 'rows', $timef = 'exectime', $errorf = 'error')
34 PlBacktrace
::$bt[$name] = $this;
35 foreach ($init as &$entry) {
36 $this->add($entry, $sizef, $timef, $errorf);
40 private function add(array &$entry, $sizef = 'rows', $timef = 'exectime', $errorf = 'error')
43 $trace['action'] = $entry['action'];
44 unset($entry['action']);
45 $trace['exectime'] = @$entry[$timef];
46 $this->totaltime +
= $trace['exectime'];
47 unset($entry[$timef]);
48 $trace['rows'] = @$entry[$sizef];
49 unset($entry[$sizef]);
50 $trace['error'] = @$entry[$errorf];
51 unset($entry[$errorf]);
52 if ($trace['error']) {
55 $trace['data'] = array($entry);
56 $this->traces
[] =& $trace;
59 public function newEvent($action, $rows = 0, $error = null
, array $userdata = array())
61 $trace = array('action' => $action, 'time' => 0);
62 $this->traces
[] =& $trace;
63 $this->update($rows, $error, $userdata);
66 public function start($action)
68 $trace = array('action' => $action, 'starttime' => microtime(true
));
69 $this->traces
[] =& $trace;
72 public function stop($rows = 0, $error = null
, array $userdata = array())
74 $time = microtime(true
);
78 $trace =& $this->traces
[count($this->traces
) - 1];
79 $trace['time'] = $time - $trace['starttime'];
80 unset($trace['starttime']);
81 $this->totaltime +
= $trace['time'];
82 $this->update($rows, $error, $userdata);
85 public function update($rows = 0, $error = null
, array $userdata = array())
87 $trace =& $this->traces
[count($this->traces
) - 1];
88 $trace['rows'] = $rows;
89 $trace['error'] = $error;
90 $trace['data'] = $userdata;
91 if ($trace['error']) {
96 public static function clean()
98 foreach (PlBacktrace
::$bt as $name=>&$entry) {
99 if (!$entry->traces
) {
100 unset(PlBacktrace
::$bt[$name]);
106 // vim:set et sw=4 sts=4 sws=4 foldmethod=marker enc=utf-8: