1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
|
<?php
/*
+-------------------------------------------------------------------------+
| Copyright (C) 2004 Ian Berry |
| |
| 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. |
| |
| This program 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. |
+-------------------------------------------------------------------------+
| cacti: a php-based graphing solution |
+-------------------------------------------------------------------------+
| Most of this code has been designed, written and is maintained by |
| Ian Berry. See about.php for specific developer credit. Any questions |
| or comments regarding this code should be directed to: |
| - iberry@raxnet.net |
+-------------------------------------------------------------------------+
| - raXnet - http://www.raxnet.net/ |
+-------------------------------------------------------------------------+
*/
/* db_connect_real - makes a connection to the database server
@arg $host - the hostname of the database server, 'localhost' if the database server is running
on this machine
@arg $user - the username to connect to the database server as
@arg $pass - the password to connect to the database server with
@arg $db_name - the name of the database to connect to
@arg $db_type - the type of database server to connect to, only 'mysql' is currently supported
@arg $retries - the number a time the server should attempt to connect before failing
@returns - (bool) '1' for success, '0' for error */
function db_connect_real($host,$user,$pass,$db_name,$db_type, $retries = 20) {
global $cnn_id;
$i = 1;
$cnn_id = NewADOConnection($db_type);
while ($i <= $retries) {
if ($cnn_id->Connect($host,$user,$pass,$db_name)) {
return(1);
}
$i++;
usleep(100000);
}
cacti_log("ERROR: Cannot connect to MySQL server on '$host'. Please make sure you have specified a valid MySQL database name in 'include/config.php'.");
die("<br>Cannot connect to MySQL server on '$host'. Please make sure you have specified a valid MySQL database name in 'include/config.php'.");
return(0);
}
/* db_execute - run an sql query and do not return any output
@arg $sql - the sql query to execute
@returns - '1' for success, '0' for error */
function db_execute($sql) {
global $cnn_id;
if (!$cnn_id) { db_connect(); }
$query = $cnn_id->Execute($sql);
if ($query) {
return(1);
}else{
return(0);
}
}
/* db_fetch_cell - run a 'select' sql query and return the first column of the
first row found
@arg $sql - the sql query to execute
@arg $col_name - use this column name instead of the first one
@returns - (bool) the output of the sql query as a single variable */
function db_fetch_cell($sql,$col_name = '') {
global $cnn_id;
if (!$cnn_id) { db_connect(); }
if ($col_name != '') {
$cnn_id->SetFetchMode(ADODB_FETCH_ASSOC);
}else{
$cnn_id->SetFetchMode(ADODB_FETCH_NUM);
}
$query = $cnn_id->Execute($sql);
if ($query) {
if (!$query->EOF) {
if ($col_name != '') {
return($query->fields[$col_name]);
}else{
return($query->fields[0]);
}
}
}
}
/* db_fetch_row - run a 'select' sql query and return the first row found
@arg $sql - the sql query to execute
@returns - the first row of the result as a hash */
function db_fetch_row($sql) {
global $cnn_id;
if (!$cnn_id) { db_connect(); }
$cnn_id->SetFetchMode(ADODB_FETCH_ASSOC);
$query = $cnn_id->Execute($sql);
if ($query) {
if (!$query->EOF) {
return($query->fields);
}
}
}
/* db_fetch_assoc - run a 'select' sql query and return all rows found
@arg $sql - the sql query to execute
@returns - the entire result set as a multi-dimensional hash */
function db_fetch_assoc($sql) {
global $cnn_id;
if (!$cnn_id) { db_connect(); }
$data = array();
$cnn_id->SetFetchMode(ADODB_FETCH_ASSOC);
$query = $cnn_id->Execute($sql);
if ($query) {
while ((!$query->EOF) && ($query)) {
$data{sizeof($data)} = $query->fields;
$query->MoveNext();
}
return($data);
}
}
/* db_fetch_insert_id - get the last insert_id or auto incriment
@returns - the id of the last auto incriment row that was created */
function db_fetch_insert_id() {
global $cnn_id;
return $cnn_id->Insert_ID();
}
/* array_to_sql_or - loops through a single dimentional array and converts each
item to a string that can be used in the OR portion of an sql query in the
following form:
column=item1 OR column=item2 OR column=item2 ...
@arg $array - the array to convert
@arg $sql_column - the column to set each item in the array equal to
@returns - a string that can be placed in a SQL OR statement */
function array_to_sql_or($array, $sql_column) {
/* if the last item is null; pop it off */
if ((empty($array{count($array)-1})) && (sizeof($array) > 1)) {
array_pop($array);
}
if (count($array) > 0) {
$sql_or = "(";
for ($i=0;($i<count($array));$i++) {
$sql_or .= $sql_column . "='" . $array[$i] . "'";
if (($i+1) < count($array)) {
$sql_or .= " OR ";
}
}
$sql_or .= ")";
return $sql_or;
}
}
/* db_replace - replaces the data contained in a particular row
@arg $table_name - the name of the table to make the replacement in
@arg $array_items - an array containing each column -> value mapping in the row
@arg $keyCols - the name of the column containing the primary key
@arg $autoQuote - whether to use intelligent quoting or not
@returns - the auto incriment id column (if applicable) */
function db_replace($table_name, $array_items, $keyCols) {
global $cnn_id;
$cnn_id->Replace($table_name, $array_items, $keyCols);
return $cnn_id->Insert_ID();
}
/* sql_save - saves data to an sql table
@arg $array_items - an array containing each column -> value mapping in the row
@arg $table_name - the name of the table to make the replacement in
@arg $key_cols - the primary key(s)
@returns - the auto incriment id column (if applicable) */
function sql_save($array_items, $table_name, $key_cols='id') {
global $cnn_id;
while (list ($key, $value) = each ($array_items)) {
if (preg_match("/^((password|md5|now)\(.*\)|null)$/i", $value)) {
$quote = "";
}else{
$quote = "\"";
}
$array_items[$key] = "$quote$value$quote";
}
if (!$cnn_id->Replace($table_name, $array_items, $key_cols, false)) { return 0; }
/* get the last AUTO_ID and return it */
if ($cnn_id->Insert_ID() == "0") {
if (isset($array_items["id"])) {
return str_replace("\"", "", $array_items["id"]);
}else{
return 0;
}
}else{
return $cnn_id->Insert_ID();
}
}
?>
|
