157 lines
3.8 KiB
PHP
157 lines
3.8 KiB
PHP
<?php
|
|
/**
|
|
* @copyright Copyright (c) 2010, The volkszaehler.org project
|
|
* @package util
|
|
* @license http://www.opensource.org/licenses/gpl-license.php GNU Public License
|
|
*/
|
|
/*
|
|
* This file is part of volkzaehler.org
|
|
*
|
|
* volkzaehler.org is free software: you can redistribute it and/or modify
|
|
* it under the terms of the GNU General Public License as published by
|
|
* the Free Software Foundation, either version 3 of the License, or
|
|
* any later version.
|
|
*
|
|
* volkzaehler.org is distributed in the hope that it will be useful,
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
* GNU General Public License for more details.
|
|
*
|
|
* You should have received a copy of the GNU General Public License
|
|
* along with volkszaehler.org. If not, see <http://www.gnu.org/licenses/>.
|
|
*/
|
|
|
|
namespace Volkszaehler\Util;
|
|
|
|
use Doctrine\DBAL\Logging;
|
|
|
|
/**
|
|
* static debugging class
|
|
*
|
|
* @package util
|
|
* @author Steffen Vogel <info@steffenvogel.de>
|
|
*/
|
|
class Debug implements Logging\SQLLogger {
|
|
protected static $instance = NULL;
|
|
|
|
protected $queries = array();
|
|
protected $messages = array();
|
|
|
|
/**
|
|
* @var float holds timestamp of initialization, used later to return time of execution
|
|
*/
|
|
protected $started;
|
|
|
|
/**
|
|
* @var integer the debug level
|
|
*/
|
|
protected $level;
|
|
|
|
/**
|
|
* constructor
|
|
*
|
|
* @param integer $level the debug level
|
|
*/
|
|
public function __construct($level) {
|
|
// taking timestamp to stop execution time
|
|
$this->created = microtime(TRUE);
|
|
|
|
$this->level = $level;
|
|
|
|
if (isset(self::$instance)) {
|
|
throw new \Exception('debugging has already been started. please use the static functions!');
|
|
}
|
|
self::$instance = $this;
|
|
|
|
// assert options
|
|
assert_options(ASSERT_ACTIVE, TRUE);
|
|
assert_options(ASSERT_BAIL, FALSE);
|
|
assert_options(ASSERT_WARNING, FALSE);
|
|
assert_options(ASSERT_CALLBACK, array($this, 'assertHandler'));
|
|
|
|
|
|
}
|
|
|
|
/**
|
|
* interface for doctrine's dbal sql logger
|
|
*
|
|
* @param string $sql the sql query
|
|
* @param array $parameters optional parameters for prepared queries
|
|
*/
|
|
function logSQL($sql, array $parameters = NULL) {
|
|
$this->queries[] = array('sql' => $sql, 'parameters' => $parameters);
|
|
}
|
|
|
|
/*
|
|
* logs messages to the debug stack including file, lineno, args and a stacktrace
|
|
*
|
|
* @param string $message
|
|
* @param more parameters could be passed
|
|
*/
|
|
static public function log($message) {
|
|
if (isset(self::$instance)) {
|
|
$trace = debug_backtrace();
|
|
|
|
self::$instance->messages[] = array(
|
|
'message' => $message,
|
|
'file' => $trace[0]['file'],
|
|
'line' => $trace[0]['line'],
|
|
'time' => date('r'),
|
|
'args' => array_slice($trace[0]['args'], 1),
|
|
'trace' => $trace
|
|
);
|
|
}
|
|
}
|
|
|
|
/**
|
|
* simple assertion passthrough for future improvements
|
|
*
|
|
* @param string $code code to be evaluated
|
|
* @todo check how should be en/disabled (options etc..)
|
|
*/
|
|
public static function assert($code) {
|
|
return assert($code);
|
|
}
|
|
|
|
/**
|
|
* handles failed assertions
|
|
*
|
|
* @param string $file
|
|
* @param integer $line
|
|
* @param string $code code to be evaluated
|
|
*/
|
|
public function assertHandler($file, $line, $code) {
|
|
$trace = debug_backtrace();
|
|
$info = $trace[2];
|
|
|
|
$this->messages[] = array(
|
|
'message' => 'assertion failed: ' . $code,
|
|
'file' => $info['file'],
|
|
'line' => $info['line'],
|
|
'time' => date('r'),
|
|
'trace' => array_slice($trace, 2)
|
|
);
|
|
}
|
|
|
|
/**
|
|
* is debugging enabled?
|
|
*/
|
|
public static function isActivated() { return isset(self::$instance); }
|
|
|
|
/**
|
|
* @return float execution time
|
|
*/
|
|
public function getExecutionTime() { return round((microtime(TRUE) - $this->created), 5); }
|
|
|
|
/**
|
|
* @return 2 dimensional array with sql queries and parameters
|
|
*/
|
|
public function getQueries() { return $this->queries; }
|
|
|
|
/**
|
|
* @return 2 dimensional array with messages
|
|
*/
|
|
public function getMessages() { return $this->messages; }
|
|
}
|
|
|
|
?>
|