20 |
20 |
*
|
21 |
21 |
* @category Core
|
22 |
22 |
* @package Core_database
|
23 |
|
* @author Werner v.d.Decken <wkl@isteam.de>
|
|
23 |
* @author Manuela v.d.Decken <manuela@isteam.de>
|
24 |
24 |
* @author Dietmar W. <dietmar.woellbrink@websitebaker.org>
|
25 |
|
* @copyright Werner v.d.Decken <wkl@isteam.de>
|
|
25 |
* @copyright Manuela v.d.Decken <manuela@isteam.de>
|
26 |
26 |
* @license http://www.gnu.org/licenses/gpl.html GPL License
|
27 |
27 |
* @version 0.0.9
|
28 |
28 |
* @revision $Revision$
|
... | ... | |
38 |
38 |
|
39 |
39 |
private static $_oInstances = array();
|
40 |
40 |
|
41 |
|
private $_db_handle = null; // readonly from outside
|
42 |
|
private $_db_name = '';
|
43 |
|
private $_sInstanceIdentifier = '';
|
|
41 |
protected $oDbHandle = null; // readonly from outside
|
|
42 |
protected $sDbName = '';
|
|
43 |
protected $sInstanceIdentifier = '';
|
44 |
44 |
protected $sTablePrefix = '';
|
45 |
45 |
protected $sCharset = '';
|
46 |
46 |
protected $connected = false;
|
... | ... | |
48 |
48 |
protected $error_type = '';
|
49 |
49 |
protected $iQueryCount = 0;
|
50 |
50 |
|
51 |
|
/* prevent from public instancing */
|
|
51 |
/**
|
|
52 |
* __constructor
|
|
53 |
* prevent from public instancing
|
|
54 |
*/
|
52 |
55 |
protected function __construct() {}
|
53 |
|
/* prevent from cloning */
|
|
56 |
/**
|
|
57 |
* prevent from cloning
|
|
58 |
*/
|
54 |
59 |
private function __clone() {}
|
55 |
60 |
/**
|
56 |
61 |
* get a valid instance of this class
|
57 |
62 |
* @param string $sIdentifier selector for several different instances
|
58 |
|
* @return object
|
|
63 |
* @return WbDatabase object
|
59 |
64 |
*/
|
60 |
|
public static function getInstance($sIdentifier = 'core') {
|
|
65 |
public static function getInstance($sIdentifier = 'core')
|
|
66 |
{
|
61 |
67 |
if( !isset(self::$_oInstances[$sIdentifier])) {
|
62 |
68 |
$c = __CLASS__;
|
63 |
69 |
$oInstance = new $c;
|
64 |
|
$oInstance->_sInstanceIdentifier = $sIdentifier;
|
|
70 |
$oInstance->sInstanceIdentifier = $sIdentifier;
|
65 |
71 |
self::$_oInstances[$sIdentifier] = $oInstance;
|
66 |
72 |
}
|
67 |
73 |
return self::$_oInstances[$sIdentifier];
|
68 |
74 |
}
|
69 |
75 |
/**
|
70 |
76 |
* disconnect and kills an existing instance
|
71 |
|
* @param string $sIdentifier
|
|
77 |
* @param string $sIdentifier selector for instance to kill
|
72 |
78 |
*/
|
73 |
|
public static function killInstance($sIdentifier) {
|
|
79 |
public static function killInstance($sIdentifier)
|
|
80 |
{
|
74 |
81 |
if($sIdentifier != 'core') {
|
75 |
82 |
if( isset(self::$_oInstances[$sIdentifier])) {
|
76 |
83 |
self::$_oInstances[$sIdentifier]->disconnect();
|
... | ... | |
79 |
86 |
}
|
80 |
87 |
}
|
81 |
88 |
/**
|
82 |
|
* Connect to the database
|
|
89 |
* Establish connection
|
83 |
90 |
* @param string $url
|
84 |
91 |
* @return bool
|
85 |
|
*
|
86 |
|
* Example for SQL-Url: 'mysql://user:password@demo.de[:3306]/datenbank'
|
|
92 |
* @throws WbDatabaseException
|
|
93 |
* @description opens a connection using connect URL<br />
|
|
94 |
* Example for SQL-Url: 'mysql://user:password@example.com[:3306]/database?charset=utf8&tableprefix=xx_'
|
87 |
95 |
*/
|
88 |
|
public function doConnect($url = '') {
|
89 |
|
if($this->connected) { return $this->connected; } // prevent from reconnecting
|
|
96 |
public function doConnect($url = '')
|
|
97 |
{
|
|
98 |
if ($this->connected) { return $this->connected; } // prevent from reconnecting
|
90 |
99 |
$this->connected = false;
|
91 |
|
if($url != '') {
|
|
100 |
if ($url != '') {
|
|
101 |
// parse URL and extract connection data
|
92 |
102 |
$aIni = parse_url($url);
|
93 |
|
|
94 |
103 |
$scheme = isset($aIni['scheme']) ? $aIni['scheme'] : 'mysql';
|
95 |
104 |
$hostname = isset($aIni['host']) ? $aIni['host'] : '';
|
96 |
105 |
$username = isset($aIni['user']) ? $aIni['user'] : '';
|
... | ... | |
100 |
109 |
$db_name = ltrim(isset($aIni['path']) ? $aIni['path'] : '', '/\\');
|
101 |
110 |
$sTmp = isset($aIni['query']) ? $aIni['query'] : '';
|
102 |
111 |
$aQuery = explode('&', $sTmp);
|
103 |
|
foreach($aQuery as $sArgument) {
|
|
112 |
foreach ($aQuery as $sArgument) {
|
104 |
113 |
$aArg = explode('=', $sArgument);
|
105 |
|
switch(strtolower($aArg[0])) {
|
|
114 |
switch (strtolower($aArg[0])) {
|
106 |
115 |
case 'charset':
|
107 |
116 |
$this->sCharset = strtolower(preg_replace('/[^a-z0-9]/i', '', $aArg[1]));
|
108 |
117 |
break;
|
... | ... | |
113 |
122 |
break;
|
114 |
123 |
}
|
115 |
124 |
}
|
116 |
|
$this->_db_name = $db_name;
|
117 |
|
}else {
|
|
125 |
$this->sDbName = $db_name;
|
|
126 |
} else {
|
118 |
127 |
throw new WbDatabaseException('Missing parameter: unable to connect database');
|
119 |
128 |
}
|
120 |
|
$this->_db_handle = @mysql_connect($hostname.$hostport,
|
121 |
|
$username,
|
122 |
|
$password,
|
123 |
|
true);
|
124 |
|
if(!$this->_db_handle) {
|
125 |
|
throw new WbDatabaseException('unable to connect \''.$scheme.'://'.
|
126 |
|
$hostname.$hostport.'\'');
|
|
129 |
$this->oDbHandle = @mysql_connect($hostname.$hostport, $username, $password, true);
|
|
130 |
if (!$this->oDbHandle) {
|
|
131 |
throw new WbDatabaseException('unable to connect \''.$scheme.'://'.$hostname.$hostport.'\'');
|
127 |
132 |
} else {
|
128 |
|
if(!@mysql_select_db($db_name, $this->_db_handle)) {
|
|
133 |
if (!@mysql_select_db($db_name, $this->oDbHandle)) {
|
129 |
134 |
throw new WbDatabaseException('unable to select database \''.$db_name.
|
130 |
|
'\' on \''.$scheme.'://'.
|
131 |
|
$hostname.$hostport.'\'');
|
|
135 |
'\' on \''.$scheme.'://'.
|
|
136 |
$hostname.$hostport.'\''
|
|
137 |
);
|
132 |
138 |
} else {
|
133 |
|
if($this->sCharset) {
|
134 |
|
@mysql_query('SET NAMES \''.$this->sCharset.'\'', $this->_db_handle);
|
|
139 |
if ($this->sCharset) {
|
|
140 |
@mysql_query('SET NAMES \''.$this->sCharset.'\'', $this->oDbHandle);
|
135 |
141 |
}
|
136 |
142 |
$this->connected = true;
|
137 |
143 |
}
|
138 |
144 |
}
|
139 |
145 |
return $this->connected;
|
140 |
146 |
}
|
141 |
|
|
142 |
|
// Disconnect from the database
|
143 |
|
public function disconnect() {
|
144 |
|
if($this->connected == true && $oInstance->_sInstanceIdentifier != 'core' ) {
|
145 |
|
mysql_close($this->_db_handle);
|
|
147 |
/**
|
|
148 |
* disconnect database
|
|
149 |
* @return bool
|
|
150 |
* @description Disconnect current object from the database<br />
|
|
151 |
* the 'core' connection can NOT be disconnected!
|
|
152 |
*/
|
|
153 |
public function disconnect()
|
|
154 |
{
|
|
155 |
if ($this->connected == true && $oInstance->sInstanceIdentifier != 'core') {
|
|
156 |
mysql_close($this->oDbHandle);
|
146 |
157 |
$this->connected = false;
|
147 |
158 |
return true;
|
148 |
159 |
}
|
149 |
160 |
return false;
|
150 |
161 |
}
|
151 |
|
|
152 |
|
// Run a query
|
153 |
|
public function query($statement) {
|
|
162 |
/**
|
|
163 |
* Alias for doQuery()
|
|
164 |
*/
|
|
165 |
public function query($statement)
|
|
166 |
{
|
|
167 |
return $this->doQuery($statement);
|
|
168 |
}
|
|
169 |
/**
|
|
170 |
* execute query
|
|
171 |
* @param string $statement the SQL-statement to execute
|
|
172 |
* @return null|\mysql
|
|
173 |
*/
|
|
174 |
public function doQuery($statement) {
|
154 |
175 |
$this->iQueryCount++;
|
155 |
176 |
$mysql = new mysql();
|
156 |
|
$mysql->query($statement, $this->_db_handle);
|
157 |
|
$this->set_error($mysql->error($this->_db_handle));
|
158 |
|
if($mysql->error($this->_db_handle)) {
|
|
177 |
$mysql->query($statement, $this->oDbHandle);
|
|
178 |
$this->set_error($mysql->error($this->oDbHandle));
|
|
179 |
if ($mysql->error($this->oDbHandle)) {
|
159 |
180 |
return null;
|
160 |
181 |
} else {
|
161 |
182 |
return $mysql;
|
162 |
183 |
}
|
163 |
184 |
}
|
164 |
|
|
165 |
|
// Gets the first column of the first row
|
|
185 |
/**
|
|
186 |
* Alias for getOne()
|
|
187 |
*/
|
166 |
188 |
public function get_one( $statement )
|
167 |
189 |
{
|
|
190 |
return $this->getOne($statement);
|
|
191 |
}
|
|
192 |
// Gets the first column of the first row
|
|
193 |
/**
|
|
194 |
* Gets the first column of the first row
|
|
195 |
* @param string $statement SQL-statement
|
|
196 |
* @return null|mixed
|
|
197 |
*/
|
|
198 |
public function getOne( $statement )
|
|
199 |
{
|
168 |
200 |
$this->iQueryCount++;
|
169 |
|
$fetch_row = mysql_fetch_array(mysql_query($statement, $this->_db_handle));
|
|
201 |
$fetch_row = mysql_fetch_array(mysql_query($statement, $this->oDbHandle));
|
170 |
202 |
$result = $fetch_row[0];
|
171 |
|
$this->set_error(mysql_error($this->_db_handle));
|
172 |
|
if(mysql_error($this->_db_handle)) {
|
|
203 |
$this->set_error(mysql_error($this->oDbHandle));
|
|
204 |
if (mysql_error($this->oDbHandle)) {
|
173 |
205 |
return null;
|
174 |
206 |
} else {
|
175 |
207 |
return $result;
|
176 |
208 |
}
|
177 |
209 |
}
|
178 |
|
|
|
210 |
/**
|
|
211 |
* Alias for setError()
|
|
212 |
*/
|
|
213 |
public function set_error($message = null)
|
|
214 |
{
|
|
215 |
$this->setError($message = null);
|
|
216 |
}
|
179 |
217 |
// Set the DB error
|
180 |
|
public function set_error($message = null) {
|
181 |
|
global $TABLE_DOES_NOT_EXIST, $TABLE_UNKNOWN;
|
|
218 |
/**
|
|
219 |
* setError
|
|
220 |
* @param string $message
|
|
221 |
*/
|
|
222 |
public function setError($message = null)
|
|
223 |
{
|
182 |
224 |
$this->error = $message;
|
183 |
|
if(strpos($message, 'no such table')) {
|
184 |
|
$this->error_type = $TABLE_DOES_NOT_EXIST;
|
185 |
|
} else {
|
186 |
|
$this->error_type = $TABLE_UNKNOWN;
|
187 |
|
}
|
188 |
225 |
}
|
189 |
|
|
190 |
|
// Return true if there was an error
|
191 |
|
public function is_error() {
|
|
226 |
/**
|
|
227 |
* Alias for isError
|
|
228 |
*/
|
|
229 |
public function is_error()
|
|
230 |
{
|
|
231 |
return $this->isError();
|
|
232 |
}
|
|
233 |
/**
|
|
234 |
* isError
|
|
235 |
* @return bool
|
|
236 |
*/
|
|
237 |
public function isError()
|
|
238 |
{
|
192 |
239 |
return (!empty($this->error)) ? true : false;
|
193 |
240 |
}
|
194 |
|
|
195 |
|
// Return the error
|
196 |
|
public function get_error() {
|
|
241 |
/**
|
|
242 |
* Alias for getError
|
|
243 |
*/
|
|
244 |
public function get_error()
|
|
245 |
{
|
|
246 |
return $this->getError();
|
|
247 |
}
|
|
248 |
/**
|
|
249 |
* get last Error
|
|
250 |
* @return string
|
|
251 |
*/
|
|
252 |
public function getError()
|
|
253 |
{
|
197 |
254 |
return $this->error;
|
198 |
255 |
}
|
199 |
256 |
/**
|
... | ... | |
202 |
259 |
* @param mixed value
|
203 |
260 |
* @throws WbDatabaseException
|
204 |
261 |
*/
|
205 |
|
public function __set($name, $value) {
|
|
262 |
public function __set($name, $value)
|
|
263 |
{
|
206 |
264 |
throw new WbDatabaseException('tried to set a readonly or nonexisting property ['.$name.']!! ');
|
207 |
265 |
}
|
208 |
266 |
/**
|
209 |
267 |
* default Getter for some properties
|
210 |
268 |
* @param string name of the Property
|
211 |
|
* @return mixed NULL on error or missing property
|
|
269 |
* @return NULL on error | valid property
|
212 |
270 |
*/
|
213 |
271 |
public function __get($sPropertyName)
|
214 |
272 |
{
|
215 |
|
switch ($sPropertyName):
|
216 |
|
case 'db_handle':
|
|
273 |
switch ($sPropertyName) {
|
217 |
274 |
case 'DbHandle':
|
218 |
|
case 'getDbHandle':
|
219 |
|
$retval = $this->_db_handle;
|
|
275 |
case 'getDbHandle': // << set deprecated
|
|
276 |
case 'db_handle': // << set deprecated
|
|
277 |
$retval = $this->oDbHandle;
|
220 |
278 |
break;
|
221 |
279 |
case 'LastInsertId':
|
222 |
|
case 'getLastInsertId':
|
223 |
|
$retval = mysql_insert_id($this->_db_handle);
|
|
280 |
case 'getLastInsertId': // << set deprecated
|
|
281 |
$retval = mysql_insert_id($this->oDbHandle);
|
224 |
282 |
break;
|
225 |
|
case 'db_name':
|
226 |
283 |
case 'DbName':
|
227 |
|
case 'getDbName':
|
228 |
|
$retval = $this->_db_name;
|
|
284 |
case 'getDbName': // << set deprecated
|
|
285 |
case 'db_name': // << set deprecated
|
|
286 |
$retval = $this->sDbName;
|
229 |
287 |
break;
|
230 |
288 |
case 'TablePrefix':
|
231 |
|
case 'getTablePrefix':
|
|
289 |
case 'getTablePrefix': // << set deprecated
|
232 |
290 |
$retval = $this->sTablePrefix;
|
233 |
291 |
break;
|
234 |
292 |
case 'QueryCount':
|
235 |
|
case 'getQueryCount':
|
|
293 |
case 'getQueryCount': // << set deprecated
|
236 |
294 |
$retval = $this->iQueryCount;
|
237 |
295 |
break;
|
238 |
296 |
default:
|
239 |
297 |
$retval = null;
|
240 |
298 |
break;
|
241 |
|
endswitch;
|
|
299 |
}
|
242 |
300 |
return $retval;
|
243 |
301 |
} // __get()
|
244 |
302 |
/**
|
... | ... | |
248 |
306 |
*/
|
249 |
307 |
public function escapeString($unescaped_string)
|
250 |
308 |
{
|
251 |
|
return mysql_real_escape_string($unescaped_string, $this->_db_handle);
|
|
309 |
return mysql_real_escape_string($unescaped_string, $this->oDbHandle);
|
252 |
310 |
}
|
253 |
311 |
/**
|
254 |
312 |
* Last inserted Id
|
... | ... | |
256 |
314 |
*/
|
257 |
315 |
public function getLastInsertId()
|
258 |
316 |
{
|
259 |
|
return mysql_insert_id($this->_db_handle);
|
|
317 |
return mysql_insert_id($this->oDbHandle);
|
260 |
318 |
}
|
|
319 |
/**
|
|
320 |
* Alias for isField()
|
|
321 |
*/
|
|
322 |
public function field_exists($table_name, $field_name)
|
|
323 |
{
|
|
324 |
return $this->isField($table_name, $field_name);
|
|
325 |
}
|
261 |
326 |
/*
|
262 |
327 |
* @param string full name of the table (incl. TABLE_PREFIX)
|
263 |
328 |
* @param string name of the field to seek for
|
264 |
329 |
* @return bool true if field exists
|
265 |
330 |
*/
|
266 |
|
public function field_exists($table_name, $field_name)
|
|
331 |
public function isField($table_name, $field_name)
|
267 |
332 |
{
|
268 |
333 |
$sql = 'DESCRIBE `'.$table_name.'` `'.$field_name.'` ';
|
269 |
|
$query = $this->query($sql, $this->_db_handle);
|
|
334 |
$query = $this->query($sql, $this->oDbHandle);
|
270 |
335 |
return ($query->numRows() != 0);
|
271 |
336 |
}
|
|
337 |
/**
|
|
338 |
* Alias for isIndex()
|
|
339 |
*/
|
|
340 |
public function index_exists($table_name, $index_name, $number_fields = 0)
|
|
341 |
{
|
|
342 |
return $this->isIndex($table_name, $index_name, $number_fields = 0);
|
|
343 |
}
|
272 |
344 |
/*
|
|
345 |
* isIndex
|
273 |
346 |
* @param string full name of the table (incl. TABLE_PREFIX)
|
274 |
347 |
* @param string name of the index to seek for
|
275 |
348 |
* @return bool true if field exists
|
276 |
349 |
*/
|
277 |
|
public function index_exists($table_name, $index_name, $number_fields = 0)
|
|
350 |
public function isIndex($table_name, $index_name, $number_fields = 0)
|
278 |
351 |
{
|
279 |
352 |
$number_fields = intval($number_fields);
|
280 |
353 |
$keys = 0;
|
281 |
354 |
$sql = 'SHOW INDEX FROM `'.$table_name.'`';
|
282 |
|
if( ($res_keys = $this->query($sql, $this->_db_handle)) )
|
283 |
|
{
|
284 |
|
while(($rec_key = $res_keys->fetchRow()))
|
285 |
|
{
|
286 |
|
if( $rec_key['Key_name'] == $index_name )
|
287 |
|
{
|
|
355 |
if (($res_keys = $this->doQuery($sql, $this->oDbHandle))) {
|
|
356 |
while (($rec_key = $res_keys->fetchRow(MYSQL_ASSOC))) {
|
|
357 |
if ( $rec_key['Key_name'] == $index_name ) {
|
288 |
358 |
$keys++;
|
289 |
359 |
}
|
290 |
360 |
}
|
291 |
361 |
|
292 |
362 |
}
|
293 |
|
if( $number_fields == 0 )
|
294 |
|
{
|
|
363 |
if ( $number_fields == 0 ) {
|
295 |
364 |
return ($keys != $number_fields);
|
296 |
|
}else
|
297 |
|
{
|
|
365 |
} else {
|
298 |
366 |
return ($keys == $number_fields);
|
299 |
367 |
}
|
300 |
368 |
}
|
301 |
|
|
|
369 |
/**
|
|
370 |
* Alias for addField()
|
|
371 |
*/
|
|
372 |
public function field_add($table_name, $field_name, $description)
|
|
373 |
{
|
|
374 |
return $this->addField($table_name, $field_name, $description);
|
|
375 |
}
|
302 |
376 |
/*
|
303 |
377 |
* @param string full name of the table (incl. TABLE_PREFIX)
|
304 |
378 |
* @param string name of the field to add
|
305 |
379 |
* @param string describes the new field like ( INT NOT NULL DEFAULT '0')
|
306 |
380 |
* @return bool true if successful, otherwise false and error will be set
|
307 |
381 |
*/
|
308 |
|
public function field_add($table_name, $field_name, $description)
|
|
382 |
public function addField($table_name, $field_name, $description)
|
309 |
383 |
{
|
310 |
|
if( !$this->field_exists($table_name, $field_name) )
|
311 |
|
{ // add new field into a table
|
|
384 |
if (!$this->isField($table_name, $field_name)) {
|
|
385 |
// add new field into a table
|
312 |
386 |
$sql = 'ALTER TABLE `'.$table_name.'` ADD '.$field_name.' '.$description.' ';
|
313 |
|
$query = $this->query($sql, $this->_db_handle);
|
314 |
|
$this->set_error(mysql_error($this->_db_handle));
|
315 |
|
if( !$this->is_error() )
|
316 |
|
{
|
317 |
|
return ( $this->field_exists($table_name, $field_name) ) ? true : false;
|
|
387 |
$query = $this->doQuery($sql, $this->oDbHandle);
|
|
388 |
$this->set_error(mysql_error($this->oDbHandle));
|
|
389 |
if (!$this->isError()) {
|
|
390 |
return ( $this->isField($table_name, $field_name) ) ? true : false;
|
318 |
391 |
}
|
319 |
|
}else
|
320 |
|
{
|
|
392 |
} else {
|
321 |
393 |
$this->set_error('field \''.$field_name.'\' already exists');
|
322 |
394 |
}
|
323 |
395 |
return false;
|
324 |
396 |
}
|
325 |
|
|
|
397 |
/**
|
|
398 |
* Alias for modifyField()
|
|
399 |
*/
|
|
400 |
public function field_modify($table_name, $field_name, $description)
|
|
401 |
{
|
|
402 |
return $this->modifyField($table_name, $field_name, $description);
|
|
403 |
}
|
326 |
404 |
/*
|
327 |
405 |
* @param string $table_name: full name of the table (incl. TABLE_PREFIX)
|
328 |
406 |
* @param string $field_name: name of the field to add
|
329 |
407 |
* @param string $description: describes the new field like ( INT NOT NULL DEFAULT '0')
|
330 |
408 |
* @return bool: true if successful, otherwise false and error will be set
|
331 |
409 |
*/
|
332 |
|
public function field_modify($table_name, $field_name, $description)
|
|
410 |
public function modifyField($table_name, $field_name, $description)
|
333 |
411 |
{
|
334 |
412 |
$retval = false;
|
335 |
|
if( $this->field_exists($table_name, $field_name) )
|
336 |
|
{ // modify a existing field in a table
|
|
413 |
if ($this->isField($table_name, $field_name)) {
|
|
414 |
// modify a existing field in a table
|
337 |
415 |
$sql = 'ALTER TABLE `'.$table_name.'` MODIFY `'.$field_name.'` '.$description;
|
338 |
|
$retval = ( $this->query($sql, $this->_db_handle) ? true : false);
|
339 |
|
$this->set_error(mysql_error());
|
|
416 |
$retval = ( $this->doQuery($sql, $this->oDbHandle) ? true : false);
|
|
417 |
$this->setError(mysql_error());
|
340 |
418 |
}
|
341 |
419 |
return $retval;
|
342 |
420 |
}
|
343 |
|
|
|
421 |
/**
|
|
422 |
* Alias for removeField()
|
|
423 |
*/
|
|
424 |
public function field_remove($table_name, $field_name)
|
|
425 |
{
|
|
426 |
return $this->removeField($table_name, $field_name);
|
|
427 |
}
|
344 |
428 |
/*
|
345 |
429 |
* @param string $table_name: full name of the table (incl. TABLE_PREFIX)
|
346 |
430 |
* @param string $field_name: name of the field to remove
|
347 |
431 |
* @return bool: true if successful, otherwise false and error will be set
|
348 |
432 |
*/
|
349 |
|
public function field_remove($table_name, $field_name)
|
|
433 |
public function removeField($table_name, $field_name)
|
350 |
434 |
{
|
351 |
435 |
$retval = false;
|
352 |
|
if( $this->field_exists($table_name, $field_name) )
|
353 |
|
{ // modify a existing field in a table
|
|
436 |
if ($this->isField($table_name, $field_name)) {
|
|
437 |
// modify a existing field in a table
|
354 |
438 |
$sql = 'ALTER TABLE `'.$table_name.'` DROP `'.$field_name.'`';
|
355 |
|
$retval = ( $this->query($sql, $this->_db_handle) ? true : false );
|
|
439 |
$retval = ( $this->doQuery($sql, $this->oDbHandle) ? true : false );
|
356 |
440 |
}
|
357 |
441 |
return $retval;
|
358 |
442 |
}
|
359 |
|
|
|
443 |
/**
|
|
444 |
* Alias for addIndex()
|
|
445 |
*/
|
|
446 |
public function index_add($table_name, $index_name, $field_list, $index_type = 'KEY')
|
|
447 |
{
|
|
448 |
return $this->addIndex($table_name, $index_name, $field_list, $index_type);
|
|
449 |
}
|
360 |
450 |
/*
|
361 |
451 |
* @param string $table_name: full name of the table (incl. TABLE_PREFIX)
|
362 |
452 |
* @param string $index_name: name of the new index (empty string for PRIMARY)
|
... | ... | |
364 |
454 |
* @param string $index_type: kind of index (PRIMARY, UNIQUE, KEY, FULLTEXT)
|
365 |
455 |
* @return bool: true if successful, otherwise false and error will be set
|
366 |
456 |
*/
|
367 |
|
public function index_add($table_name, $index_name, $field_list, $index_type = 'KEY')
|
|
457 |
public function addIndex($table_name, $index_name, $field_list, $index_type = 'KEY')
|
368 |
458 |
{
|
369 |
459 |
$retval = false;
|
370 |
460 |
$field_list = explode(',', (str_replace(' ', '', $field_list)));
|
371 |
461 |
$number_fields = sizeof($field_list);
|
372 |
462 |
$field_list = '`'.implode('`,`', $field_list).'`';
|
373 |
463 |
$index_name = $index_type == 'PRIMARY' ? $index_type : $index_name;
|
374 |
|
if( $this->index_exists($table_name, $index_name, $number_fields) ||
|
375 |
|
$this->index_exists($table_name, $index_name))
|
|
464 |
if ( $this->isIndex($table_name, $index_name, $number_fields) ||
|
|
465 |
$this->isIndex($table_name, $index_name))
|
376 |
466 |
{
|
377 |
467 |
$sql = 'ALTER TABLE `'.$table_name.'` ';
|
378 |
468 |
$sql .= 'DROP INDEX `'.$index_name.'`';
|
379 |
|
if( !$this->query($sql, $this->_db_handle)) { return false; }
|
|
469 |
if (!$this->doQuery($sql, $this->oDbHandle)) { return false; }
|
380 |
470 |
}
|
381 |
471 |
$sql = 'ALTER TABLE `'.$table_name.'` ';
|
382 |
472 |
$sql .= 'ADD '.$index_type.' ';
|
383 |
473 |
$sql .= $index_type == 'PRIMARY' ? 'KEY ' : '`'.$index_name.'` ';
|
384 |
474 |
$sql .= '( '.$field_list.' ); ';
|
385 |
|
if( $this->query($sql, $this->_db_handle)) { $retval = true; }
|
|
475 |
if ($this->doQuery($sql, $this->oDbHandle)) { $retval = true; }
|
386 |
476 |
return $retval;
|
387 |
477 |
}
|
388 |
|
|
|
478 |
/**
|
|
479 |
* Alias for removeIndex()
|
|
480 |
*/
|
|
481 |
public function index_remove($table_name, $index_name)
|
|
482 |
{
|
|
483 |
return $this->removeIndex($table_name, $index_name);
|
|
484 |
}
|
389 |
485 |
/*
|
390 |
486 |
* @param string $table_name: full name of the table (incl. TABLE_PREFIX)
|
391 |
487 |
* @param string $field_name: name of the field to remove
|
392 |
488 |
* @return bool: true if successful, otherwise false and error will be set
|
393 |
489 |
*/
|
394 |
|
public function index_remove($table_name, $index_name)
|
|
490 |
public function removeIndex($table_name, $index_name)
|
395 |
491 |
{
|
396 |
492 |
$retval = false;
|
397 |
|
if( $this->index_exists($table_name, $index_name) )
|
398 |
|
{ // modify a existing field in a table
|
|
493 |
if ($this->isIndex($table_name, $index_name)) {
|
|
494 |
// modify a existing field in a table
|
399 |
495 |
$sql = 'ALTER TABLE `'.$table_name.'` DROP INDEX `'.$index_name.'`';
|
400 |
|
$retval = ( $this->query($sql, $this->_db_handle) ? true : false );
|
|
496 |
$retval = ( $this->doQuery($sql, $this->oDbHandle) ? true : false );
|
401 |
497 |
}
|
402 |
498 |
return $retval;
|
403 |
499 |
}
|
404 |
|
|
405 |
500 |
/**
|
|
501 |
* Alias for importSql()
|
|
502 |
*/
|
|
503 |
public function SqlImport($sSqlDump,
|
|
504 |
$sTablePrefix = '',
|
|
505 |
$bPreserve = true,
|
|
506 |
$sEngine = 'MyISAM',
|
|
507 |
$sCollation = 'utf8_unicode_ci')
|
|
508 |
{
|
|
509 |
return $this->importSql($sSqlDump, $sTablePrefix, $bPreserve, $sEngine, $sCollation);
|
|
510 |
}
|
|
511 |
/**
|
406 |
512 |
* Import a standard *.sql dump file
|
407 |
513 |
* @param string $sSqlDump link to the sql-dumpfile
|
408 |
514 |
* @param string $sTablePrefix
|
... | ... | |
410 |
516 |
* @param string $sEngine can be 'MyISAM' or 'InnoDB'
|
411 |
517 |
* @param string $sCollation one of the list of available collations
|
412 |
518 |
* @return boolean true if import successful
|
|
519 |
* @description Import a standard *.sql dump file<br />
|
|
520 |
* The file can include placeholders TABLE_PREFIX, TABLE_COLLATION and TABLE_ENGINE
|
413 |
521 |
*/
|
414 |
|
public function SqlImport($sSqlDump,
|
415 |
|
$sTablePrefix = '',
|
|
522 |
public function importSql($sSqlDump,
|
|
523 |
$sTablePrefix = '', /* unused argument, for backward compatibility only! */
|
416 |
524 |
$bPreserve = true,
|
417 |
525 |
$sEngine = 'MyISAM',
|
418 |
526 |
$sCollation = 'utf8_unicode_ci')
|
... | ... | |
429 |
537 |
$aSql = file($sSqlDump);
|
430 |
538 |
// $aSql[0] = preg_replace('/^\xEF\xBB\xBF/', '', $aSql[0]);
|
431 |
539 |
$aSql[0] = preg_replace('/^[\xAA-\xFF]{3}/', '', $aSql[0]);
|
432 |
|
while ( sizeof($aSql) > 0 ) {
|
|
540 |
while (sizeof($aSql) > 0) {
|
433 |
541 |
$sSqlLine = trim(array_shift($aSql));
|
434 |
542 |
if (!preg_match('/^[-\/]+.*/', $sSqlLine)) {
|
435 |
543 |
$sql = $sql.' '.$sSqlLine;
|
436 |
544 |
if ((substr($sql,-1,1) == ';')) {
|
437 |
545 |
$sql = trim(str_replace( $aSearch, $aReplace, $sql));
|
438 |
546 |
if (!($bPreserve && preg_match('/^\s*DROP TABLE IF EXISTS/siU', $sql))) {
|
439 |
|
if(!mysql_query($sql, $this->_db_handle)) {
|
|
547 |
if (!mysql_query($sql, $this->oDbHandle)) {
|
440 |
548 |
$retval = false;
|
441 |
|
$this->error = mysql_error($this->_db_handle);
|
|
549 |
$this->error = mysql_error($this->oDbHandle);
|
442 |
550 |
unset($aSql);
|
443 |
551 |
break;
|
444 |
552 |
}
|
... | ... | |
449 |
557 |
}
|
450 |
558 |
return $retval;
|
451 |
559 |
}
|
452 |
|
|
453 |
560 |
/**
|
454 |
561 |
* retuns the type of the engine used for requested table
|
455 |
562 |
* @param string $table name of the table, including prefix
|
... | ... | |
458 |
565 |
public function getTableEngine($table)
|
459 |
566 |
{
|
460 |
567 |
$retVal = false;
|
461 |
|
$mysqlVersion = mysql_get_server_info($this->_db_handle);
|
|
568 |
$mysqlVersion = mysql_get_server_info($this->oDbHandle);
|
462 |
569 |
$engineValue = (version_compare($mysqlVersion, '5.0') < 0) ? 'Type' : 'Engine';
|
463 |
|
$sql = 'SHOW TABLE STATUS FROM `' . $this->_db_name . '` LIKE \'' . $table . '\'';
|
464 |
|
if(($result = $this->query($sql, $this->_db_handle))) {
|
465 |
|
if(($row = $result->fetchRow(MYSQL_ASSOC))) {
|
|
570 |
$sql = 'SHOW TABLE STATUS FROM `' . $this->sDbName . '` LIKE \'' . $table . '\'';
|
|
571 |
if (($result = $this->doQuery($sql, $this->oDbHandle))) {
|
|
572 |
if (($row = $result->fetchRow(MYSQL_ASSOC))) {
|
466 |
573 |
$retVal = $row[$engineValue];
|
467 |
574 |
}
|
468 |
575 |
}
|
... | ... | |
477 |
584 |
*
|
478 |
585 |
* @category Core
|
479 |
586 |
* @package Core_database
|
480 |
|
* @author Werner v.d.Decken <wkl@isteam.de>
|
481 |
|
* @copyright Werner v.d.Decken <wkl@isteam.de>
|
|
587 |
* @author Manuela v.d.Decken <manuela@isteam.de>
|
|
588 |
* @copyright Manuela v.d.Decken <manuela@isteam.de>
|
482 |
589 |
* @license http://www.gnu.org/licenses/gpl.html GPL License
|
483 |
590 |
* @version 2.9.0
|
484 |
591 |
* @revision $Revision$
|
... | ... | |
487 |
594 |
*/
|
488 |
595 |
class WbDatabaseException extends AppException {}
|
489 |
596 |
|
490 |
|
define('MYSQL_SEEK_FIRST', 0);
|
491 |
|
define('MYSQL_SEEK_LAST', -1);
|
|
597 |
/* extend global constants of mysql */
|
|
598 |
if(!defined('MYSQL_SEEK_FIRST')) { define('MYSQL_SEEK_FIRST', 0); }
|
|
599 |
if(!defined('MYSQL_SEEK_LAST')) { define('MYSQL_SEEK_LAST', -1); }
|
492 |
600 |
|
|
601 |
/**
|
|
602 |
* mysql
|
|
603 |
*
|
|
604 |
* @category Core
|
|
605 |
* @package Core_database
|
|
606 |
* @author Manuela v.d.Decken <manuela@isteam.de>
|
|
607 |
* @copyright Manuela v.d.Decken <manuela@isteam.de>
|
|
608 |
* @license http://www.gnu.org/licenses/gpl.html GPL License
|
|
609 |
* @version 2.9.0
|
|
610 |
* @revision $Revision$
|
|
611 |
* @lastmodified $Date$
|
|
612 |
* @description MYSQL result object for requests
|
|
613 |
*
|
|
614 |
*/
|
493 |
615 |
class mysql {
|
494 |
616 |
|
495 |
617 |
private $result = null;
|
496 |
618 |
private $_db_handle = null;
|
497 |
|
// Run a query
|
498 |
|
function query($statement, $dbHandle) {
|
499 |
|
$this->_db_handle = $dbHandle;
|
500 |
|
$this->result = @mysql_query($statement, $this->_db_handle);
|
501 |
|
if($this->result === false) {
|
502 |
|
if(DEBUG) {
|
503 |
|
throw new WbDatabaseException(mysql_error($this->_db_handle));
|
504 |
|
}else{
|
|
619 |
|
|
620 |
/**
|
|
621 |
* query sql statement
|
|
622 |
* @param string $statement
|
|
623 |
* @param object $dbHandle
|
|
624 |
* @return object
|
|
625 |
* @throws WbDatabaseException
|
|
626 |
*/
|
|
627 |
function query($statement, $dbHandle)
|
|
628 |
{
|
|
629 |
$this->oDbHandle = $dbHandle;
|
|
630 |
$this->result = @mysql_query($statement, $this->oDbHandle);
|
|
631 |
if ($this->result === false) {
|
|
632 |
if (DEBUG) {
|
|
633 |
throw new WbDatabaseException(mysql_error($this->oDbHandle));
|
|
634 |
} else {
|
505 |
635 |
throw new WbDatabaseException('Error in SQL-Statement');
|
506 |
636 |
}
|
507 |
637 |
}
|
508 |
|
$this->error = mysql_error($this->_db_handle);
|
|
638 |
$this->error = mysql_error($this->oDbHandle);
|
509 |
639 |
return $this->result;
|
510 |
640 |
}
|
511 |
|
|
512 |
|
// Fetch num rows
|
513 |
|
function numRows() {
|
|
641 |
/**
|
|
642 |
* numRows
|
|
643 |
* @return integer
|
|
644 |
* @description number of returned records
|
|
645 |
*/
|
|
646 |
function numRows()
|
|
647 |
{
|
514 |
648 |
return mysql_num_rows($this->result);
|
515 |
649 |
}
|
516 |
|
|
517 |
|
// Fetch row $typ = MYSQL_ASSOC, MYSQL_NUM, MYSQL_BOTH
|
518 |
|
function fetchRow($typ = MYSQL_BOTH) {
|
|
650 |
/**
|
|
651 |
* fetchRow
|
|
652 |
* @param int $typ MYSQL_BOTH(default) | MYSQL_ASSOC | MYSQL_NUM
|
|
653 |
* @return array
|
|
654 |
* @description get current record and increment pointer
|
|
655 |
*/
|
|
656 |
function fetchRow($typ = MYSQL_BOTH)
|
|
657 |
{
|
519 |
658 |
return mysql_fetch_array($this->result, $typ);
|
520 |
659 |
}
|
521 |
|
|
|
660 |
/**
|
|
661 |
* fetchObject
|
|
662 |
* @param string $sClassname Name of the class to use. Is no given use stdClass
|
|
663 |
* @param string $aParams optional array of arguments for the constructor
|
|
664 |
* @return object
|
|
665 |
* @description get current record as an object and increment pointer
|
|
666 |
*/
|
|
667 |
function fetchObject($sClassName = null, array $aParams = null)
|
|
668 |
{
|
|
669 |
return mysql_fetch_object($this->result, $sClassName, $aParams);
|
|
670 |
}
|
|
671 |
/**
|
|
672 |
* rewind
|
|
673 |
* @return bool
|
|
674 |
* @description set the recordpointer to the first record || false on error
|
|
675 |
*/
|
522 |
676 |
function rewind()
|
523 |
677 |
{
|
524 |
|
return $this->seekRow();
|
|
678 |
return $this->seekRow(MYSQL_SEEK_FIRST);
|
525 |
679 |
}
|
526 |
|
|
|
680 |
/**
|
|
681 |
* seekRow
|
|
682 |
* @param int $position
|
|
683 |
* @return bool
|
|
684 |
* @description set the pointer to the given record || false on error
|
|
685 |
*/
|
527 |
686 |
function seekRow( $position = MYSQL_SEEK_FIRST )
|
528 |
687 |
{
|
529 |
688 |
$pmax = $this->numRows() - 1;
|
530 |
689 |
$p = (($position < 0 || $position > $pmax) ? $pmax : $position);
|
531 |
690 |
return mysql_data_seek($this->result, $p);
|
532 |
691 |
}
|
533 |
|
|
534 |
|
// Get error
|
535 |
|
function error() {
|
536 |
|
if(isset($this->error)) {
|
|
692 |
/**
|
|
693 |
* freeResult
|
|
694 |
* @return bool
|
|
695 |
* @description remove retult object from memeory
|
|
696 |
*/
|
|
697 |
function freeResult()
|
|
698 |
{
|
|
699 |
return mysql_free_result($this->result);
|
|
700 |
}
|
|
701 |
/**
|
|
702 |
* Get error
|
|
703 |
* @return string || null if no error
|
|
704 |
*/
|
|
705 |
function error()
|
|
706 |
{
|
|
707 |
if (isset($this->error)) {
|
537 |
708 |
return $this->error;
|
538 |
709 |
} else {
|
539 |
710 |
return null;
|
... | ... | |
553 |
724 |
*/
|
554 |
725 |
function db_update_key_value($table, $key, $value = '')
|
555 |
726 |
{
|
556 |
|
global $database;
|
557 |
|
if( !is_array($key))
|
558 |
|
{
|
559 |
|
if( trim($key) != '' )
|
560 |
|
{
|
|
727 |
$oDb = WbDatabase::getInstance();
|
|
728 |
if (!is_array($key)) {
|
|
729 |
if (trim($key) != '') {
|
561 |
730 |
$key = array( trim($key) => trim($value) );
|
562 |
731 |
} else {
|
563 |
732 |
$key = array();
|
... | ... | |
568 |
737 |
{
|
569 |
738 |
$index = strtolower($index);
|
570 |
739 |
$sql = 'SELECT COUNT(`setting_id`) '
|
571 |
|
. 'FROM `'.TABLE_PREFIX.$table.'` '
|
|
740 |
. 'FROM `'.$oDb->TablePrefix.$table.'` '
|
572 |
741 |
. 'WHERE `name` = \''.$index.'\' ';
|
573 |
|
if($database->get_one($sql))
|
574 |
|
{
|
|
742 |
if ($oDb->getOne($sql)) {
|
575 |
743 |
$sql = 'UPDATE ';
|
576 |
744 |
$sql_where = 'WHERE `name` = \''.$index.'\'';
|
577 |
|
}else {
|
|
745 |
} else {
|
578 |
746 |
$sql = 'INSERT INTO ';
|
579 |
747 |
$sql_where = '';
|
580 |
748 |
}
|
581 |
|
$sql .= '`'.TABLE_PREFIX.$table.'` ';
|
|
749 |
$sql .= '`'.$oDb->TablePrefix.$table.'` ';
|
582 |
750 |
$sql .= 'SET `name` = \''.$index.'\', ';
|
583 |
751 |
$sql .= '`value` = \''.$val.'\' '.$sql_where;
|
584 |
|
if( !$database->query($sql) )
|
585 |
|
{
|
|
752 |
if (!$oDb->doQuery($sql)) {
|
586 |
753 |
$retval = false;
|
587 |
754 |
}
|
588 |
755 |
}
|
+ WbDatabase added new methods fetchObject(), rewind(), seekRow(), freeResult()
! renamed some methods and add aliases for the old names