<?php /* Copyright (c) 2007, Till Brehm, projektfarm Gmbh All rights reserved. Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: * Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer. * Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. * Neither the name of ISPConfig nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission. THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. */ class db { private $dbHost = ''; // hostname of the MySQL server private $dbName = ''; // logical database name on that server private $dbUser = ''; // database authorized user private $dbPass = ''; // user's password private $dbCharset = ''; // what charset comes and goes to mysql: utf8 / latin1 private $dbNewLink = false; // Return a new linkID when connect is called again private $dbClientFlags = 0; // MySQL Client falgs private $linkId = 0; // last result of mysql_connect() private $queryId = 0; // last result of mysql_query() private $record = array(); // last record fetched private $autoCommit = 1; // Autocommit Transactions private $currentRow; // current row number private $errorNumber = 0; // last error number public $errorMessage = ''; // last error message private $errorLocation = ''; // last error location public $show_error_messages = false; public function __construct() { global $conf; $this->dbHost = $conf['db_host']; $this->dbName = $conf['db_database']; $this->dbUser = $conf['db_user']; $this->dbPass = $conf['db_password']; $this->dbCharset = $conf['db_charset']; $this->dbNewLink = $conf['db_new_link']; $this->dbClientFlags = $conf['db_client_flags']; //$this->connect(); } /** Error handler */ public function updateError($location) { $this->errorNumber = mysql_errno(); $this->errorMessage = mysql_error(); $this->errorLocation = $location; if($this->errorNumber && $this->show_error_messages){ echo('<br /><b>'.$this->errorLocation.'</b><br />'.$this->errorMessage); flush(); } } public function connect() { if($this->linkId == 0){ $this->linkId = mysql_connect($this->dbHost, $this->dbUser, $this->dbPass, $this->dbNewLink, $this->dbClientFlags); if(!$this->linkId){ $this->updateError('DB::connect()<br />mysql_connect'); return false; } $this->queryId = @mysql_query('SET NAMES '.$this->dbCharset, $this->linkId); $this->queryId = @mysql_query("SET character_set_results = '".$this->dbCharset."', character_set_client = '".$this->dbCharset."', character_set_connection = '".$this->dbCharset."', character_set_database = '".$this->dbCharset."', character_set_server = '".$this->dbCharset."'", $this->linkId); } return true; } public function query($queryString) { if(!$this->connect()){ return false; } if(!mysql_select_db($this->dbName, $this->linkId)){ $this->updateError('DB::connect()<br />mysql_select_db'); return false; } $this->queryId = @mysql_query($queryString, $this->linkId); $this->updateError('DB::query('.$queryString.')<br />mysql_query'); if(!$this->queryId){ return false; } $this->currentRow = 0; return $this->queryId; } /** Returns all records as an array */ public function queryAllRecords($queryString) { if(!$this->query($queryString)){ return false; } $ret = array(); while($line = $this->nextRecord()){ $ret[] = $line; } return $ret; } /** Returns one row as an array */ public function queryOneRecord($queryString) { if(!$this->query($queryString) || $this->numRows() == 0){ return false; } return $this->nextRecord(); } /** Returns the next record as an array */ public function nextRecord() { $this->record = mysql_fetch_assoc($this->queryId); $this->updateError('DB::nextRecord()<br />mysql_fetch_array'); if(!$this->record || !is_array($this->record)){ return false; } $this->currentRow++; return $this->record; } /** Returns the number of rows returned by the last select query */ public function numRows() { return mysql_num_rows($this->queryId); } public function affectedRows() { return mysql_affected_rows($this->linkId); } /** Returns the last mySQL insert_id() */ public function insertID() { return mysql_insert_id($this->linkId); } /** Checks a variable - Depreciated, use quote() */ public function check($formfield) { return $this->quote($formfield); } /** Escapes quotes in variable. mysql_real_escape_string() */ public function quote($formfield) { if(!$this->connect()){ $this->updateError('WARNING: mysql_connect: Used addslashes instead of mysql_real_escape_string'); return addslashes($formfield); } return mysql_real_escape_string($formfield, $this->linkId); } /** Unquotes a variable, strip_slashes() */ public function unquote($formfield) { return stripslashes($formfield); } public function toLower($record) { if(is_array($record)){ foreach($record as $key => $val) { $key = strtolower($key); $out[$key] = $val; } } return $out; } // deprecated /* public function insert($tablename, $form, $debug = 0) { if(is_array($form)){ foreach($form as $key => $value){ $sql_key .= "$key, "; $sql_value .= "'".$this->check($value)."', "; } $sql_key = substr($sql_key,0,strlen($sql_key) - 2); $sql_value = substr($sql_value,0,strlen($sql_value) - 2); $sql = "INSERT INTO $tablename (".$sql_key.') VALUES ('.$sql_value.')'; //TODO: where has $debug come from !??? if($debug == 1){ echo "SQL-Statement: $sql<br><br>"; } $this->query($sql); if($debug == 1){ echo 'mySQL Error Message: '.$this->errorMessage; } } } // Deprecated public function update($tablename, $form, $bedingung, $debug = 0) { if(is_array($form)){ foreach($form as $key => $value){ $insql .= "$key = '".$this->check($value)."', "; } $insql = substr($insql, 0, strlen($insql) - 2); $sql = "UPDATE $tablename SET " . $insql . " WHERE $bedingung"; if($debug == 1){ echo "SQL-Statement: $sql<br><br>"; } $this->query($sql); if($debug == 1){ echo 'mySQL Error Message: '.$this->errorMessage; } } } */ public function diffrec($record_old, $record_new) { $diffrec_full = array(); $diff_num = 0; if(is_array($record_old) && count($record_old) > 0) { foreach($record_old as $key => $val) { // if(!isset($record_new[$key]) || $record_new[$key] != $val) { if($record_new[$key] != $val) { // Record has changed $diffrec_full['old'][$key] = $val; $diffrec_full['new'][$key] = $record_new[$key]; $diff_num++; } else { $diffrec_full['old'][$key] = $val; $diffrec_full['new'][$key] = $val; } } } elseif(is_array($record_new)) { foreach($record_new as $key => $val) { if(isset($record_new[$key]) && @$record_old[$key] != $val) { // Record has changed $diffrec_full['new'][$key] = $val; $diffrec_full['old'][$key] = @$record_old[$key]; $diff_num++; } else { $diffrec_full['new'][$key] = $val; $diffrec_full['old'][$key] = $val; } } } return array('diff_num' => $diff_num, 'diff_rec' => $diffrec_full); } //** Function to fill the datalog with a full differential record. public function datalogSave($db_table, $action, $primary_field, $primary_id, $record_old, $record_new) { global $app,$conf; // Insert backticks only for incomplete table names. if(stristr($db_table,'.')) { $escape = ''; } else { $escape = '`'; } $tmp = $this->diffrec($record_old, $record_new); $diffrec_full = $tmp['diff_rec']; $diff_num = $tmp['diff_num']; unset($tmp); // Insert the server_id, if the record has a server_id $server_id = (isset($record_old['server_id']) && $record_old['server_id'] > 0)?$record_old['server_id']:0; if(isset($record_new['server_id'])) $server_id = $record_new['server_id']; if($diff_num > 0) { //print_r($diff_num); //print_r($diffrec_full); $diffstr = $app->db->quote(serialize($diffrec_full)); $username = $app->db->quote($_SESSION['s']['user']['username']); $dbidx = $primary_field.':'.$primary_id; if($action == 'INSERT') $action = 'i'; if($action == 'UPDATE') $action = 'u'; if($action == 'DELETE') $action = 'd'; $sql = "INSERT INTO sys_datalog (dbtable,dbidx,server_id,action,tstamp,user,data) VALUES ('".$db_table."','$dbidx','$server_id','$action','".time()."','$username','$diffstr')"; $app->db->query($sql); } return true; } //** Inserts a record and saves the changes into the datalog public function datalogInsert($tablename, $insert_data, $index_field) { global $app; $old_rec = array(); $this->query("INSERT INTO $tablename $insert_data"); $index_value = $this->insertID(); $new_rec = $this->queryOneRecord("SELECT * FROM $tablename WHERE $index_field = '$index_value'"); $this->datalogSave($tablename, 'INSERT', $index_field, $index_value, $old_rec, $new_rec); return $index_value; } //** Updates a record and saves the changes into the datalog public function datalogUpdate($tablename, $update_data, $index_field, $index_value) { global $app; $old_rec = $this->queryOneRecord("SELECT * FROM $tablename WHERE $index_field = '$index_value'"); $this->query("UPDATE $tablename SET $update_data WHERE $index_field = '$index_value'"); $new_rec = $this->queryOneRecord("SELECT * FROM $tablename WHERE $index_field = '$index_value'"); $this->datalogSave($tablename, 'UPDATE', $index_field, $index_value, $old_rec, $new_rec); return true; } //** Deletes a record and saves the changes into the datalog public function datalogDelete($tablename, $index_field, $index_value) { global $app; $old_rec = $this->queryOneRecord("SELECT * FROM $tablename WHERE $index_field = '$index_value'"); $this->query("DELETE FROM $tablename WHERE $index_field = '$index_value'"); $new_rec = array(); $this->datalogSave($tablename, 'DELETE', $index_field, $index_value, $old_rec, $new_rec); return true; } public function closeConn() { if($this->linkId) { mysql_close($this->linkId); return true; } else { return false; } } public function freeResult($query) { if(mysql_free_result($query)) { return true; } else { return false; } } /* public function delete() { } */ /* public function Transaction($action) { //action = begin, commit oder rollback } */ /** Creates a database table with the following format for the $columns array * <code> * $columns = array(action => add | alter | drop * name => Spaltenname * name_new => neuer Spaltenname, nur bei 'alter' belegt * type => 42go-Meta-Type: int16, int32, int64, double, char, varchar, text, blob * typeValue => Wert z.B. bei Varchar * defaultValue => Default Wert * notNull => true | false * autoInc => true | false * option => unique | primary | index) * </code> */ public function createTable($table_name, $columns) { $index = ''; $sql = "CREATE TABLE $table_name ("; foreach($columns as $col){ $sql .= $col['name'].' '.$this->mapType($col['type'], $col['typeValue']).' '; //* Set default value if(isset($col['defaultValue']) && $col['defaultValue'] != '') { if($col['defaultValue'] == 'NULL' or $col['defaultValue'] == 'NOT NULL') { $sql .= 'DEFAULT '.$col['defaultValue'].' '; } else { $sql .= "DEFAULT '".$col['defaultValue']."' "; } } elseif($col['defaultValue'] != false) { $sql .= "DEFAULT '' "; } if(isset($col['defaultValue']) && $col['defaultValue'] != 'NULL' && $col['defaultValue'] != 'NOT NULL') { if($col['notNull'] == true) { $sql .= 'NOT NULL '; } else { $sql .= 'NULL '; } } if(isset($col['autoInc']) && $col['autoInc'] == true){ $sql .= 'auto_increment '; } $sql.= ','; //* Index Definitions if(isset($col['option']) && $col['option'] == 'primary'){ $index .= 'PRIMARY KEY ('.$col['name'].'),'; } if(isset($col['option']) && $col['option'] == 'index'){ $index .= 'INDEX ('.$col['name'].'),'; } if(isset($col['option']) && $col['option'] == 'unique'){ $index .= 'UNIQUE ('.$col['name'].'),'; } } $sql .= $index; $sql = substr($sql,0,-1); $sql .= ')'; $this->query($sql); return true; } /** Changes a table definition. The format for the $columns array is * <code> * $columns = array(action => add | alter | drop * name => Spaltenname * name_new => neuer Spaltenname, nur bei 'alter' belegt * type => 42go-Meta-Type: int16, int32, int64, double, char, varchar, text, blob * typeValue => Wert z.B. bei Varchar * defaultValue => Default Wert * notNull => true | false * autoInc => true | false * option => unique | primary | index) */ public function alterTable($table_name,$columns) { $index = ''; $sql = "ALTER TABLE $table_name "; foreach($columns as $col){ if($col['action'] == 'add'){ $sql .= 'ADD '.$col['name'].' '.$this->mapType($col['type'],$col['typeValue']).' '; }elseif($col['action'] == 'alter') { $sql .= 'CHANGE '.$col['name'].' '.$col['name_new'].' '.$this->mapType($col['type'],$col['typeValue']).' '; }elseif($col['action'] == 'drop') { $sql .= 'DROP '.$col['name'].' '; } if($col['action'] != 'drop') { if($col['defaultValue'] != '') $sql .= "DEFAULT '".$col['defaultValue']."' "; if($col['notNull'] == true) { $sql .= 'NOT NULL '; } else { $sql .= 'NULL '; } if($col['autoInc'] == true) $sql .= 'auto_increment '; $sql.= ','; //* Index definitions if($col['option'] == 'primary') $index .= 'PRIMARY KEY ('.$col['name'].'),'; if($col['option'] == 'index') $index .= 'INDEX ('.$col['name'].'),'; if($col['option'] == 'unique') $index .= 'UNIQUE ('.$col['name'].'),'; } } $sql .= $index; $sql = substr($sql,0,-1); //die($sql); $this->query($sql); return true; } public function dropTable($table_name) { $this->check($table_name); $sql = "DROP TABLE '". $table_name."'"; return $this->query($sql); } /** Return an array of table names */ public function getTables($database_name = '') { if($database_name == ''){ $database_name = $this->dbName; } $result = @mysql_list_tables($database_name); $tb_names = array(); for ($i = 0; $i < @mysql_num_rows($result); $i++) { $tb_names[$i] = @mysql_tablename($result, $i); } return $tb_names; } public function tableInfo($table_name) { //* Tabellenfelder einlesen ? if($rows = $this->queryAllRecords('SHOW FIELDS FROM '.$table_name)){ foreach($rows as $row) { $name = $row['Field']; $default = $row['Default']; $key = $row['Key']; $extra = $row['Extra']; $isnull = $row['Null']; $type = $row['Type']; $column = array('name' => $name, 'defaultValue' => $default); //$column["type"] = $type; if(stristr($key, 'PRI')){ $column['option'] = 'primary'; } $column['notNull'] = stristr($isnull,'YES') ? false : true; if($extra == 'auto_increment'){ $column['autoInc'] = true; } //* Get the Data and Metatype if( stristr($type, 'int(') ){ $metaType = 'int32'; } if( stristr($type, 'bigint') ){ $metaType = 'int64'; } if( stristr($type, 'char') ) { $metaType = 'char'; $tmp_typeValue = explode('(',$type); $column['typeValue'] = substr($tmp_typeValue[1], 0, -1); } if( stristr($type, 'varchar') ){ $metaType = 'varchar'; $tmp_typeValue = explode('(',$type); $column['typeValue'] = substr($tmp_typeValue[1], 0, -1); } if(stristr($type,'text')) $metaType = 'text'; if(stristr($type,'double')) $metaType = 'double'; if(stristr($type,'blob')) $metaType = 'blob'; $column['type'] = $metaType; $columns[] = $column; } return $columns; } else { return false; } } public function mapType($metaType, $typeValue) { //TODO: ? this is not required ?? global $go_api; $metaType = strtolower($metaType); switch ($metaType) { case 'int16': return 'smallint'; case 'int32': return 'int'; case 'int64': return 'bigint'; case 'double': return 'double'; case 'char': return 'char'; case 'varchar': if($typeValue < 1) die('Datenbank Fehler: F�r diesen Datentyp ist eine L�ngenangabe notwendig.'); return 'varchar('.$typeValue.')'; case 'text': return 'text'; case 'blob': return 'blob'; } } } ?>