1 files changed, 466 insertions, 231 deletions
diff --git a/phpBB/includes/db/mssql-odbc.php b/phpBB/includes/db/mssql-odbc.php
index 82352a1247..75ef7b1ac9 100644
--- a/phpBB/includes/db/mssql-odbc.php
+++ b/phpBB/includes/db/mssql-odbc.php
@@ -1,51 +1,43 @@
 <?php
-/***************************************************************************
- *                              mssql-odbc.php
- *                            -------------------
- *   begin                : Saturday, Feb 13, 2001
- *   copyright            : (C) 2001 The phpBB Group
- *   email                : support@phpbb.com
- *
- *   $Id$
- *
- ***************************************************************************/
-
-/***************************************************************************
- *
- *   This program 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 2 of the License, or
- *   (at your option) any later version.
- *
- ***************************************************************************/
-
-if(!defined("SQL_LAYER"))
+// -------------------------------------------------------------
+//
+// $Id$
+//
+// FILENAME  : mssql-odbc.php 
+// STARTED   : Sat Feb 13, 2001
+// COPYRIGHT : © 2001, 2003 phpBB Group
+// WWW       : http://www.phpbb.com/
+// LICENCE   : GPL vs2.0 [ see /docs/COPYING ] 
+// 
+// -------------------------------------------------------------
+
+if (!defined('SQL_LAYER'))
 {
 
-define("SQL_LAYER","mssql-odbc");
+define('SQL_LAYER', 'mssql-odbc');
 
 class sql_db
 {
-
 	var $db_connect_id;
-	var $result;
-
-	var $next_id;
+	var $query_result;
+	var $return_on_error = false;
+	var $transaction = false;
+	var $sql_time = 0;
+	var $num_queries = 0;
+	var $open_queries = array();
 
-	var $num_rows = array();
-	var $current_row = array();
+	var $result_rowset = array();
 	var $field_names = array();
 	var $field_types = array();
-	var $result_rowset = array();
-
-	var $num_queries = 0;
+	var $num_rows = array();
+	var $current_row = array();
 
-	function sql_connect($sqlserver, $sqluser, $sqlpassword, $database, $persistency = true)
+	function sql_connect($sqlserver, $sqluser, $sqlpassword, $database, $port = false, $persistency = false)
 	{
 		$this->persistency = $persistency;
-		$this->server = $sqlserver;
 		$this->user = $sqluser;
 		$this->password = $sqlpassword;
+		$this->server = $sqlserver . (($port) ? ':' . $port : '');
 		$this->dbname = $database;
 
 		$this->db_connect_id = ($this->persistency) ? @odbc_pconnect($this->server, $this->user, $this->password) : @odbc_connect($this->server, $this->user, $this->password);
@@ -53,6 +45,41 @@ class sql_db
 		return ($this->db_connect_id) ? $this->db_connect_id : $this->sql_error('');
 	}
 
+	//
+	// Other base methods
+	//
+	function sql_close()
+	{
+		if (!$this->db_connect_id)
+		{
+			return false;
+		}
+
+		if ($this->transaction)
+		{
+			@odbc_commit($this->db_connect_id);
+		}
+
+		if (sizeof($this->result_rowset))
+		{
+			unset($this->result_rowset);
+			unset($this->field_names);
+			unset($this->field_types);
+			unset($this->num_rows);
+			unset($this->current_row);
+		}
+
+		if (sizeof($this->open_queries))
+		{
+			foreach ($this->open_queries as $i_query_id => $query_id)
+			{
+				@odbc_free_result($query_id);
+			}
+		}
+
+		return @odbc_close($this->db_connect_id);
+	}
+
 	function sql_return_on_error($fail = false)
 	{
 		$this->return_on_error = $fail;
@@ -63,295 +90,318 @@ class sql_db
 		return $this->num_queries;
 	}
 
-	//
-	// Other base methods
-	//
-	function sql_close()
+	function sql_transaction($status = 'begin')
 	{
-		if($this->db_connect_id)
-		{
-			if($this->in_transaction)
-			{
-				@odbc_commit($this->db_connect_id);
-			}
-
-			if(count($this->result_rowset))
-			{
-				unset($this->result_rowset);
-				unset($this->field_names);
-				unset($this->field_types);
-				unset($this->num_rows);
-				unset($this->current_row);
-			}
-
-			return @odbc_close($this->db_connect_id);
-		}
-		else
+		switch ($status)
 		{
-			return false;
+			case 'begin':
+				$result = @odbc_autocommit($this->db_connect_id, false);
+				$this->transaction = true;
+				break;
+
+			case 'commit':
+				$result = @odbc_commit($this->db_connect_id);
+				@odbc_autocommit($this->db_connect_id, true);
+				$this->transaction = false;
+				break;
+
+			case 'rollback':
+				$result = @odbc_rollback($this->db_connect_id);
+				@odbc_autocommit($this->db_connect_id, true);
+				$this->transaction = false;
+				break;
+
+			default:
+				$result = true;
 		}
+
+		return $result;
 	}
 
-	//
-	// Query method
-	//
-	function sql_query($query = "", $transaction = FALSE)
+	// Base query method
+	function sql_query($query = '', $cache_ttl = 0)
 	{
-		if($query != "")
+		if ($query != '')
 		{
-			$this->num_queries++;
+			global $cache;
 
-			if($transaction == BEGIN_TRANSACTION && !$this->in_transaction)
+			// EXPLAIN only in extra debug mode
+			if (defined('DEBUG_EXTRA'))
 			{
-				if(!odbc_autocommit($this->db_connect_id, false))
-				{
-					return false;
-				}
-				$this->in_transaction = TRUE;
+				$this->sql_report('start', $query);
 			}
 
-			if(preg_match("/^SELECT(.*?)(LIMIT ([0-9]+)[, ]*([0-9]+)*)?$/s", $query, $limits))
+			$this->query_result = ($cache_ttl && method_exists($cache, 'sql_load')) ? $cache->sql_load($query) : false;
+
+			if (!$this->query_result)
 			{
-				$query = $limits[1];
+				$this->num_queries++;
 
-				if(!empty($limits[2]))
+				if (($this->query_result = $this->_odbc_execute_query($query)) === false)
 				{
-					$row_offset = ($limits[4]) ? $limits[3] : "";
-					$num_rows = ($limits[4]) ? $limits[4] : $limits[3];
+					$this->sql_error($query);
+				}
 
-					$query = "TOP " . ($row_offset + $num_rows) . $query;
+				if (defined('DEBUG_EXTRA'))
+				{
+					$this->sql_report('stop', $query);
 				}
 
-				$this->result = odbc_exec($this->db_connect_id, "SELECT $query"); 
+				if ($cache_ttl && method_exists($cache, 'sql_save'))
+				{
+					$this->open_queries[(int) $this->query_result] = $this->query_result;
+					$cache->sql_save($query, $this->query_result, $cache_ttl);
+					// odbc_free_result called within sql_save()
+				}
+				else if (strpos($query, 'SELECT') !== false && $this->query_result)
+				{
+					$this->open_queries[(int) $this->query_result] = $this->query_result;
+				}
+			}
+			else if (defined('DEBUG_EXTRA'))
+			{
+				$this->sql_report('fromcache', $query);
+			}
+		}
+		else
+		{
+			return false;
+		}
 
-				if($this->result)
+		return ($this->query_result) ? $this->query_result : false;
+	}
+
+	function _odbc_execute_query($query)
+	{
+		$result = false;
+		
+		if (eregi("^SELECT ", $query))
+		{
+			$result = @odbc_exec($this->db_connect_id, $query); 
+
+			if ($result)
+			{
+				if (empty($this->field_names[$result]))
 				{
-					if(empty($this->field_names[$this->result]))
+					for ($i = 1, $j = @odbc_num_fields($result) + 1; $i < $j; $i++)
 					{
-						for($i = 1; $i < odbc_num_fields($this->result) + 1; $i++)
-						{
-							$this->field_names[$this->result][] = odbc_field_name($this->result, $i);
-							$this->field_types[$this->result][] = odbc_field_type($this->result, $i);
-						}
+						$this->field_names[$result][] = @odbc_field_name($result, $i);
+						$this->field_types[$result][] = @odbc_field_type($result, $i);
 					}
+				}
 
-					$this->current_row[$this->result] = 0;
-					$this->result_rowset[$this->result] = array();
+				$this->current_row[$result] = 0;
+				$this->result_rowset[$result] = array();
 
-					$row_outer = (isset($row_offset)) ? $row_offset + 1 : 1;
-					$row_outer_max = (isset($num_rows)) ? $row_offset + $num_rows + 1 : 1E9;
-					$row_inner = 0;
+				$row_outer = (isset($row_offset)) ? $row_offset + 1 : 1;
+				$row_outer_max = (isset($num_rows)) ? $row_offset + $num_rows + 1 : 1E9;
+				$row_inner = 0;
 
-					while(odbc_fetch_row($this->result, $row_outer) && $row_outer < $row_outer_max)
+				while (@odbc_fetch_row($result, $row_outer) && $row_outer < $row_outer_max)
+				{
+					for ($i = 0, $j = sizeof($this->field_names[$result]); $i < $j; $i++)
 					{
-						for($j = 0; $j < count($this->field_names[$this->result]); $j++)
-						{
-							$this->result_rowset[$this->result][$row_inner][$this->field_names[$this->result][$j]] = stripslashes(odbc_result($this->result, $j + 1));
-						}
-
-						$row_outer++;
-						$row_inner++;
+						$this->result_rowset[$result][$row_inner][$this->field_names[$result][$i]] = stripslashes(@odbc_result($result, $i + 1));
 					}
 
-					$this->num_rows[$this->result] = count($this->result_rowset[$this->result]);	
+					$row_outer++;
+					$row_inner++;
 				}
 
+				$this->num_rows[$result] = sizeof($this->result_rowset[$result]);	
 			}
-			else if(eregi("^INSERT ", $query))
-			{
-				$this->result = odbc_exec($this->db_connect_id, $query);
+		}
+		else if (eregi("^INSERT ", $query))
+		{
+			$result = @odbc_exec($this->db_connect_id, $query);
 
-				if($this->result)
+			if ($result)
+			{
+				$result_id = @odbc_exec($this->db_connect_id, 'SELECT @@IDENTITY');
+				if ($result_id)
 				{
-					$result_id = odbc_exec($this->db_connect_id, "SELECT @@IDENTITY");
-					if($result_id)
+					if (@odbc_fetch_row($result_id))
 					{
-						if(odbc_fetch_row($result_id))
-						{
-							$this->next_id[$this->db_connect_id] = odbc_result($result_id, 1);	
-							$this->affected_rows[$this->db_connect_id] = odbc_num_rows($this->result);
-						}
+						$this->next_id[$this->db_connect_id] = @odbc_result($result_id, 1);	
+						$this->affected_rows[$this->db_connect_id] = @odbc_num_rows($result);
 					}
 				}
 			}
-			else
-			{
-				$this->result = odbc_exec($this->db_connect_id, $query);
+		}
+		else
+		{
+			$result = @odbc_exec($this->db_connect_id, $query);
 
-				if($this->result)
-				{
-					$this->affected_rows[$this->db_connect_id] = odbc_num_rows($this->result);
-				}
+			if ($result)
+			{
+				$this->affected_rows[$this->db_connect_id] = @odbc_num_rows($result);
 			}
+		}
 
-			if(!$this->result)
-			{
-				if($this->in_transaction)
-				{
-					odbc_rollback($this->db_connect_id);
-					odbc_autocommit($this->db_connect_id, true);
-					$this->in_transaction = FALSE;
-				}
+		return $result;
+	}
+
+	function sql_query_limit($query, $total, $offset = 0, $cache_ttl = 0) 
+	{ 
+		if ($query != '') 
+		{
+			$this->query_result = false; 
 
-				return false;
+			// if $total is set to 0 we do not want to limit the number of rows
+			if ($total == 0)
+			{
+				$total = -1;
 			}
 
-			if($transaction == END_TRANSACTION && $this->in_transaction)
+			$row_offset = ($total) ? $offset : '';
+			$num_rows = ($total) ? $total : $offset;
+
+			$query = 'SELECT TOP ' . ($row_offset + $num_rows) . ' ' . preg_replace('/^SELECT/', '', $query);
+
+			return $this->sql_query($query, $cache_ttl); 
+		} 
+		else 
+		{ 
+			return false; 
+		} 
+	}
+
+	// Idea for this from Ikonboard
+	function sql_build_array($query, $assoc_ary = false)
+	{
+		if (!is_array($assoc_ary))
+		{
+			return false;
+		}
+
+		$fields = array();
+		$values = array();
+		if ($query == 'INSERT')
+		{
+			foreach ($assoc_ary as $key => $var)
 			{
-				$this->in_transaction = FALSE;
+				$fields[] = $key;
 
-				if (!odbc_commit($this->db_connect_id))
+				if (is_null($var))
 				{
-					odbc_rollback($this->db_connect_id);
-					odbc_autocommit($this->db_connect_id, true);
-					return false;
+					$values[] = 'NULL';
+				}
+				elseif (is_string($var))
+				{
+					$values[] = "'" . $this->sql_escape($var) . "'";
+				}
+				else
+				{
+					$values[] = (is_bool($var)) ? intval($var) : $var;
 				}
-				odbc_autocommit($this->db_connect_id, true);
 			}
 
-			odbc_free_result($this->result);
-
-			return $this->result;
+			$query = ' (' . implode(', ', $fields) . ') VALUES (' . implode(', ', $values) . ')';
 		}
-		else
+		else if ($query == 'UPDATE' || $query == 'SELECT')
 		{
-			if($transaction == END_TRANSACTION && $this->in_transaction)
+			$values = array();
+			foreach ($assoc_ary as $key => $var)
 			{
-				$this->in_transaction = FALSE;
-
-				if (!@odbc_commit($this->db_connect_id))
+				if (is_null($var))
+				{
+					$values[] = "$key = NULL";
+				}
+				elseif (is_string($var))
+				{
+					$values[] = "$key = '" . $this->sql_escape($var) . "'";
+				}
+				else
 				{
-					odbc_rollback($this->db_connect_id);
-					odbc_autocommit($this->db_connect_id, true);
-					return false;
+					$values[] = (is_bool($var)) ? "$key = " . intval($var) : "$key = $var";
 				}
-				odbc_autocommit($this->db_connect_id, true);
 			}
-
-			return true;
+			$query = implode(($query == 'UPDATE') ? ', ' : ' AND ', $values);
 		}
+
+		return $query;
 	}
 
-	//
 	// Other query methods
 	//
-	function sql_numrows($query_id = 0)
+	// NOTE :: Want to remove _ALL_ reliance on sql_numrows from core code ...
+	//         don't want this here by a middle Milestone
+	function sql_numrows($query_id = false)
 	{
-		if(!$query_id) 
+		if (!$query_id)
 		{
-			$query_id = $this->result;
+			$query_id = $this->query_result;
 		}
 
-		return ($query_id) ? $this->num_rows[$query_id] : false;
+		return ($query_id) ? @$this->num_rows($query_id) : false;
 	}
 
-	function sql_numfields($query_id = 0)
+	function sql_affectedrows()
 	{
-		if(!$query_id)
-		{
-			$query_id = $this->result;
-		}
-
-		return ($query_id) ? count($this->field_names[$query_id]) : false;
+		return ($this->affected_rows[$this->db_connect_id]) ? $this->affected_rows[$this->db_connect_id] : false;
 	}
 
-	function sql_fieldname($offset, $query_id = 0)
+	function sql_fetchrow($query_id = false)
 	{
-		if(!$query_id)
-		{
-			$query_id = $this->result;
-		}
+		global $cache;
 
-		return ($query_id) ? $this->field_names[$query_id][$offset] : false;
-	}
-
-	function sql_fieldtype($offset, $query_id = 0)
-	{
-		if(!$query_id)
+		if (!$query_id)
 		{
-			$query_id = $this->result;
+			$query_id = $this->query_result;
 		}
 
-		return ($query_id) ? $this->field_types[$query_id][$offset] : false;
-	}
-
-	function sql_fetchrow($query_id = 0)
-	{
-		if(!$query_id)
+		if (isset($cache->sql_rowset[$query_id]))
 		{
-			$query_id = $this->result;
+			return $cache->sql_fetchrow($query_id);
 		}
 
-		if($query_id)
-		{
-			return ($this->num_rows[$query_id] && $this->current_row[$query_id] < $this->num_rows[$query_id]) ? $this->result_rowset[$query_id][$this->current_row[$query_id]++] : false;
-		}
-		else
-		{
-			return false;
-		}
+		return ($this->num_rows[$query_id] && $this->current_row[$query_id] < $this->num_rows[$query_id]) ? $this->result_rowset[$query_id][$this->current_row[$query_id]++] : false;
 	}
 
-	function sql_fetchrowset($query_id = 0)
+	function sql_fetchrowset($query_id = false)
 	{
-		if(!$query_id)
+		if (!$query_id)
 		{
-			$query_id = $this->result;
+			$query_id = $this->query_result;
 		}
 
-		if($query_id)
-		{
-			return ($this->num_rows[$query_id]) ? $this->result_rowset[$query_id] : false;
-		}
-		else
-		{
-			return false;
-		}
+		return ($this->num_rows[$query_id]) ? $this->result_rowset[$query_id] : false;
 	}
 
-	function sql_fetchfield($field, $row = -1, $query_id = 0)
+	function sql_fetchfield($field, $rownum = -1, $query_id = false)
 	{
-		if(!$query_id)
+		if (!$query_id)
 		{
-			$query_id = $this->result;
+			$query_id = $this->query_result;
 		}
 
-		if($query_id)
+		if ($query_id)
 		{
-			if($row < $this->num_rows[$query_id])
+			if ($row < $this->num_rows[$query_id])
 			{
 				$getrow = ($row == -1) ? $this->current_row[$query_id] - 1 : $row;
 
 				return $this->result_rowset[$query_id][$getrow][$this->field_names[$query_id][$field]];
-
-			}
-			else
-			{
-				return false;
 			}
 		}
-		else
-		{
-			return false;
-		}
+
+		return false;
 	}
 
-	function sql_rowseek($offset, $query_id = 0)
+	function sql_rowseek($rownum, $query_id = false)
 	{
-		if(!$query_id)
+		if (!$query_id)
 		{
-			$query_id = $this->result;
+			$query_id = $this->query_result;
 		}
 
-		if($query_id)
+		if (isset($this->current_row[$query_id]))
 		{
 			$this->current_row[$query_id] = $offset - 1;
 			return true;
 		}
-		else
-		{
-			return false;
-		}
+
+		return false;
 	}
 
 	function sql_nextid()
@@ -359,33 +409,69 @@ class sql_db
 		return ($this->next_id[$this->db_connect_id]) ? $this->next_id[$this->db_connect_id] : false;
 	}
 
-	function sql_affectedrows()
+	function sql_numfields($query_id = false)
 	{
-		return ($this->affected_rows[$this->db_connect_id]) ? $this->affected_rows[$this->db_connect_id] : false;
+		if (!$query_id)
+		{
+			$query_id = $this->query_result;
+		}
+
+		return ($query_id) ? sizeof($this->field_names[$query_id]) : false;
 	}
 
-	function sql_freeresult($query_id = 0)
+	function sql_fieldname($offset, $query_id = false)
 	{
-		if(!$query_id)
+		if (!$query_id)
 		{
-			$query_id = $this->result;
+			$query_id = $this->query_result;
 		}
 
-		unset($this->num_rows[$query_id]);
-		unset($this->current_row[$query_id]);
-		unset($this->result_rowset[$query_id]);
-		unset($this->field_names[$query_id]);
-		unset($this->field_types[$query_id]);
+		return ($query_id) ? $this->field_names[$query_id][$offset] : false;
+	}
 
-		return true;
+	function sql_fieldtype($offset, $query_id = false)
+	{
+		if (!$query_id)
+		{
+			$query_id = $this->query_result;
+		}
+
+		return ($query_id) ? $this->field_types[$query_id][$offset] : false;
+	}
+
+	function sql_freeresult($query_id = false)
+	{
+		if (!$query_id)
+		{
+			$query_id = $this->query_result;
+		}
+
+		if (isset($this->open_queries[(int) $query_id]))
+		{
+			unset($this->open_queries[(int) $query_id]);
+			unset($this->num_rows[$query_id]);
+			unset($this->current_row[$query_id]);
+			unset($this->result_rowset[$query_id]);
+			unset($this->field_names[$query_id]);
+			unset($this->field_types[$query_id]);
+
+			return @odbc_free_result($query_id);
+		}
+
+		return false;
+	}
+
+	function sql_escape($msg)
+	{
+		return $msg;
 	}
 
 	function sql_error($sql = '')
 	{
 		if (!$this->return_on_error)
 		{
-			$this_page = (!empty($_SERVER['PHP_SELF'])) ? $_SERVER['PHP_SELF'] : $_ENV['PHP_SELF'];
-			$this_page .= '&' . ((!empty($_SERVER['QUERY_STRING'])) ? $_SERVER['QUERY_STRING'] : $_ENV['QUERY_STRING']);
+			$this_page = (isset($_SERVER['PHP_SELF']) && !empty($_SERVER['PHP_SELF'])) ? $_SERVER['PHP_SELF'] : $_ENV['PHP_SELF'];
+			$this_page .= '&' . ((isset($_SERVER['QUERY_STRING']) && !empty($_SERVER['QUERY_STRING'])) ? $_SERVER['QUERY_STRING'] : (isset($_ENV['QUERY_STRING']) ? $_ENV['QUERY_STRING'] : ''));
 
 			$message = '<u>SQL ERROR</u> [ ' . SQL_LAYER . ' ]<br /><br />' . @odbc_errormsg() . '<br /><br /><u>CALLING PAGE</u><br /><br />'  . htmlspecialchars($this_page) . (($sql != '') ? '<br /><br /><u>SQL</u><br /><br />' . $sql : '') . '<br />';
 
@@ -393,7 +479,7 @@ class sql_db
 			{
 				$this->sql_transaction('rollback');
 			}
-
+			
 			trigger_error($message, E_USER_ERROR);
 		}
 
@@ -405,6 +491,155 @@ class sql_db
 		return $result;
 	}
 
+	function sql_report($mode, $query = '')
+	{
+		if (empty($_GET['explain']))
+		{
+			return;
+		}
+
+		global $db, $cache, $starttime, $phpbb_root_path;
+		static $curtime, $query_hold, $html_hold;
+		static $sql_report = '';
+		static $cache_num_queries = 0;
+
+		if (!$query && !empty($query_hold))
+		{
+			$query = $query_hold;
+		}
+
+		switch ($mode)
+		{
+			case 'display':
+				if (!empty($cache))
+				{
+					$cache->unload();
+				}
+				$db->sql_close();
+
+				$mtime = explode(' ', microtime());
+				$totaltime = $mtime[0] + $mtime[1] - $starttime;
+
+				echo '<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"><html><head><meta http-equiv="Content-Type" content="text/html; charset=iso-8869-1"><meta http-equiv="Content-Style-Type" content="text/css"><link rel="stylesheet" href="' . $phpbb_root_path . 'adm/subSilver.css" type="text/css"><style type="text/css">' . "\n";
+				echo 'th { background-image: url(\'' . $phpbb_root_path . 'adm/images/cellpic3.gif\') }' . "\n";
+				echo 'td.cat	{ background-image: url(\'' . $phpbb_root_path . 'adm/images/cellpic1.gif\') }' . "\n";
+				echo '</style><title>' . $msg_title . '</title></head><body>';
+				echo '<table width="100%" cellspacing="0" cellpadding="0" border="0"><tr><td><a href="' . htmlspecialchars(preg_replace('/&explain=([^&]*)/', '', $_SERVER['REQUEST_URI'])) . '"><img src="' . $phpbb_root_path . 'adm/images/header_left.jpg" width="200" height="60" alt="phpBB Logo" title="phpBB Logo" border="0"/></a></td><td width="100%" background="' . $phpbb_root_path . 'adm/images/header_bg.jpg" height="60" align="right" nowrap="nowrap"><span class="maintitle">SQL Report</span> &nbsp; &nbsp; &nbsp;</td></tr></table><br clear="all"/><table width="95%" cellspacing="1" cellpadding="4" border="0" align="center"><tr><td height="40" align="center" valign="middle"><b>Page generated in ' . round($totaltime, 4) . " seconds with {$this->num_queries} queries" . (($cache_num_queries) ? " + $cache_num_queries " . (($cache_num_queries == 1) ? 'query' : 'queries') . ' returning data from cache' : '') . '</b></td></tr><tr><td align="center" nowrap="nowrap">Time spent on MSSQL queries: <b>' . round($this->sql_time, 5) . 's</b> | Time spent on PHP: <b>' . round($totaltime - $this->sql_time, 5) . 's</b></td></tr></table><table width="95%" cellspacing="1" cellpadding="4" border="0" align="center"><tr><td>';
+				echo $sql_report;
+				echo '</td></tr></table><br /></body></html>';
+				exit;
+				break;
+
+			case 'start':
+				$query_hold = $query;
+				$html_hold = '';
+
+				$explain_query = $query;
+				if (preg_match('/UPDATE ([a-z0-9_]+).*?WHERE(.*)/s', $query, $m))
+				{
+					$explain_query = 'SELECT * FROM ' . $m[1] . ' WHERE ' . $m[2];
+				}
+				elseif (preg_match('/DELETE FROM ([a-z0-9_]+).*?WHERE(.*)/s', $query, $m))
+				{
+					$explain_query = 'SELECT * FROM ' . $m[1] . ' WHERE ' . $m[2];
+				}
+
+				if (preg_match('/^SELECT/', $explain_query))
+				{
+					$html_table = FALSE;
+
+					@odbc_exec($this->db_connect_id, 'SET SHOWPLAN_ALL ON');
+					
+					if ($result = $this->_odbc_execute_query($explain_query))
+					{
+						while ($row = $this->sql_fetchrow($result))
+						{
+							if (!$html_table && count($row))
+							{
+								$html_table = TRUE;
+								$html_hold .= '<table class="bg" width="100%" cellspacing="1" cellpadding="4" border="0" align="center"><tr>';
+								
+								foreach (array_keys($row) as $val)
+								{
+									$html_hold .= '<th nowrap="nowrap">' . (($val) ? ucwords(str_replace('_', ' ', $val)) : '&nbsp;') . '</th>';
+								}
+								$html_hold .= '</tr>';
+							}
+							$html_hold .= '<tr>';
+
+							$class = 'row1';
+							foreach (array_values($row) as $val)
+							{
+								$class = ($class == 'row1') ? 'row2' : 'row1';
+								$html_hold .= '<td class="' . $class . '">' . (($val) ? $val : '&nbsp;') . '</td>';
+							}
+							$html_hold .= '</tr>';
+						}
+						$this->sql_freeresult($result);
+					}
+
+					@odbc_exec($this->db_connect_id, 'SET SHOWPLAN_ALL OFF');
+
+					if ($html_table)
+					{
+						$html_hold .= '</table>';
+					}
+				}
+
+				$curtime = explode(' ', microtime());
+				$curtime = $curtime[0] + $curtime[1];
+				break;
+
+			case 'fromcache':
+				$endtime = explode(' ', microtime());
+				$endtime = $endtime[0] + $endtime[1];
+
+				$result = $this->_odbc_execute_query($query);
+				$splittime = explode(' ', microtime());
+				$splittime = $splittime[0] + $splittime[1];
+
+				$time_cache = $endtime - $curtime;
+				$time_db = $splittime - $endtime;
+				$color = ($time_db > $time_cache) ? 'green' : 'red';
+
+				$sql_report .= '<hr width="100%"/><br /><table class="bg" width="100%" cellspacing="1" cellpadding="4" border="0"><tr><th>Query results obtained from the cache</th></tr><tr><td class="row1"><textarea style="font-family:\'Courier New\',monospace;width:100%" rows="5">' . preg_replace('/\t(AND|OR)(\W)/', "\$1\$2", htmlspecialchars(preg_replace('/[\s]*[\n\r\t]+[\n\r\s\t]*/', "\n", $query))) . '</textarea></td></tr></table><p align="center">';
+
+				$sql_report .= 'Before: ' . sprintf('%.5f', $curtime - $starttime) . 's | After: ' . sprintf('%.5f', $endtime - $starttime) . 's | Elapsed [cache]: <b style="color: ' . $color . '">' . sprintf('%.5f', ($time_cache)) . 's</b> | Elapsed [db]: <b>' . sprintf('%.5f', $time_db) . 's</b></p>';
+
+				// Pad the start time to not interfere with page timing
+				$starttime += $time_db;
+
+				$this->sql_freeresult($result);
+				$cache_num_queries++;
+				break;
+
+			case 'stop':
+				$endtime = explode(' ', microtime());
+				$endtime = $endtime[0] + $endtime[1];
+
+				$sql_report .= '<hr width="100%"/><br /><table class="bg" width="100%" cellspacing="1" cellpadding="4" border="0"><tr><th>Query #' . $this->num_queries . '</th></tr><tr><td class="row1"><textarea style="font-family:\'Courier New\',monospace;width:100%" rows="5">' . preg_replace('/\t(AND|OR)(\W)/', "\$1\$2", htmlspecialchars(preg_replace('/[\s]*[\n\r\t]+[\n\r\s\t]*/', "\n", $query))) . '</textarea></td></tr></table> ' . $html_hold . '<p align="center">';
+
+				if ($this->query_result)
+				{
+					if (preg_match('/^(UPDATE|DELETE|REPLACE)/', $query))
+					{
+						$sql_report .= "Affected rows: <b>" . $this->sql_affectedrows($this->query_result) . '</b> | ';
+					}
+					$sql_report .= 'Before: ' . sprintf('%.5f', $curtime - $starttime) . 's | After: ' . sprintf('%.5f', $endtime - $starttime) . 's | Elapsed: <b>' . sprintf('%.5f', $endtime - $curtime) . 's</b>';
+				}
+				else
+				{
+					$error = $this->sql_error();
+					$sql_report .= '<b style="color: red">FAILED</b> - MSSQL Error ' . $error['code'] . ': ' . htmlspecialchars($error['message']);
+				}
+
+				$sql_report .= '</p>';
+
+				$this->sql_time += $endtime - $curtime;
+				break;
+		}
+	}
+
 } // class sql_db
 
 } // if ... define