last_error = $err_str; // Capture all errors to an error array no matter what happens $this->captured_errors[] = array ('error_str' => $err_str, 'query' => $this->last_query); } ## Show Errors function show_errors() { $this->show_errors = true; } ## Hide Errors function hide_errors() { $this->show_errors = false; } ## Kill cached query results function flush() { // Get rid of these $this->last_result = null; $this->col_info = null; $this->last_query = null; } ## Get one variable from the DB - see docs for more detail function get_var($query=null,$x=0,$y=0) { // Log how the function was called $this->func_call = "\$db->get_var(\"$query\",$x,$y)"; // If there is a query then perform it if not then use cached results.. if ($query) { $this->query($query); } // Extract var out of cached results based x,y vals if ($this->last_result[$y]){ $values = array_values(get_object_vars($this->last_result[$y])); } // If there is a value return it else return null return (isset($values[$x]) && $values[$x]!=='')?$values[$x]:null; } ## Get one row from the DB - see docs for more detail function get_row($query=null,$output=OBJECT,$y=0) { // Log how the function was called $this->func_call = "\$db->get_row(\"$query\",$output,$y)"; // If there is a query then perform it if not then use cached results.. if ($query) { $this->query($query); } // If the output is an object then return object using the row offset.. if ($output == OBJECT) { return $this->last_result[$y]?$this->last_result[$y]:null; // If the output is an associative array then return row as such.. } elseif ($output == ARRAY_A) { return $this->last_result[$y]?get_object_vars($this->last_result[$y]):null; // If the output is an numerical array then return row as such.. } elseif ($output == ARRAY_N) { return $this->last_result[$y]?array_values(get_object_vars($this->last_result[$y])):null; // If invalid output type was specified.. } else { $this->print_error(" \$db->get_row(string query, output type, int offset) -- Output type must be one of: OBJECT, ARRAY_A, ARRAY_N"); } } ## Function to get 1 column from the cached result set based in X index see docs for usage and info function get_col($query=null,$x=0) { // If there is a query then perform it if not then use cached results.. if ($query) { $this->query($query); } // Extract the column values for ($i=0; $i < count($this->last_result); $i++) { $new_array[$i] = $this->get_var(null,$x,$i); } return $new_array; } ## Return the the query as a result set - see docs for more details function get_results($query=null, $output = OBJECT) { // Log how the function was called $this->func_call = "\$db->get_results(\"$query\", $output)"; // If there is a query then perform it if not then use cached results.. if ($query) { $this->query($query); } // Send back array of objects. Each row is an object if ($output == OBJECT) { return $this->last_result; } elseif ($output == ARRAY_A || $output == ARRAY_N) { if ($this->last_result) { $i=0; foreach($this->last_result as $row) { $new_array[$i] = get_object_vars($row); if ($output == ARRAY_N) { $new_array[$i] = array_values($new_array[$i]); } $i++; } return $new_array; } else { return null; } } } ## Function to get column meta data info pertaining to the last query see docs for more info and usage function get_col_info($info_type="name",$col_offset=-1) { if ($this->col_info) { if ($col_offset == -1) { $i=0; foreach($this->col_info as $col) { $new_array[$i] = $col->{$info_type}; $i++; } return $new_array; } else { return $this->col_info[$col_offset]->{$info_type}; } } } ## Dumps the contents of any input variable to screen in a nicely formatted and easy to understand way - any type: Object, Var or Array function vardump($mixed='') { echo "

"; echo "
";
		if (!$this->vardump_called) {
			echo "ezSQL (v".EZSQL_VERSION.") Variable Dump..\n\n";
		}
		$var_type = gettype ($mixed);
		print_r(($mixed?$mixed:"No Value / False"));
		echo "\n\nType: " . ucfirst($var_type) . "\n";
		echo "Last Query [$this->num_queries]: ".($this->last_query?$this->last_query:"NULL")."\n";
		echo "Last Function Call: " . ($this->func_call?$this->func_call:"None")."\n";
		echo "Last Rows Returned: ".count($this->last_result)."\n";
		echo "
".$this->donation(); echo "\n

"; $this->vardump_called = true; } ## Alias for the above function function dumpvar($mixed) { $this->vardump($mixed); } ## Displays the last query string that was sent to the database & a table listing results (if there were any). (abstracted into a seperate file to save server overhead). function debug() { echo "
"; // Only show ezSQL credits once.. if (!$this->debug_called) { echo "ezSQL (v".EZSQL_VERSION.") Debug..

\n"; } if ($this->last_error) { echo "Last Error -- [$this->last_error]

"; } echo "Query [$this->num_queries] -- "; echo "[$this->last_query]

"; echo "Query Result.."; echo "

