Index: branches/5.2.x/core/kernel/db/db_connection.php
===================================================================
diff -u -N -r16424 -r16432
--- branches/5.2.x/core/kernel/db/db_connection.php	(.../db_connection.php)	(revision 16424)
+++ branches/5.2.x/core/kernel/db/db_connection.php	(.../db_connection.php)	(revision 16432)
@@ -1,6 +1,6 @@
 <?php
 /**
-* @version	$Id: db_connection.php 16424 2016-11-14 07:50:47Z alex $
+* @version	$Id: db_connection.php 16432 2016-11-18 09:30:26Z alex $
 * @package	In-Portal
 * @copyright	Copyright (C) 1997 - 2009 Intechnic. All rights reserved.
 * @license      GNU/GPL
@@ -18,7 +18,7 @@
 	 * Multi database connection class
 	 *
 	 */
-	class kDBConnection extends kBase {
+	class kDBConnection extends kBase implements IDBConnection {
 
 		/**
 		 * Created connection handle
@@ -184,8 +184,7 @@
 		}
 
 		/**
-		 * Checks if previous query execution
-		 * raised an error.
+		 * Checks if previous query execution raised an error.
 		 *
 		 * @return bool
 		 * @access public
@@ -196,9 +195,7 @@
 		}
 
 		/**
-		 * Try to connect to database server
-		 * using specified parameters and set
-		 * database to $db if connection made
+		 * Try to connect to database server using specified parameters and set database to $db if connection made.
 		 *
 		 * @param string $host
 		 * @param string $user
@@ -208,6 +205,7 @@
 		 *
 		 * @return bool
 		 * @access public
+		 * @throws RuntimeException When connection failed.
 		 */
 		public function Connect($host, $user, $pass, $db, $retry = false)
 		{
@@ -251,7 +249,7 @@
 		}
 
 		/**
-		 * Checks if connection to database is opened
+		 * Checks if connection to database is opened.
 		 *
 		 * @return bool
 		 * @access public
@@ -262,7 +260,7 @@
 		}
 
 		/**
-		 * Setups the connection according given configuration
+		 * Setups the connection according given configuration.
 		 *
 		 * @param Array $config
 		 * @return bool
@@ -406,9 +404,7 @@
 		}
 
 		/**
-		 * Returns first field of first line
-		 * of recordset if query ok or false
-		 * otherwise
+		 * Returns first field of first line of recordset if query ok or false otherwise.
 		 *
 		 * @param string $sql
 		 * @param int $offset
@@ -427,8 +423,7 @@
 		}
 
 		/**
-		 * Returns first row of recordset
-		 * if query ok, false otherwise
+		 * Returns first row of recordset if query ok, false otherwise.
 		 *
 		 * @param string $sql
 		 * @param int $offset
@@ -448,12 +443,10 @@
 		}
 
 		/**
-		 * Returns 1st column of recordset as
-		 * one-dimensional array or false otherwise
-		 * Optional parameter $key_field can be used
-		 * to set field name to be used as resulting
-		 * array key
+		 * Returns 1st column of recordset as one-dimensional array or false otherwise.
 		 *
+		 * Optional parameter $key_field can be used to set field name to be used as resulting array key.
+		 *
 		 * @param string $sql
 		 * @param string $key_field
 		 * @return Array
@@ -488,9 +481,9 @@
 
 		/**
 		 * Returns iterator for 1st column of a recordset or false in case of error.
-		 * Optional parameter $key_field can be used to set field name to be used
-		 * as resulting array key.
 		 *
+		 * Optional parameter $key_field can be used to set field name to be used as resulting array key.
+		 *
 		 * @param string $sql
 		 * @param string $key_field
 		 * @return bool|kMySQLQueryCol
@@ -501,12 +494,10 @@
 		}
 
 		/**
-		 * Queries db with $sql query supplied
-		 * and returns rows selected if any, false
-		 * otherwise. Optional parameter $key_field
-		 * allows to set one of the query fields
-		 * value as key in string array.
+		 * Queries db with $sql query supplied and returns rows selected if any, false otherwise.
 		 *
+		 * Optional parameter $key_field allows to set one of the query fields value as key in string array.
+		 *
 		 * @param string $sql
 		 * @param string $key_field
 		 * @param bool $no_debug
@@ -567,13 +558,14 @@
 		}
 
 		/**
-		 * Returns iterator to a recordset, produced from running $sql query  Queries db with $sql query supplied and returns kMySQLQuery iterator
-		 * or false in case of error. Optional parameter $key_field allows to
-		 * set one of the query fields value as key in string array.
+		 * Returns iterator to a recordset, produced from running $sql query.
 		 *
+		 * Queries db with $sql query supplied and returns kMySQLQuery iterator or false in case of error.
+		 * Optional parameter $key_field allows to set one of the query fields value as key in string array.
+		 *
 		 * @param string $sql
 		 * @param string $key_field
-		 * @param bool $no_debug
+		 * @param bool   $no_debug
 		 * @param string $iterator_class
 		 * @return kMySQLQuery|bool
 		 * @access public
@@ -620,7 +612,7 @@
 		}
 
 		/**
-		 * Free memory used to hold recordset handle
+		 * Free memory used to hold recordset handle.
 		 *
 		 * @access public
 		 */
@@ -631,7 +623,7 @@
 		}
 
 		/**
-		 * Performs sql query, that will change database content
+		 * Performs sql query, that will change database content.
 		 *
 		 * @param string $sql
 		 * @return bool
@@ -644,11 +636,8 @@
 			return !$this->hasError();
 		}
 
-
-
 		/**
-		 * Returns auto increment field value from
-		 * insert like operation if any, zero otherwise
+		 * Returns auto increment field value from insert like operation if any, zero otherwise.
 		 *
 		 * @return int
 		 * @access public
@@ -659,7 +648,7 @@
 		}
 
 		/**
-		 * Returns row count affected by last query
+		 * Returns row count affected by last query.
 		 *
 		 * @return int
 		 * @access public
@@ -670,7 +659,7 @@
 		}
 
 		/**
-		 * Returns LIMIT sql clause part for specific db
+		 * Returns LIMIT sql clause part for specific db.
 		 *
 		 * @param int $offset
 		 * @param int $rows
@@ -687,8 +676,7 @@
 		}
 
 		/**
-		 * If it's a string, adds quotes and backslashes (only work since PHP 4.3.0)
-		 * Otherwise returns as-is
+		 * If it's a string, adds quotes and backslashes. Otherwise returns as-is.
 		 *
 		 * @param mixed $string
 		 * @return string
@@ -708,7 +696,7 @@
 		}
 
 		/**
-		 * Calls "qstr" function for each given array element
+		 * Calls "qstr" function for each given array element.
 		 *
 		 * @param Array $array
 		 * @param string $function
@@ -720,7 +708,7 @@
 		}
 
 		/**
-		 * Escapes strings (only work since PHP 4.3.0)
+		 * Escapes string.
 		 *
 		 * @param mixed $string
 		 * @return string
@@ -739,7 +727,7 @@
 		}
 
 		/**
-		 * Returns last error code occurred
+		 * Returns last error code occurred.
 		 *
 		 * @return int
 		 * @access public
@@ -750,7 +738,7 @@
 		}
 
 		/**
-		 * Returns last error message
+		 * Returns last error message.
 		 *
 		 * @return string
 		 * @access public
@@ -762,7 +750,7 @@
 
 		/**
 		 * Performs insert of given data (useful with small number of queries)
-		 * or stores it to perform multiple insert later (useful with large number of queries)
+		 * or stores it to perform multiple insert later (useful with large number of queries).
 		 *
 		 * @param Array $fields_hash
 		 * @param string $table
@@ -805,7 +793,7 @@
 		}
 
 		/**
-		 * Update given field values to given record using $key_clause
+		 * Update given field values to given record using $key_clause.
 		 *
 		 * @param Array $fields_hash
 		 * @param string $table
@@ -831,7 +819,7 @@
 		}
 
 		/**
-		 * Allows to detect table's presence in database
+		 * Allows to detect table's presence in database.
 		 *
 		 * @param string $table_name
 		 * @param bool $force
@@ -863,7 +851,7 @@
 		}
 
 		/**
-		 * Returns query processing statistics
+		 * Returns query processing statistics.
 		 *
 		 * @return Array
 		 * @access public
@@ -874,7 +862,7 @@
 		}
 
 		/**
-		 * Get status information from SHOW STATUS in an associative array
+		 * Get status information from SHOW STATUS in an associative array.
 		 *
 		 * @param string $which
 		 * @return Array
@@ -977,12 +965,10 @@
 	}
 
 	/**
-	 * Queries db with $sql query supplied
-	 * and returns rows selected if any, false
-	 * otherwise. Optional parameter $key_field
-	 * allows to set one of the query fields
-	 * value as key in string array.
+	 * Queries db with $sql query supplied and returns rows selected if any, false otherwise.
 	 *
+	 * Optional parameter $key_field allows to set one of the query fields value as key in string array.
+	 *
 	 * @param string $sql
 	 * @param string $key_field
 	 * @param bool $no_debug
@@ -1057,13 +1043,14 @@
 	}
 
 	/**
-	 * Queries db with $sql query supplied and returns kMySQLQuery iterator
-	 * or false in case of error. Optional parameter $key_field allows to
-	 * set one of the query fields value as key in string array.
+	 * Returns iterator to a recordset, produced from running $sql query.
 	 *
+	 * Queries db with $sql query supplied and returns kMySQLQuery iterator or false in case of error.
+	 * Optional parameter $key_field allows to set one of the query fields value as key in string array.
+	 *
 	 * @param string $sql
 	 * @param string $key_field
-	 * @param bool $no_debug
+	 * @param bool   $no_debug
 	 * @param string $iterator_class
 	 * @return kMySQLQuery|bool
 	 * @access public