<?php
/**
* Ultimate MySQL Wrapper Class
*
* @version 3.0
* @author Jeff L. Williams
* @link http://www.phpclasses.org/ultimatemysql
*
* Contributions from
* Frank P. Walentynowicz
* Larry Wakeman
* Nicola Abbiuso
* Douglas Gintz
* Emre Erkan
* Vincent van Daal
* Michael Ansaldi
* Ryan Tse
*/
class DatabaseBean
{
// SET THESE VALUES TO MATCH YOUR DATA CONNECTION
private $db_host = 'localhost'; // server name
private $db_user = 'telcopedia'; // user name
private $db_pass = '@HzmndLw245cjCcz'; // password
private $db_dbname = 'telcopedia_2018'; // database name
private $db_charset = ""; // optional character set (i.e. utf8)
private $db_pcon = false; // use persistent connection?
// constants for SQLValue function
const SQLVALUE_BIT = "bit";
const SQLVALUE_BOOLEAN = "boolean";
const SQLVALUE_DATE = "date";
const SQLVALUE_DATETIME = "datetime";
const SQLVALUE_NUMBER = "number";
const SQLVALUE_T_F = "t-f";
const SQLVALUE_TEXT = "text";
const SQLVALUE_TIME = "time";
const SQLVALUE_Y_N = "y-n";
// class-internal variables - do not change
public $mysql_link = 0; // mysql link resource
private $active_row = -1; // current row
private $error_desc = ""; // last mysql error string
private $error_number = 0; // last mysql error number
private $in_transaction = false; // used for transactions
private $last_insert_id; // last id of record inserted
private $last_result; // last mysql query result
private $last_sql = ""; // last mysql query
private $time_diff = 0; // holds the difference in time
private $time_start = 0; // start time for the timer
/**
* Determines if an error throws an exception
*
* @var boolean Set to true to throw error exceptions
*/
public $ThrowExceptions = false;
/**
* Constructor: Opens the connection to the database
*
* @param boolean $connect (Optional) Auto-connect when object is created
* @param string $database (Optional) Database name
* @param string $server (Optional) Host address
* @param string $username (Optional) User name
* @param string $password (Optional) Password
* @param string $charset (Optional) Character set
*/
public function __construct($connect = true, $database = null, $server = null,
$username = null, $password = null, $charset = null) {
if ($database !== null) $this->db_dbname = $database;
if ($server !== null) $this->db_host = $server;
if ($username !== null) $this->db_user = $username;
if ($password !== null) $this->db_pass = $password;
if ($charset !== null) $this->db_charset = $charset;
if (strlen($this->db_host) > 0 &&
strlen($this->db_user) > 0) {
if ($connect) $this->Open();
}
}
/**
* Destructor: Closes the connection to the database
*
*/
public function __destruct() {
$this->Close();
}
/**
* Automatically does an INSERT or UPDATE depending if an existing record
* exists in a table
*
* @param string $tableName The name of the table
* @param array $valuesArray An associative array containing the column
* names as keys and values as data. The values
* must be SQL ready (i.e. quotes around
* strings, formatted dates, ect)
* @param array $whereArray An associative array containing the column
* names as keys and values as data. The values
* must be SQL ready (i.e. quotes around strings,
* formatted dates, ect).
* @return boolean Returns TRUE on success or FALSE on error
*/
public function AutoInsertUpdate($tableName, $valuesArray, $whereArray) {
$this->ResetError();
$this->SelectRows($tableName, $whereArray);
if (! $this->Error()) {
if ($this->HasRecords()) {
return $this->UpdateRows($tableName, $valuesArray, $whereArray);
} else {
return $this->InsertRow($tableName, $valuesArray);
}
} else {
return false;
}
}
/**
* Returns true if the internal pointer is at the beginning of the records
*
* @return boolean TRUE if at the first row or FALSE if not
*/
public function BeginningOfSeek() {
$this->ResetError();
if ($this->IsConnected()) {
if ($this->active_row < 1) {
return true;
} else {
return false;
}
} else {
$this->SetError("No connection");
return false;
}
}
/**
* [STATIC] Builds a comma delimited list of columns for use with SQL
*
* @param array $valuesArray An array containing the column names.
* @param boolean $addQuotes (Optional) TRUE to add quotes
* @param boolean $showAlias (Optional) TRUE to show column alias
* @return string Returns the SQL column list
*/
static private function BuildSQLColumns($columns, $addQuotes = true, $showAlias = true, $addDoubleQuotes= true) {
if ($addQuotes) {
$quote = "`";
} else if($addDoubleQuotes){
$quote = "\"";
}
else{
$quote = "";
}
switch (gettype($columns)) {
case "array":
$sql = "";
foreach ($columns as $key => $value) {
// Build the columns
if (strlen($sql) == 0) {
$sql = $quote . $value . $quote;
} else {
$sql .= ", " . $quote . $value . $quote;
}
if ($showAlias && is_string($key) && (! empty($key))) {
$sql .= ' AS "' . $key . '"';
}
}
return $sql;
break;
case "string":
return $quote . $columns . $quote;
break;
default:
return false;
break;
}
}
/**
* [STATIC] Builds a SQL DELETE statement
*
* @param string $tableName The name of the table
* @param array $whereArray (Optional) An associative array containing the
* column names as keys and values as data. The
* values must be SQL ready (i.e. quotes around
* strings, formatted dates, ect). If not specified
* then all values in the table are deleted.
* @return string Returns the SQL DELETE statement
*/
static public function BuildSQLDelete($tableName, $whereArray = null) {
$sql = "DELETE FROM `" . $tableName . "`";
if (! is_null($whereArray)) {
$sql .= self::BuildSQLWhereClause($whereArray);
}
return $sql;
}
/**
* [STATIC] Builds a SQL INSERT statement
*
* @param string $tableName The name of the table
* @param array $valuesArray An associative array containing the column
* names as keys and values as data. The values
* must be SQL ready (i.e. quotes around
* strings, formatted dates, ect)
* @return string Returns a SQL INSERT statement
*/
static public function BuildSQLInsert($tableName, $valuesArray) {
$columns = self::BuildSQLColumns(array_keys($valuesArray));
$values = self::BuildSQLColumns($valuesArray, false, false);
$sql = "INSERT INTO `" . $tableName .
"` (" . $columns . ") VALUES (" . $values . ")";
return $sql;
}
/**
* Builds a simple SQL SELECT statement
*
* @param string $tableName The name of the table
* @param array $whereArray (Optional) An associative array containing the
* column names as keys and values as data. The
* values must be SQL ready (i.e. quotes around
* strings, formatted dates, ect)
* @param array/string $columns (Optional) The column or list of columns to select
* @param array/string $sortColumns (Optional) Column or list of columns to sort by
* @param boolean $sortAscending (Optional) TRUE for ascending; FALSE for descending
* This only works if $sortColumns are specified
* @param integer/string $limit (Optional) The limit of rows to return
* @return string Returns a SQL SELECT statement
*/
static public function BuildSQLSelect($tableName, $whereArray = null, $columns = null,
$sortColumns = null, $sortAscending = true, $limit = null) {
if (! is_null($columns)) {
$sql = self::BuildSQLColumns($columns);
} else {
$sql = "*";
}
$sql = "SELECT " . $sql . " FROM `" . $tableName . "`";
if (is_array($whereArray)) {
$sql .= self::BuildSQLWhereClause($whereArray);
}
if (! is_null($sortColumns)) {
$sql .= " ORDER BY " .
self::BuildSQLColumns($sortColumns, true, false) .
" " . ($sortAscending ? "ASC" : "DESC");
}
if (! is_null($limit)) {
$sql .= " LIMIT " . $limit;
}
return $sql;
}
/**
* [STATIC] Builds a SQL UPDATE statement
*
* @param string $tableName The name of the table
* @param array $valuesArray An associative array containing the column
* names as keys and values as data. The values
* must be SQL ready (i.e. quotes around
* strings, formatted dates, ect)
* @param array $whereArray (Optional) An associative array containing the
* column names as keys and values as data. The
* values must be SQL ready (i.e. quotes around
* strings, formatted dates, ect). If not specified
* then all values in the table are updated.
* @return string Returns a SQL UPDATE statement
*/
static public function BuildSQLUpdate($tableName, $valuesArray, $whereArray = null) {
$sql = "";
foreach ($valuesArray as $key => $value) {
if (strlen($sql) == 0) {
$sql = "`" . $key . "` = \"".$value."\"";
} else {
$sql .= ", `" . $key . "` = \"".$value."\"";
}
}
$sql = "UPDATE `" . $tableName . "` SET " . $sql;
if (is_array($whereArray)) {
$sql .= self::BuildSQLWhereClause($whereArray);
}
return $sql;
}
/**
* [STATIC] Builds a SQL WHERE clause from an array.
* If a key is specified, the key is used at the field name and the value
* as a comparison. If a key is not used, the value is used as the clause.
*
* @param array $whereArray An associative array containing the column
* names as keys and values as data. The values
* must be SQL ready (i.e. quotes around
* strings, formatted dates, ect)
* @return string Returns a string containing the SQL WHERE clause
*/
static public function BuildSQLWhereClause($whereArray) {
$where = "";
foreach ($whereArray as $key => $value) {
if (strlen($where) == 0) {
if (is_null($value)) {
$where = " WHERE `" . $key . "` IS NULL";
} else if (is_string($key)) {
$where = " WHERE `" . $key . "` = " . $value;
} else {
$where = " WHERE " . $value;
}
} else {
if (is_null($value)) {
$where = " AND `" . $key . "` IS NULL";
} else if (is_string($key)) {
$where .= " AND `" . $key . "` = " . $value;
} else {
$where .= " AND " . $value;
}
}
}
return $where;
}
/**
* Close current MySQL connection
*
* @return object Returns TRUE on success or FALSE on error
*/
public function Close() {
$this->ResetError();
$this->active_row = -1;
$success = $this->Release();
if ($success) {
$success = @mysqli_close($this->mysql_link);
if (! $success) {
$this->SetError();
} else {
unset($this->last_sql);
unset($this->last_result);
unset($this->mysql_link);
}
}
return $success;
}
/**
* Deletes rows in a table based on a WHERE filter
* (can be just one or many rows based on the filter)
*
* @param string $tableName The name of the table
* @param array $whereArray (Optional) An associative array containing the
* column names as keys and values as data. The
* values must be SQL ready (i.e. quotes around
* strings, formatted dates, ect). If not specified
* then all values in the table are deleted.
* @return boolean Returns TRUE on success or FALSE on error
*/
public function DeleteRows($tableName, $whereArray = null) {
$this->ResetError();
if (! $this->IsConnected()) {
$this->SetError("No connection");
return false;
} else {
$sql = self::BuildSQLDelete($tableName, $whereArray);
// Execute the UPDATE
if (! $this->Query($sql)) {
return false;
} else {
return true;
}
}
}
/**
* Returns true if the internal pointer is at the end of the records
*
* @return boolean TRUE if at the last row or FALSE if not
*/
public function EndOfSeek() {
$this->ResetError();
if ($this->IsConnected()) {
if ($this->active_row >= ($this->RowCount())) {
return true;
} else {
return false;
}
} else {
$this->SetError("No connection");
return false;
}
}
/**
* Returns the last MySQL error as text
*
* @return string Error text from last known error
*/
public function Error() {
$error = $this->error_desc;
if (empty($error)) {
if ($this->error_number <> 0) {
$error = "Unknown Error (#" . $this->error_number . ")";
} else {
$error = false;
}
} else {
if ($this->error_number > 0) {
$error .= " (#" . $this->error_number . ")";
}
}
return $error;
}
/**
* Returns the last MySQL error as a number
*
* @return integer Error number from last known error
*/
public function ErrorNumber() {
if (strlen($this->error_desc) > 0)
{
if ($this->error_number <> 0)
{
return $this->error_number;
} else {
return -1;
}
} else {
return $this->error_number;
}
}
/**
* [STATIC] Converts any value of any datatype into boolean (true or false)
*
* @param mixed $value Value to analyze for TRUE or FALSE
* @return boolean Returns TRUE or FALSE
*/
static public function GetBooleanValue($value) {
if (gettype($value) == "boolean") {
if ($value == true) {
return true;
} else {
return false;
}
} elseif (is_numeric($value)) {
if ($value > 0) {
return true;
} else {
return false;
}
} else {
$cleaned = strtoupper(trim($value));
if ($cleaned == "ON") {
return true;
} elseif ($cleaned == "SELECTED" || $cleaned == "CHECKED") {
return true;
} elseif ($cleaned == "YES" || $cleaned == "Y") {
return true;
} elseif ($cleaned == "TRUE" || $cleaned == "T") {
return true;
} else {
return false;
}
}
}
/**
* Returns the comments for fields in a table into an
* array or NULL if the table has not got any fields
*
* @param string $table Table name
* @return array An array that contains the column comments
*/
public function GetColumnComments($table) {
$this->ResetError();
$records = mysqli_query($this->mysql_link, "SHOW FULL COLUMNS FROM " . $table);
if (! $records) {
$this->SetError();
return false;
} else {
// Get the column names
$columnNames = $this->GetColumnNames($table);
if ($this->Error()) {
return false;
} else {
$index = 0;
// Fetchs the array to be returned (column 8 is field comment):
while ($array_data = mysqli_fetch_array($records)) {
$columns[$index] = $array_data[8];
$columns[$columnNames[$index++]] = $array_data[8];
}
return $columns;
}
}
}
/**
* This function returns the number of columns or returns FALSE on error
*
* @param string $table (Optional) If a table name is not specified, the
* column count is returned from the last query
* @return integer The total count of columns
*/
public function GetColumnCount($table = "") {
$this->ResetError();
if (empty($table)) {
$result = mysqli_field_count($this->mysql_link);
if (! $result) $this->SetError();
} else {
$records = mysqli_query($this->mysql_link, "SELECT * FROM " . $table . " LIMIT 1");
if (! $records) {
$this->SetError();
$result = false;
} else {
$result = mysqli_field_count($this->mysql_link);
$success = @mysqli_free_result($records);
if (! $success) {
$this->SetError();
$result = false;
}
}
}
return $result;
}
/**
* This function returns the data type for a specified column. If
* the column does not exists or no records exist, it returns FALSE
*
* @param string $column Column name or number (first column is 0)
* @param string $table (Optional) If a table name is not specified, the
* last returned records are used
* @return string MySQL data (field) type
*/
public function GetColumnDataType($column, $table = "") {
$this->ResetError();
if (empty($table)) {
if ($this->RowCount() > 0) {
if (is_numeric($column)) {
$field = mysqli_fetch_field_direct($this->last_result, $column);
return $field->type;
} else {
$field = mysqli_fetch_field_direct($this->last_result, $this->GetColumnID($column));
return $field->type;
}
} else {
return false;
}
} else {
if (is_numeric($column)) $column = $this->GetColumnName($column, $table);
$result = mysqli_query($this->mysql_link, "SELECT " . $column . " FROM " . $table . " LIMIT 1");
if (mysqli_field_count($this->mysql_link) > 0) {
$field = mysqli_fetch_field_direct($result, 0);
return $field->type;
} else {
$this->SetError("The specified column or table does not exist, or no data was returned", -1);
return false;
}
}
}
/**
* This function returns the position of a column
*
* @param string $column Column name
* @param string $table (Optional) If a table name is not specified, the
* last returned records are used.
* @return integer Column ID
*/
public function GetColumnID($column, $table = "") {
$this->ResetError();
$columnNames = $this->GetColumnNames($table);
if (! $columnNames) {
return false;
} else {
$index = 0;
$found = false;
foreach ($columnNames as $columnName) {
if ($columnName == $column) {
$found = true;
break;
}
$index++;
}
if ($found) {
return $index;
} else {
$this->SetError("Column name not found", -1);
return false;
}
}
}
/**
* This function returns the field length or returns FALSE on error
*
* @param string $column Column name
* @param string $table (Optional) If a table name is not specified, the
* last returned records are used.
* @return integer Field length
*/
public function GetColumnLength($column, $table = "") {
$this->ResetError();
if (empty($table)) {
if (is_numeric($column)) {
$columnID = $column;
} else {
$columnID = $this->GetColumnID($column);
}
if (! $columnID) {
return false;
} else {
$field = mysqli_fetch_field_direct($this->last_result, $columnID);
if (! $field) {
$this->SetError();
return false;
} else {
return $field->length;
}
}
} else {
$records = mysqli_query($this->mysql_link, "SELECT " . $column . " FROM " . $table . " LIMIT 1");
if (! $records) {
$this->SetError();
return false;
}
$field = mysqli_fetch_field_direct($records, 0);
if (! $field) {
$this->SetError();
return false;
} else {
return $field->length;
}
}
}
/**
* This function returns the name for a specified column number. If
* the index does not exists or no records exist, it returns FALSE
*
* @param string $columnID Column position (0 is the first column)
* @param string $table (Optional) If a table name is not specified, the
* last returned records are used.
* @return integer Field Length
*/
public function GetColumnName($columnID, $table = "") {
$this->ResetError();
$result = false;
if (empty($table)) {
if ($this->RowCount() > 0) {
$field = mysqli_fetch_field_direct($this->last_result, $columnID);
if (! $field) {
$result = false;
$this->SetError();
} else {
$result = $field->name;
}
} else {
$result = false;
}
} else {
$records = mysqli_query($this->mysql_link, "SELECT * FROM " . $table . " LIMIT 1");
if (! $records) {
$this->SetError();
$result = false;
} else {
if (mysqli_field_count($this->mysql_link) > 0) {
$field = mysqli_fetch_field_direct($records, $columnID);
if (! $field) {
$result = false;
$this->SetError();
} else {
$result = $field->name;
}
} else {
$result = false;
}
}
}
return $result;
}
/**
* Returns the field names in a table or query in an array
*
* @param string $table (Optional) If a table name is not specified, the
* last returned records are used
* @return array An array that contains the column names
*/
public function GetColumnNames($table = "") {
$this->ResetError();
if (empty($table)) {
$columnCount = mysqli_field_count($this->mysql_link);
if (! $columnCount) {
$this->SetError();
$columns = false;
} else {
for ($column = 0; $column < $columnCount; $column++) {
$field = mysqli_fetch_field_direct($this->last_result, $column);
$columns[] = $field->name;
}
}
} else {
$result = mysqli_query($this->mysql_link, "SHOW COLUMNS FROM " . $table);
if (! $result) {
$this->SetError();
$columns = false;
} else {
while ($array_data = mysqli_fetch_array($result)) {
$columns[] = $array_data[0];
}
}
}
// Returns the array
return $columns;
}
/**
* This function returns the last query as an HTML table
*
* @param boolean $showCount (Optional) TRUE if you want to show the row count,
* FALSE if you do not want to show the count
* @param string $styleTable (Optional) Style information for the table
* @param string $styleHeader (Optional) Style information for the header row
* @param string $styleData (Optional) Style information for the cells
* @return string HTML containing a table with all records listed
*/
public function GetHTML($showCount = true, $styleTable = null, $styleHeader = null, $styleData = null) {
if ($styleTable === null) {
$tb = "border-collapse:collapse;empty-cells:show";
} else {
$tb = $styleTable;
}
if ($styleHeader === null) {
$th = "border-width:1px;border-style:solid;background-color:navy;color:white";
} else {
$th = $styleHeader;
}
if ($styleData === null) {
$td = "border-width:1px;border-style:solid";
} else {
$td = $styleData;
}
if ($this->last_result) {
if ($this->RowCount() > 0) {
$html = "";
if ($showCount) $html = "Record Count: " . $this->RowCount() . "<br />\n";
$html .= "<table style=\"$tb\" cellpadding=\"2\" cellspacing=\"2\">\n";
$this->MoveFirst();
$header = false;
while ($member = mysqli_fetch_object($this->last_result)) {
if (!$header) {
$html .= "\t<tr>\n";
foreach ($member as $key => $value) {
$html .= "\t\t<td style=\"$th\"><strong>" . htmlspecialchars($key) . "</strong></td>\n";
}
$html .= "\t</tr>\n";
$header = true;
}
$html .= "\t<tr>\n";
foreach ($member as $key => $value) {
$html .= "\t\t<td style=\"$td\">" . htmlspecialchars($value) . "</td>\n";
}
$html .= "\t</tr>\n";
}
$this->MoveFirst();
$html .= "</table>";
} else {
$html = "No records were returned.";
}
} else {
$this->active_row = -1;
$html = false;
}
return $html;
}
/**
* Returns the last query as a JSON document
*
* @return string JSON containing all records listed
*/
public function GetJSON() {
if ($this->last_result) {
if ($this->RowCount() > 0) {
for ($i = 0, $il = mysqli_field_count($this->mysql_link); $i < $il; $i++) {
$field = mysqli_fetch_field_direct($this->last_result, $i);
$types[$i] = $field->type;
}
$json = '[';
$this->MoveFirst();
while ($member = mysqli_fetch_object($this->last_result)) {
$json .= json_encode($member) . ",";
}
$json .= ']';
$json = str_replace("},]", "}]", $json);
} else {
$json = 'null';
}
} else {
$this->active_row = -1;
$json = 'null';
}
return $json;
}
/**
* Returns the last autonumber ID field from a previous INSERT query
*
* @return integer ID number from previous INSERT query
*/
public function GetLastInsertID() {
return $this->last_insert_id;
}
/**
* Returns the last SQL statement executed
*
* @return string Current SQL query string
*/
public function GetLastSQL() {
return $this->last_sql;
}
/**
* This function returns table names from the database
* into an array. If the database does not contains
* any tables, the returned value is FALSE
*
* @return array An array that contains the table names
*/
public function GetTables() {
$this->ResetError();
// Query to get the tables in the current database:
$records = mysqli_query($this->mysql_link, "SHOW TABLES");
if (! $records) {
$this->SetError();
return FALSE;
} else {
while ($array_data = mysqli_fetch_array($records)) {
$tables[] = $array_data[0];
}
// Returns the array or NULL
if (count($tables) > 0) {
return $tables;
} else {
return FALSE;
}
}
}
/**
* Returns the last query as an XML Document
*
* @return string XML containing all records listed
*/
public function GetXML() {
// Create a new XML document
$doc = new DomDocument('1.0'); // ,'UTF-8');
// Create the root node
$root = $doc->createElement('root');
$root = $doc->appendChild($root);
// If there was a result set
if (is_resource($this->last_result)) {
// Show the row count and query
$root->setAttribute('rows',
($this->RowCount() ? $this->RowCount() : 0));
$root->setAttribute('query', $this->last_sql);
$root->setAttribute('error', "");
// process one row at a time
$rowCount = 0;
while ($row = mysqli_fetch_assoc($this->last_result)) {
// Keep the row count
$rowCount = $rowCount + 1;
// Add node for each row
$element = $doc->createElement('row');
$element = $root->appendChild($element);
$element->setAttribute('index', $rowCount);
// Add a child node for each field
foreach ($row as $fieldname => $fieldvalue) {
$child = $doc->createElement($fieldname);
$child = $element->appendChild($child);
// $fieldvalue = iconv("ISO-8859-1", "UTF-8", $fieldvalue);
$fieldvalue = htmlspecialchars($fieldvalue);
$value = $doc->createTextNode($fieldvalue);
$value = $child->appendChild($value);
} // foreach
} // while
} else {
// Process any errors
$root->setAttribute('rows', 0);
$root->setAttribute('query', $this->last_sql);
if ($this->Error()) {
$root->setAttribute('error', $this->Error());
} else {
$root->setAttribute('error', "No query has been executed.");
}
}
// Show the XML document
return $doc->saveXML();
}
/**
* Determines if a query contains any rows
*
* @param string $sql [Optional] If specified, the query is first executed
* Otherwise, the last query is used for comparison
* @return boolean TRUE if records exist, FALSE if not or query error
*/
public function HasRecords($sql = "") {
if (strlen($sql) > 0) {
$this->Query($sql);
if ($this->Error()) return false;
}
if ($this->RowCount() > 0) {
return true;
} else {
return false;
}
}
/**
* Inserts a row into a table in the connected database
*
* @param string $tableName The name of the table
* @param array $valuesArray An associative array containing the column
* names as keys and values as data. The values
* must be SQL ready (i.e. quotes around
* strings, formatted dates, ect)
* @return integer Returns last insert ID on success or FALSE on failure
*/
public function InsertRow($tableName, $valuesArray) {
$this->ResetError();
if (! $this->IsConnected()) {
$this->SetError("No connection");
return false;
} else {
// Execute the query
$sql = self::BuildSQLInsert($tableName, $valuesArray);
if (! $this->Query($sql)) {
return false;
} else {
return $this->GetLastInsertID();
}
}
}
/**
* Determines if a valid connection to the database exists
*
* @return boolean TRUE idf connectect or FALSE if not connected
*/
public function IsConnected() {
if (is_object($this->mysql_link)) {
return true;
} else {
return false;
}
}
/**
* [STATIC] Determines if a value of any data type is a date PHP can convert
*
* @param date/string $value
* @return boolean Returns TRUE if value is date or FALSE if not date
*/
static public function IsDate($value) {
$date = date('Y', strtotime($value));
if ($date == "1969" || $date == '') {
return false;
} else {
return true;
}
}
/**
* Stop executing (die/exit) and show last MySQL error message
*
*/
public function Kill($message = "") {
if (strlen($message) > 0) {
exit($message);
} else {
exit($this->Error());
}
}
/**
* Seeks to the beginning of the records
*
* @return boolean Returns TRUE on success or FALSE on error
*/
public function MoveFirst() {
$this->ResetError();
if (! $this->Seek(0)) {
$this->SetError();
return false;
} else {
$this->active_row = 0;
return true;
}
}
/**
* Seeks to the end of the records
*
* @return boolean Returns TRUE on success or FALSE on error
*/
public function MoveLast() {
$this->ResetError();
$this->active_row = $this->RowCount() - 1;
if (! $this->Error()) {
if (! $this->Seek($this->active_row)) {
return false;
} else {
return true;
}
} else {
return false;
}
}
/**
* Connect to specified MySQL server
*
* @param string $database (Optional) Database name
* @param string $server (Optional) Host address
* @param string $username (Optional) User name
* @param string $password (Optional) Password
* @param string $charset (Optional) Character set
* @param boolean $pcon (Optional) Persistant connection
* @return boolean Returns TRUE on success or FALSE on error
*/
public function Open($database = null, $server = null, $username = null,
$password = null, $charset = null, $pcon = false) {
$this->ResetError();
// Use defaults?
if ($database !== null) $this->db_dbname = $database;
if ($server !== null) $this->db_host = $server;
if ($username !== null) $this->db_user = $username;
if ($password !== null) $this->db_pass = $password;
if ($charset !== null) $this->db_charset = $charset;
if (is_bool($pcon)) $this->db_pcon = $pcon;
$this->active_row = -1;
// Open persistent or normal connection
if ($pcon) {
$this->mysql_link = @mysqli_pconnect(
'p:' . $this->db_host, $this->db_user, $this->db_pass);
} else {
$this->mysql_link = @mysqli_connect (
$this->db_host, $this->db_user, $this->db_pass);
}
// Connect to mysql server failed?
if (! $this->IsConnected()) {
$this->SetError();
return false;
} else {
// Select a database (if specified)
if (strlen($this->db_dbname) > 0) {
if (strlen($this->db_charset) == 0) {
if (! $this->SelectDatabase($this->db_dbname)) {
return false;
} else {
return true;
}
} else {
if (! $this->SelectDatabase(
$this->db_dbname, $this->db_charset)) {
return false;
} else {
return true;
}
}
} else {
return true;
}
}
}
/**
* Executes the given SQL query and returns the records
*
* @param string $sql The query string should not end with a semicolon
* @return object PHP 'mysql result' resource object containing the records
* on SELECT, SHOW, DESCRIBE or EXPLAIN queries and returns;
* TRUE or FALSE for all others i.e. UPDATE, DELETE, DROP
* AND FALSE on all errors (setting the local Error message)
*/
public function Query($sql) {
$this->ResetError();
$this->last_sql = $sql;
$this->last_result = @mysqli_query($this->mysql_link, $sql);
if(! $this->last_result) {
$this->active_row = -1;
$this->SetError();
return false;
} else {
if (strpos(strtolower($sql), "insert") === 0) {
$this->last_insert_id = mysqli_insert_id($this->mysql_link);
if ($this->last_insert_id === false) {
$this->SetError();
return false;
} else {
$numrows = 0;
$this->active_row = -1;
return $this->last_result;
}
} else if(strpos(strtolower($sql), "select") === 0) {
$numrows = mysqli_field_count($this->mysql_link);
if ($numrows > 0) {
$this->active_row = 0;
} else {
$this->active_row = -1;
}
$this->last_insert_id = 0;
return $this->last_result;
} else {
return $this->last_result;
}
}
}
/**
* Executes the given SQL query and returns a multi-dimensional array
*
* @param string $sql The query string should not end with a semicolon
* @param integer $resultType (Optional) The type of array
* Values can be: MYSQLI_ASSOC, MYSQLI_NUM, MYSQLI_BOTH
* @return array A multi-dimensional array containing all the data
* returned from the query or FALSE on all errors
*/
public function QueryArray($sql, $resultType = MYSQLI_BOTH) {
$this->Query($sql);
if (! $this->Error()) {
return $this->RecordsArray($resultType);
} else {
return false;
}
}
/**
* Executes the given SQL query and returns only one (the first) row
*
* @param string $sql The query string should not end with a semicolon
* @return object PHP resource object containing the first row or
* FALSE if no row is returned from the query
*/
public function QuerySingleRow($sql) {
$this->Query($sql);
if ($this->RowCount() > 0) {
return $this->Row();
} else {
return false;
}
}
/**
* Executes the given SQL query and returns the first row as an array
*
* @param string $sql The query string should not end with a semicolon
* @param integer $resultType (Optional) The type of array
* Values can be: MYSQLI_ASSOC, MYSQLI_NUM, MYSQLI_BOTH
* @return array An array containing the first row or FALSE if no row
* is returned from the query
*/
public function QuerySingleRowArray($sql, $resultType = MYSQLI_BOTH) {
$this->Query($sql);
if ($this->RowCount() > 0) {
return $this->RowArray(null, $resultType);
} else {
return false;
}
}
/**
* Executes a query and returns a single value. If more than one row
* is returned, only the first value in the first column is returned.
*
* @param string $sql The query string should not end with a semicolon
* @return mixed The value returned or FALSE if no value
*/
public function QuerySingleValue($sql) {
$this->Query($sql);
if ($this->RowCount() > 0 && $this->GetColumnCount() > 0) {
$row = $this->RowArray(null, MYSQLI_NUM);
return $row[0];
} else {
return false;
}
}
/**
* Executes the given SQL query, measures it, and saves the total duration
* in microseconds
*
* @param string $sql The query string should not end with a semicolon
* @return object PHP 'mysql result' resource object containing the records
* on SELECT, SHOW, DESCRIBE or EXPLAIN queries and returns
* TRUE or FALSE for all others i.e. UPDATE, DELETE, DROP
*/
public function QueryTimed($sql) {
$this->TimerStart();
$result = $this->Query($sql);
$this->TimerStop();
return $result;
}
/**
* Returns the records from the last query
*
* @return object PHP 'mysql result' resource object containing the records
* for the last query executed
*/
public function Records() {
return $this->last_result;
}
/**
* Returns all records from last query and returns contents as array
* or FALSE on error
*
* @param integer $resultType (Optional) The type of array
* Values can be: MYSQLI_ASSOC, MYSQLI_NUM, MYSQLI_BOTH
* @return Records in array form
*/
public function RecordsArray($resultType = MYSQLI_BOTH) {
$this->ResetError();
if ($this->last_result) {
if (! mysqli_data_seek($this->last_result, 0)) {
$this->SetError();
return false;
} else {
//while($member = mysqli_fetch_object($this->last_result)){
while ($member = mysqli_fetch_array($this->last_result, $resultType)){
$members[] = $member;
}
mysqli_data_seek($this->last_result, 0);
$this->active_row = 0;
return $members;
}
} else {
$this->active_row = -1;
$this->SetError("No query results exist", -1);
return false;
}
}
/**
* Frees memory used by the query results and returns the function result
*
* @return boolean Returns TRUE on success or FALSE on failure
*/
public function Release() {
$this->ResetError();
if (! $this->last_result) {
$success = true;
} else {
$success = @mysqli_free_result($this->last_result);
if (! $success) $this->SetError();
}
return $success;
}
/**
* Clears the internal variables from any error information
*
*/
private function ResetError() {
$this->error_desc = '';
$this->error_number = 0;
}
/**
* Reads the current row and returns contents as a
* PHP object or returns false on error
*
* @param integer $optional_row_number (Optional) Use to specify a row
* @return object PHP object or FALSE on error
*/
public function Row($optional_row_number = null) {
$this->ResetError();
if (! $this->last_result) {
$this->SetError("No query results exist", -1);
return false;
} elseif ($optional_row_number === null) {
if (($this->active_row) > $this->RowCount()) {
$this->SetError("Cannot read past the end of the records", -1);
return false;
} else {
$this->active_row++;
}
} else {
if ($optional_row_number >= $this->RowCount()) {
$this->SetError("Row number is greater than the total number of rows", -1);
return false;
} else {
$this->active_row = $optional_row_number;
$this->Seek($optional_row_number);
}
}
$row = mysqli_fetch_object($this->last_result);
if (! $row) {
$this->SetError();
return false;
} else {
return $row;
}
}
/**
* Reads the current row and returns contents as an
* array or returns false on error
*
* @param integer $optional_row_number (Optional) Use to specify a row
* @param integer $resultType (Optional) The type of array
* Values can be: MYSQLI_ASSOC, MYSQLI_NUM, MYSQLI_BOTH
* @return array Array that corresponds to fetched row or FALSE if no rows
*/
public function RowArray($optional_row_number = null, $resultType = MYSQLI_BOTH) {
$this->ResetError();
if (! $this->last_result) {
$this->SetError("No query results exist", -1);
return false;
} elseif ($optional_row_number === null) {
if (($this->active_row) > $this->RowCount()) {
$this->SetError("Cannot read past the end of the records", -1);
return false;
} else {
$this->active_row++;
}
} else {
if ($optional_row_number >= $this->RowCount()) {
$this->SetError("Row number is greater than the total number of rows", -1);
return false;
} else {
$this->active_row = $optional_row_number;
$this->Seek($optional_row_number);
}
}
$row = mysqli_fetch_array($this->last_result, $resultType);
if (! $row) {
$this->SetError();
return false;
} else {
return $row;
}
}
/**
* Returns the last query row count
*
* @return integer Row count or FALSE on error
*/
public function RowCount() {
$this->ResetError();
if (! $this->IsConnected()) {
$this->SetError("No connection", -1);
return false;
} elseif (! $this->last_result) {
$this->SetError("No query results exist", -1);
return false;
} else {
$result = @mysqli_affected_rows($this->mysql_link);
if (! $result) {
$this->SetError();
return false;
} else {
return $result;
}
}
}
/**
* Sets the internal database pointer to the
* specified row number and returns the result
*
* @param integer $row_number Row number
* @return object Fetched row as PHP object
*/
public function Seek($row_number) {
$this->ResetError();
$row_count = $this->RowCount();
if (! $row_count) {
return false;
} elseif ($row_number >= $row_count) {
$this->SetError("Seek parameter is greater than the total number of rows", -1);
return false;
} else {
$this->active_row = $row_number;
$result = mysqli_data_seek($this->last_result, $row_number);
if (! $result) {
$this->SetError();
return false;
} else {
$record = mysqli_fetch_row($this->last_result);
if (! $record) {
$this->SetError();
return false;
} else {
// Go back to the record after grabbing it
mysqli_data_seek($this->last_result, $row_number);
return $record;
}
}
}
}
/**
* Returns the current cursor row location
*
* @return integer Current row number
*/
public function SeekPosition() {
return $this->active_row;
}
/**
* Selects a different database and character set
*
* @param string $database Database name
* @param string $charset (Optional) Character set (i.e. utf8)
* @return boolean Returns TRUE on success or FALSE on error
*/
public function SelectDatabase($database, $charset = "") {
$return_value = true;
if (! $charset) $charset = $this->db_charset;
$this->ResetError();
if (! (mysqli_select_db($this->mysql_link, $database))) {
$this->SetError();
$return_value = false;
} else {
if ((strlen($charset) > 0)) {
if (! (mysqli_query($this->mysql_link, "SET CHARACTER SET '{$charset}'"))) {
$this->SetError();
$return_value = false;
}
}
}
return $return_value;
}
/**
* Gets rows in a table based on a WHERE filter
*
* @param string $tableName The name of the table
* @param array $whereArray (Optional) An associative array containing the
* column names as keys and values as data. The
* values must be SQL ready (i.e. quotes around
* strings, formatted dates, ect)
* @param array/string $columns (Optional) The column or list of columns to select
* @param array/string $sortColumns (Optional) Column or list of columns to sort by
* @param boolean $sortAscending (Optional) TRUE for ascending; FALSE for descending
* This only works if $sortColumns are specified
* @param integer/string $limit (Optional) The limit of rows to return
* @return boolean Returns records on success or FALSE on error
*/
public function SelectRows($tableName, $whereArray = null, $columns = null,
$sortColumns = null, $sortAscending = true,
$limit = null) {
$this->ResetError();
if (! $this->IsConnected()) {
$this->SetError("No connection");
return false;
} else {
$sql = self::BuildSQLSelect($tableName, $whereArray,
$columns, $sortColumns, $sortAscending, $limit);
// Execute the UPDATE
if (! $this->Query($sql)) {
return $this->last_result;
} else {
return true;
}
}
}
/**
* Retrieves all rows in a specified table
*
* @param string $tableName The name of the table
* @return boolean Returns records on success or FALSE on error
*/
public function SelectTable($tableName) {
return $this->SelectRows($tableName);
}
/**
* Sets the local variables with the last error information
*
* @param string $errorMessage The error description
* @param integer $errorNumber The error number
*/
private function SetError($errorMessage = "", $errorNumber = 0) {
try {
if (strlen($errorMessage) > 0) {
$this->error_desc = $errorMessage;
} else {
if ($this->IsConnected()) {
$this->error_desc = mysqli_error($this->mysql_link);
} else {
$this->error_desc = mysqli_connect_error();
}
}
if ($errorNumber <> 0) {
$this->error_number = $errorNumber;
} else {
if ($this->IsConnected()) {
$this->error_number = @mysqli_errno($this->mysql_link);
} else {
$this->error_number = @mysqli_connect_errno();
}
}
} catch(Exception $e) {
$this->error_desc = $e->getMessage();
$this->error_number = -999;
}
if ($this->ThrowExceptions) {
if (isset($this->error_desc) && $this->error_desc != NULL) {
throw new Exception($this->error_desc . ' (' . __LINE__ . ')');
}
}
}
/**
* [STATIC] Converts a boolean into a formatted TRUE or FALSE value of choice
*
* @param mixed $value value to analyze for TRUE or FALSE
* @param mixed $trueValue value to use if TRUE
* @param mixed $falseValue value to use if FALSE
* @param string $datatype Use SQLVALUE constants or the strings:
* string, text, varchar, char, boolean, bool,
* Y-N, T-F, bit, date, datetime, time, integer,
* int, number, double, float
* @return string SQL formatted value of the specified data type
*/
static public function SQLBooleanValue($value, $trueValue, $falseValue, $datatype = self::SQLVALUE_TEXT) {
if (self::GetBooleanValue($value)) {
$return_value = self::SQLValue($trueValue, $datatype);
} else {
$return_value = self::SQLValue($falseValue, $datatype);
}
return $return_value;
}
/**
* Returns string suitable for SQL
* NOTE: This is no longer a static call because of a conflict with mysqli_real_escape_string.
* Also, please note that the SQLUnfix function was removed for compatibility.
*
* @param string $value
* @return string SQL formatted value
*/
public function SQLFix($value) {
return @mysqli_real_escape_string($this->mysql_link, $value);
}
/**
* [STATIC] Formats any value into a string suitable for SQL statements
* (NOTE: Also supports data types returned from the gettype function)
*
* @param mixed $value Any value of any type to be formatted to SQL
* @param string $datatype Use SQLVALUE constants or the strings:
* string, text, varchar, char, boolean, bool,
* Y-N, T-F, bit, date, datetime, time, integer,
* int, number, double, float
* @return string
*/
static public function SQLValue($value, $datatype = self::SQLVALUE_TEXT) {
$return_value = "";
switch (strtolower(trim($datatype))) {
case "text":
case "string":
case "varchar":
case "char":
if (strlen($value) == 0) {
$return_value = "NULL";
} else {
if (get_magic_quotes_gpc()) {
$value = stripslashes($value);
}
$return_value = "'" . str_replace("'", "''", $value) . "'";
}
break;
case "number":
case "integer":
case "int":
case "double":
case "float":
if (is_numeric($value)) {
$return_value = $value;
} else {
$return_value = "NULL";
}
break;
case "boolean": //boolean to use this with a bit field
case "bool":
case "bit":
if (self::GetBooleanValue($value)) {
$return_value = "1";
} else {
$return_value = "0";
}
break;
case "y-n": //boolean to use this with a char(1) field
if (self::GetBooleanValue($value)) {
$return_value = "'Y'";
} else {
$return_value = "'N'";
}
break;
case "t-f": //boolean to use this with a char(1) field
if (self::GetBooleanValue($value)) {
$return_value = "'T'";
} else {
$return_value = "'F'";
}
break;
case "date":
if (self::IsDate($value)) {
$return_value = "'" . date('Y-m-d', strtotime($value)) . "'";
} else {
$return_value = "NULL";
}
break;
case "datetime":
if (self::IsDate($value)) {
$return_value = "'" . date('Y-m-d H:i:s', strtotime($value)) . "'";
} else {
$return_value = "NULL";
}
break;
case "time":
if (self::IsDate($value)) {
$return_value = "'" . date('H:i:s', strtotime($value)) . "'";
} else {
$return_value = "NULL";
}
break;
default:
exit("ERROR: Invalid data type specified in SQLValue method");
}
return $return_value;
}
/**
* Returns last measured duration (time between TimerStart and TimerStop)
*
* @param integer $decimals (Optional) The number of decimal places to show
* @return Float Microseconds elapsed
*/
public function TimerDuration($decimals = 4) {
return number_format($this->time_diff, $decimals);
}
/**
* Starts time measurement (in microseconds)
*
*/
public function TimerStart() {
$parts = explode(" ", microtime());
$this->time_diff = 0;
$this->time_start = $parts[1].substr($parts[0],1);
}
/**
* Stops time measurement (in microseconds)
*
*/
public function TimerStop() {
$parts = explode(" ", microtime());
$time_stop = $parts[1].substr($parts[0],1);
$this->time_diff = ($time_stop - $this->time_start);
$this->time_start = 0;
}
/**
* Starts a transaction
*
* @return boolean Returns TRUE on success or FALSE on error
*/
public function TransactionBegin() {
$this->ResetError();
if (! $this->IsConnected()) {
$this->SetError("No connection");
return false;
} else {
if (! $this->in_transaction) {
if (! mysqli_query($this->mysql_link, "START TRANSACTION")) {
$this->SetError();
return false;
} else {
$this->in_transaction = true;
return true;
}
} else {
$this->SetError("Already in transaction", -1);
return false;
}
}
}
/**
* Ends a transaction and commits the queries
*
* @return boolean Returns TRUE on success or FALSE on error
*/
public function TransactionEnd() {
$this->ResetError();
if (! $this->IsConnected()) {
$this->SetError("No connection");
return false;
} else {
if ($this->in_transaction) {
if (! mysqli_query($this->mysql_link, "COMMIT")) {
// $this->TransactionRollback();
$this->SetError();
return false;
} else {
$this->in_transaction = false;
return true;
}
} else {
$this->SetError("Not in a transaction", -1);
return false;
}
}
}
/**
* Rolls the transaction back
*
* @return boolean Returns TRUE on success or FALSE on failure
*/
public function TransactionRollback() {
$this->ResetError();
if (! $this->IsConnected()) {
$this->SetError("No connection");
return false;
} else {
if(! mysqli_query($this->mysql_link, "ROLLBACK")) {
$this->SetError("Could not rollback transaction");
return false;
} else {
$this->in_transaction = false;
return true;
}
}
}
/**
* Truncates a table removing all data
*
* @param string $tableName The name of the table
* @return boolean Returns TRUE on success or FALSE on error
*/
public function TruncateTable($tableName) {
$this->ResetError();
if (! $this->IsConnected()) {
$this->SetError("No connection");
return false;
} else {
$sql = "TRUNCATE TABLE `" . $tableName . "`";
if (! $this->Query($sql)) {
return false;
} else {
return true;
}
}
}
/**
* Updates rows in a table based on a WHERE filter
* (can be just one or many rows based on the filter)
*
* @param string $tableName The name of the table
* @param array $valuesArray An associative array containing the column
* names as keys and values as data. The values
* must be SQL ready (i.e. quotes around
* strings, formatted dates, ect)
* @param array $whereArray (Optional) An associative array containing the
* column names as keys and values as data. The
* values must be SQL ready (i.e. quotes around
* strings, formatted dates, ect). If not specified
* then all values in the table are updated.
* @return boolean Returns TRUE on success or FALSE on error
*/
public function UpdateRows($tableName, $valuesArray, $whereArray = null) {
$this->ResetError();
if (! $this->IsConnected()) {
$this->SetError("No connection");
return false;
} else {
$sql = self::BuildSQLUpdate($tableName, $valuesArray, $whereArray);
// Execute the UPDATE
if (! $this->Query($sql)) {
return false;
} else {
return true;
}
}
}
}
?> |