"; if ($this->col_info) { // Results top rows echo ""; echo ""; for ($i=0; $i < count($this->col_info); $i++) { echo ""; } echo ""; // print main results if ($this->last_result) { $i=0; foreach ($this->get_results(null,ARRAY_N) as $one_row) { $i++; echo ""; foreach ($one_row as $item) { echo ""; } echo ""; } } else { echo ""; } echo "
(row){$this->col_info[$i]->type} {$this->col_info[$i]->max_length}
{$this->col_info[$i]->name}
$i$item
No Results
"; } else { echo "No Results"; } echo "
".$this->donation()."
"; $this->debug_called = true; } ## Naughty little function to ask for some remuniration! function donation() { return "If ezSQL has helped make a donation!?   "; } } ### ezSQL MYSQL Class Variables $ezsql_mysql_str = array ( 1 => 'Require $dbuser and $dbpassword to connect to a database server', 2 => 'Error establishing mySQL database connection. Correct user/password? Correct hostname? Database server running?', 3 => 'Require $dbname to select a database', 4 => 'mySQL database connection is not active', 5 => 'Unexpected error while trying to select database' ); if ( ! function_exists ('mysql_connect') ) die('Fatal Error: ezSQL_mysql requires mySQL Lib to be compiled and or linked in to the PHP engine'); if ( ! class_exists ('ezSQLcore') ) die('Fatal Error: ezSQL_mysql requires ezSQLcore (ez_sql_core.php) to be included/loaded before it can be used'); ### ezSQL MYSQL Class class ezSQL_mysql extends ezSQLcore { ## Constructor - allow the user to perform a qucik connect at the same time as initialising the ezSQL_mysql class function ezSQL_mysql($dbuser='', $dbpassword='', $dbname='', $dbhost='localhost') { if ($dbuser && $dbname) { $this->quick_connect($dbuser, $dbpassword, $dbname, $dbhost); } } ## Short hand way to connect to mySQL database server and select a mySQL database at the same time function quick_connect($dbuser='', $dbpassword='', $dbname='', $dbhost='localhost') { $return_val = false; if ( ! $this->connect($dbuser, $dbpassword, $dbhost,true) ) ; else if ( ! $this->select($dbname) ) ; else $return_val = true; return $return_val; } ## Try to connect to mySQL database server function connect($dbuser='', $dbpassword='', $dbhost='localhost'){ global $ezsql_mysql_str; $return_val = false; // Must have a user and a password if (!$dbuser){ $this->register_error($ezsql_mysql_str[1].' in '.__FILE__.' on line '.__LINE__); $this->show_errors ? trigger_error($ezsql_mysql_str[1],E_USER_WARNING) : null; // Try to establish the server database handle } else if (!$this->dbh = @mysql_connect($dbhost,$dbuser,$dbpassword)) { $this->register_error($ezsql_mysql_str[2].' in '.__FILE__.' on line '.__LINE__); $this->show_errors ? trigger_error($ezsql_mysql_str[2],E_USER_WARNING) : null; } else { $return_val = true; } return $return_val; } ## Try to select a mySQL database function select($dbname='') { global $ezsql_mysql_str; $return_val = false; // Must have a database name if (!$dbname) { $this->register_error($ezsql_mysql_str[3].' in '.__FILE__.' on line '.__LINE__); $this->show_errors ? trigger_error($ezsql_mysql_str[3],E_USER_WARNING) : null; // Must have an active database connection } else if (!$this->dbh) { $this->register_error($ezsql_mysql_str[4].' in '.__FILE__.' on line '.__LINE__); $this->show_errors ? trigger_error($ezsql_mysql_str[4],E_USER_WARNING) : null; // Try to connect to the database } else if (!@mysql_select_db($dbname,$this->dbh)) { // Try to get error supplied by mysql if not use our own if ( !$str = @mysql_error($this->dbh)) { $str = $ezsql_mysql_str[5]; } $this->register_error($str.' in '.__FILE__.' on line '.__LINE__); $this->show_errors ? trigger_error($str,E_USER_WARNING) : null; } else { $return_val = true; } return $return_val; } ## Format a mySQL string correctly for safe mySQL insert (no mater if magic quotes are on or not) function escape($str) { return mysql_escape_string(stripslashes($str)); } ## Return mySQL specific system date syntax function sysdate() { return 'NOW()'; } ## Perform mySQL query and try to detirmin result value function query($query) { // For reg expressions $query = trim($query); // Initialise return $return_val = 0; // Flush cached values.. $this->flush(); // Log how the function was called $this->func_call = "\$db->query(\"$query\")"; // Keep track of the last query for debug.. $this->last_query = $query; // Perform the query via std mysql_query function.. $this->result = @mysql_query($query,$this->dbh); $this->num_queries++; $this->all_queries .= $query.'
'; // If there is an error then take note of it.. if ($str = @mysql_error($this->dbh)) { $this->register_error($str); $this->show_errors ? trigger_error($str,E_USER_WARNING) : null; return false; } // Query was an insert, delete, update, replace if (preg_match("/^(insert|delete|update|replace)\s+/i",$query)) { $this->rows_affected = @mysql_affected_rows(); // Take note of the insert_id if (preg_match("/^(insert|replace)\s+/i",$query)) { $this->insert_id = @mysql_insert_id($this->dbh); } // Return number fo rows affected $return_val = $this->rows_affected; // Query was a select } else { // Take note of column info $i=0; while ($i < @mysql_num_fields($this->result)) { $this->col_info[$i] = @mysql_fetch_field($this->result); $i++; } // Store Query Results $num_rows=0; while ($row = @mysql_fetch_object($this->result)) { // Store relults as an objects within main array $this->last_result[$num_rows] = $row; $num_rows++; } @mysql_free_result($this->result); // Log number of rows the query returned $this->num_rows = $num_rows; // Return number of rows selected $return_val = $this->num_rows; } // If debug ALL queries $this->trace || $this->debug_all ? $this->debug() : null ; return $return_val; } } ?>