PHP Classes

File: simplesql.class.php

Recommend this page to a friend!
  Classes of Paul Williamson   Simple SQL   simplesql.class.php   Download  
File: simplesql.class.php
Role: Class source
Content type: text/plain
Description: Main file
Class: Simple SQL
MySQL wrapper to shortcut common tasks execution
Author: By
Last change: Constructor class added
Date: 20 years ago
Size: 25,988 bytes
 

Contents

Class file image Download
<?php /*======================================================================*\ SimpleSQL - The simple way to query Author: Paul Williamson <webmaster@protonage.net> Copyright: (C) 2004 Protonage.Net Productions (Paul Williamson), all rights reserved. Version: 1.00 Summery: This class is meant to shortcut common MySQL database access tasks. Author Comments: This is my first complete class file and I'm quite pleased about how it turned out. The script works perfectly on PHP > 4, hasn't been tested on any versions < PHP 4. As for mysql I havn't tested it on anything < API 3. All programming and testing ran on a 600mhz iBook with PHP 4.3.2 and MySQL API 3.23.49. This class file is currently running two large database applications on two different servers; so far it is flawless. If any bugs are found or comments, please e-mail me. I'm really bad at comming up with argument names for paramaters, but it shouldn't be very hard to figure it out. Also, please excuse my horriable spelling mistakes throughout the code. Everything should be pretty self- explanitory if your good at PHP/MySQL. And if your not then your not alone, only like .001% of the world's population knows what PHP is, so yeah... your pretty good if you are this far. Maybe I'll get around to writing a well developed readme/example document, but for now, I like being lazy... and eating cheese. If you have any questions or comments then please feel free to contact me via e-mail or website (info at top). Other than that, have a great day and enjoy coding the easy way! Legal: This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License version 2, as published by the Free Software Foundation. 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. You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA \*======================================================================*/ class SimpleSQL { /**** Public Variables ****/ /* Default Constructor Vars */ var $db_server = "localhost"; //the server to connect to var $db_username = "root"; //username to authincate var $db_password = ""; //password to authincate var $db_name = "db_name"; //database name to connect to /* Dynamic Vars */ var $db_table = "table"; //table being queried, it can //be changed in function arguments var $result = ""; //result from the query var $error = ""; //error or warning message stored here var $errmsgs = true; //print detailed errors var $debug = false; //print complete tracks of the functions (debugging) /**** Private Variables ****/ var $_connected = false; //connected or not? var $_link = NULL; //contains the mysql resource in use var $_select_link = NULL; //contains the last select resource //(for num_rows use) /* Regular Expressions */ //Modify if needed, POSIX type var $_reg_where = "((WHERE)? \w*='\w*'( AND|OR )?)*"; //Next one is a Pearl type, so be careful var $_reg_break = "/^((`|')(.*?)((`|'),(`|')|(`|')\$))(.*)\$/si"; //If modified, make sure the backref //is ok with the rest of the function /*======================================================================*\ Constructor function Note: I made the db_name first because users can change the constructor vars up top and not have to worry with providing connection info, just the database that the script will be connecting to. \*======================================================================*/ function SimpleSQL($db_name="",$db_server="",$db_username="",$db_password="") { $this->db_name=(empty($db_name))?$this->db_name:$db_name; $this->db_server=(empty($db_server))?$this->db_server:$db_server; $this->db_username=(empty($db_username))?$this->db_username:$db_username; $this->db_password=(empty($db_password))?$this->db_password:$db_password; } /*======================================================================*\ Public functions \*======================================================================*/ /*======================================================================*\ Function: get_content Purpose: go into the database and grab the content in the supplied field(s) and/or row(s) Input: optional arguments $DB_TABLE, $DB_WHERE for $DB_WHERE, match $this->_reg_where Output: returns true if ok and sets $this->result as an array of keys and values from the table \*======================================================================*/ function get_content ($db_table="",$db_where="",$db_order="",$db_limit="") { /* Make sure the connection is still live */ if (!$this->_connect(true)) { echo ($this->errmsgs)?$this->error:""; return false; } /**** Error checking ****/ $db_table=(!empty($db_table))?$db_table:$this->db_table; //Make sure an argument was supplied $this->db_table=$db_table; //Store it for($j=0;$j<2;$j++): //Add correct mysql syntax to beginning $a=($j)?"db_order":"db_limit"; //for the order and limit arguments $b=($j)?"ORDER BY":"LIMIT"; $$a=(empty($$a))?"":$this->_fix_sql($b,$$a); //fix the syntax (spacing and all) endfor; if (!eregi($this->_reg_where,$db_where)) //Check to see if the where clause { //followed the regular expression echo ($this->errmsgs)?"<pre>Invalid WHERE clause," .$this->_reg_where." does not match ".$db_where."":""; return false; } /* Sets important stuff if it's a where clause (see _fix_sql function) */ $db_where=$this->_fix_sql("WHERE",$db_where); /**** Start the MySQL query ****/ if (($this->_query("SELECT * FROM ".$db_table.$db_where.$db_order.$db_limit.";")) === FALSE) { echo ($this->errmsgs)?$this->error:""; return false; } /* Fetch the array from the database */ for ($i=0;$row=mysql_fetch_array($this->_link,MYSQL_ASSOC);$i++) { foreach($row as $key => $value) $result[$i][$key]=$value; //Return a nice array with field values } if (count($result) > 1) //Is a multi dim array really needed? $this->result=$result; //Store result and return true elseif (empty($i)) { echo ($this->errmsgs)?"<pre>SQL query: <b>" //If nothing was found in the DB .$select_clause."</b>"." returned false.":""; return false; }else $this->result=$result[0]; return true; } /*======================================================================*\ Function: insert Purpose: put an array of data into a respected table Input: Supply an ordered quoted rows and cols group matching in size, a closer look of the syntax follows: `field1`,`field2`,`field3` etc.. or ' this follows for the first 2 arguments $DB_TABLE is optional Output: returns true if ok and false if not if false, $this->error will be filled \*======================================================================*/ function insert($db_cols,$db_rows,$db_table="") { /* Make sure the connection is still live */ if (!$this->_connect(true)) { echo ($this->errmsgs)?$this->error:""; return false; } /**** Error checking ****/ $db_table=(!empty($db_table))?$db_table:$this->db_table; //Make sure an argument was supplied $this->db_table=$db_table; //Store it if (empty($db_rows) || empty($db_cols)) //If no argument supplied, die with error { echo ($this->errmsgs)?"Missing arguments in function " ."<b>insert</b>.":""; //Show error and return false return false; } $db_rows_arr=$this->_break($db_rows); //Send arguments over to _break function $db_cols_arr=$this->_break($db_cols); //so it is safely in an array if (!$db_rows_arr || !$db_cols_arr) { echo ($this->errmsgs)?$this->error:""; return false; } if (count($db_rows_arr) != count($db_cols_arr)) //Make sure they have the { //same number of elements echo ($this->errmsgs)?"Arrays do not match in size. " ."<br />\n<br />\n<b>".$db_rows ."</b><br />^ Has ".count($db_rows)." elements, while:" //Show error and return false ."<br />\n".$db_rows."<br />\n^ Has only " .count($db_rows)."\n":""; return false; } if (!$this->_field_exists($db_cols_arr)) { echo ($this->errmsgs)?"The provided fields were not " ."found in the database.":""; return false; } /* Reassemble the arrays into strings following the proper MySQL syntax */ for ($j=0;$j<=1;$j++): //Tells which variable the loop is on unset(${(empty($j))?"db_cols":"db_rows"}); for ($i=0;$i<count($db_cols_arr);$i++): //Pretty hard to explain code $c=(empty($j))?$db_cols_arr:$db_rows_arr; //Basicly just reassembles the array $q=(empty($j))?"`":"'"; //into proper MySQL syntax $n=($i==0)?$q.$c[$i].$q.",":(($i==count($c)-1)?$q.$c[$i].$q:$q.$c[$i].$q.","); ${(empty($j))?"db_cols":"db_rows"}.=$n; //Reassign to the right variable endfor; endfor; /**** Start the Query ****/ if ($this->_query("INSERT INTO `".$db_table."` (".$db_cols.") VALUES (".$db_rows.");")===false) { echo ($this->errmsgs)?$this->error:""; return false; } return true; } /*======================================================================*\ Function: update Purpose: update content in a database Input: Arguments are as follows: $DB_FIELD - Field being modified $DB_VALUE - New value of field $DB_TABLE - [optional] $DB_WHERE - [optional] $DB_LIMIT - [optional] (Default blank) Output: returns true if ok and false if not if false, $this->error will be filled \*======================================================================*/ function update($db_field,$db_value,$db_table="",$db_where="",$db_limit="") { /* Make sure the connection is still live */ if (!$this->_connect(true)) { echo ($this->errmsgs)?$this->error:""; return false; } /**** Error Check ****/ $db_table=(!empty($db_table))?$db_table:$this->db_table; //Make sure an argument was supplied $this->db_table=$db_table; //Store it if (empty($db_field) || empty($db_value)) //If no argument supplied, die with error { echo ($this->errmsgs)?"Missing arguments in function " ."<b>update</b>.":""; //Show error and return false return false; } $db_value=eregi_replace("'","\'",$db_value); //Escape small quotes due to sql syntax $db_limit=$this->_fix_sql("LIMIT",$db_limit); //Add correct mysql syntax to beginning if (!eregi($this->_reg_where,$db_where)) //Check to see if the where clause { //followed the regular expression echo ($this->errmsgs)?"<pre>Invalid WHERE clause," .$this->_reg_where." does not match ".$db_where."":""; return false; } /* Sets important stuff if it's a where clause */ $db_where=$this->_fix_sql("WHERE",$db_where); /**** Start the Query ****/ if ($this->_query("UPDATE `".$db_table."` SET `".$db_field."`='".$db_value."'".$db_where.$db_limit.";")===false) { echo ($this->errmsgs)?$this->error:""; return false; } return true; } /*======================================================================*\ Function: delete Purpose: delete a row in a database Input: Arguments are as follows: $DB_WHERE $DB_TABLE - [optional] $DB_ORDER - [optional] $DB_LIMIT - [optional] (Default blank) Output: returns true if ok and false if not if false, $this->error will be filled \*======================================================================*/ function delete($db_where,$db_table="",$db_order="",$db_limit="") { /* Make sure the connection is still live */ if (!$this->_connect(true)) { echo ($this->errmsgs)?$this->error:""; return false; } /**** Error Checking ****/ if(empty($db_where)) { echo ($this->errmsgs)?"Missing argument <i>db_where</i> in function " ."<b>delete</b>.":""; //Show error and return false return false; } $db_table=(empty($db_table))?$this->db_table:$db_table; //check to see if db talbe exists in args $this->db_table=$db_table; for($j=0;$j<2;$j++): //Add correct mysql syntax to beginning $a=($j)?"db_order":"db_limit"; //for the order and limit arguments $b=($j)?"ORDER BY":"LIMIT"; $$a=(empty($$a))?"":$this->_fix_sql($b,$$a); endfor; if (!eregi($this->_reg_where,$db_where)) //Check to see if the where clause { //followed the regular expression echo ($this->errmsgs)?"<pre>Invalid WHERE clause," .$this->_reg_where." does not match ".$db_where."":""; return false; } /* Sets important stuff if it's a where clause */ $db_where=$this->_fix_sql("WHERE",$db_where); /**** Start the Query ****/ $msg="<table>" //fill out debug message ."<tr><td width=250>\$db_where:</td><td>$db_where</td></tr>" ."<tr><td width=250>\$db_table:</td><td>$db_table</td></tr>" ."<tr><td width=250>\$db_order:</td><td>$db_order</td></tr>" ."<tr><td width=250>\$db_limit:</td><td>$db_limit</td></tr>" ."</table>"; if ($this->_query("DELETE FROM `".$db_table."`".$db_where.$db_order.$db_limit.";")===false) { echo ($this->errmsgs)?$this->error:""; $this->_print_debug("delete",$msg,false); return false; } $this->_print_debug("delete",$msg,true); //call debug function return true; } /*======================================================================*\ Function: num_rows Purpose: return an integer of the number of rows in a query. If no arguments are provided, this function will return the num_rows of the last query Input: Arguments are as follows: $DB_TABLE - [optional] $DB_WHERE - [optional] $DB_ORDER - [optional] $DB_LIMIT - [optional] (Default blank) Output: return an integer of the number of rows in a query. \*======================================================================*/ function num_rows($db_table="",$db_where="",$db_order="",$db_limit="") { /* Make sure the connection is still live */ if (!$this->_connect(true)) { echo ($this->errmsgs)?$this->error:""; return false; } $args[]=$db_table; //put arguments into an array $args[]=$db_where; $args[]=$db_order; $args[]=$db_limit; $keep=false; for($i=0;$i<count($args);$i++): //go through each to see if it's set if(!empty($args[$i])): $keep=true; break; //if it is then set keep to true endif; endfor; if(!$keep) //if no arguments, go ahead and get return @mysql_num_rows($this->_select_link); //num_rows from last query /**** Error Checking ****/ $db_table=(empty($db_table))?$this->db_table:$db_table; //check to see if db talbe exists in args $this->db_table=$db_table; for($j=0;$j<2;$j++): //Add correct mysql syntax to beginning $a=($j)?"db_order":"db_limit"; //for the order and limit arguments $b=($j)?"ORDER BY":"LIMIT"; $$a=(empty($$a))?"":$this->_fix_sql($b,$$a); endfor; if (!eregi($this->_reg_where,$db_where)) //Check to see if the where clause { //followed the regular expression echo ($this->errmsgs)?"<pre>Invalid WHERE clause," .$this->_reg_where." does not match ".$db_where."":""; return false; } /* Sets important stuff if it's a where clause */ $db_where=$this->_fix_sql("WHERE",$db_where); /**** Start the Query ****/ $msg.="<table>"; //for debugging, print if arguments present $msg.=(!empty($db_where))?"<tr><td width=250>\$db_where:</td><td>$db_where</td></tr>":""; $msg.=(!empty($db_table))?"<tr><td width=250>\$db_table:</td><td>$db_table</td></tr>":""; $msg.=(!empty($db_order))?"<tr><td width=250>\$db_order:</td><td>$db_order</td></tr>":""; $msg.=(!empty($db_limit))?"<tr><td width=250>\$db_limit:</td><td>$db_limit</td></tr>":""; $msg.="</table>";; /* send query and store into _select_link */ if (($this->_query("SELECT * FROM ".$db_table.$db_where.$db_order.$db_limit.";",true)) === FALSE) { echo ($this->errmsgs)?$this->error:""; $this->_print_debug("num_rows",$msg,false); return false; } $return=mysql_num_rows($this->_select_link); //get the resource for num_rows function $this->_print_debug("num_rows",$msg,$return); return $return; //return int } /*======================================================================*\ Private functions \*======================================================================*/ /*======================================================================*\ Function: _connect Purpose: connect to the server provided function will return false if failed and the $error variable will be set Input: $close - optional arg defaulted to false if true, it will reconnect to the server Output: returns true if ok and sets $_connected to true returns false if failed and sets $error \*======================================================================*/ function _connect($reopen=true) { if($this->_connected) { //Incase we're connected, if($reopen) : //close the connection if true @mysql_close($this->_link); //(@ excludes warnings) $this->_connected=false; //false it return $this->_connect(); //reopen it else: return true; endif; }else { /* Open the mysql_connect resource and put to $this->_link, if errors, echo errors */ if (($this->_link=mysql_connect($this->db_server,$this->db_username,$this->db_password)) === false) { $this->error="<pre>Could not connect to server \"" .$this->db_server."\". \nMySQL Says: <b>" //Echo the error found .mysql_error()."</b>\n\n"; $this->_connected=false; return false; } /* Select the database, on error echo it */ if (!mysql_select_db($this->db_name,$this->_link)) { $this->error="<pre>Could not select database \"" .$this->db_name."\". \nMySQL Says: <b>" //Echo the error found .mysql_error()."</b>\n\n"; $this->_connected=false; return false; } $this->_connected=true; //set all to true and continue return true; } } /*======================================================================*\ Function: _query Purpose: Sends the MySQL query and returns result. Main function is to take care of the error messages and reduce the amount of code. Input: $clause - The query string $select - [optional] True if the query is for _select_link only Output: returns status of the query \*======================================================================*/ function _query($clause,$select=false) { $msg="<table>" ."<tr><td width=250>\$clause:</td><td>$clause</td></tr>" ."</table>"; if (($this->{($select)?"_select_link":"_link"}=mysql_query($clause)) === false) { $this->error="<pre>There was an error executing " ."the following query: \"".$clause."" //If there was an error, echo what ."\"\n\nMySQL says: " //the error string was ."<b>".mysql_error()."</b>"; $this->_print_debug("_query",$msg,false); return false; } //Hand down the last select query $this->_select_link=(eregi("^SELECT",$clause))?$this->_link:$this->_select_link; //(for num_rows use) $this->_print_debug("_query",$msg,true); return true; //Should be a successful entry } /*======================================================================*\ Function: _kill Purpose: kill all connections to the sql server \*======================================================================*/ function _kill() { $this->_link=NULL; @mysql_close(); $this->_connected=false; } /*======================================================================*\ Function: _field_exists Purpose: This function will search the table and return true if the field was found, false if not Input: $db_field - field name to find in table this can be an array $db_table - optional arg, if not set then it will default to the currently selected table Output: returns true if found, false if not \*======================================================================*/ function _field_exists($db_field,$db_table="") { /* Make sure the connection is still live */ if (!$this->_connect(false)) return false; /* Error checking */ if (empty($db_field)) //Make sure field isn't blank { $this->error="No argument supplied for function _field_exists."; return false; } $db_table=($db_table!="")?$db_table:$this->db_table; //Make sure an argument was supplied $this->db_table=$db_table; //Store it if (($list_fields=mysql_list_fields($this->db_name,$db_table)) === false) { $this->error="There was an error listing the fields in: ".$this->db_name.".".$db_table.""; return false; } if (is_array($db_field)) { $num_found=0; foreach($db_field as $field) : for($i=0;$i<mysql_num_fields($list_fields);$i++) : if($field==mysql_field_name($list_fields,$i)) : $num_found++; //if found add 1 to num_fields break; endif; endfor; endforeach; return ($num_found == count($db_field))?true:false; //make sure all were found }else{ for($i=0;$i<mysql_num_fields($list_fields);$i++) { if($db_field==mysql_field_name($list_fields,$i)) return true; //return if found } return false; } } /*======================================================================*\ Function: _break Purpose: This function will break down a string with the regular expression provided and store it's contents in an array and return the array if the string is not valid, it will return false. The string format follows: 'var1','var2','etc..' Input: $string - the string you wish to break down Output: returns an array of the borken down string returns false if something went wrong \*======================================================================*/ function _break($string) { /* Error Check */ if (empty($string)) { $this->error="No argument supplied for function _break."; return false; } /* Regular Expressions */ $bufstr=$string; //Keep the orginal value of $string do //run once, keep going untill { //the string is empty $return[]=preg_replace($this->_reg_break,"\$3",$bufstr); $bufstr="'".preg_replace($this->_reg_break,"\$8",$bufstr); }while (preg_match($this->_reg_break,$bufstr)); if ((count($return)==1) && empty($return[0])) { $this->error="The supplied argument <b>" .$string."</b> did not match pearl regular " //if for some reason the array ."expression <b>".$this->_reg_break."</b>"; //has only 1 element with no value return false; //then something went wrong with } //the string $msg="<table>" ."<tr><td width=250>\$string:</td><td>$string</td></tr>" //fill the debug string ."</table>"; $this->_print_debug("_break",$msg,$return); return $return; } /*======================================================================*\ Function: _fix_sql Purpose: Simple function that fixes the SQL syntax for many clauses such as WHERE and ORDER BY Input: $type - ie WHERE, ORDER BY $clause - the whole string Output: returns the correct syntax string for the type \*======================================================================*/ function _fix_sql($type, $clause) { if(empty($clause)):return ""; endif; //if clause is empty, no need to resume $type=trim(strtoupper($type)); $return=(!empty($clause))?(!eregi("^".$type,$clause))?" ".$type." ".$clause."":" ".$clause."":""; $msg="<table>" //fill debug string ."<tr><td width=250>\$type:</td><td>$type</td></tr>" ."<tr><td width=250>\$clause:</td><td>$clause</td></tr>" ."</table>"; $this->_print_debug("_fix_sql",$msg,$return); return $return; //return the fixed results } /*======================================================================*\ Function: _print_debug Purpose: Just prints the debug results in a nice easy-to-read HTML format \*======================================================================*/ function _print_debug($function="",$args="",$return="") { $msg="<br /><br /><hr><h4>".$function."</h4>" //put into HTML ."<h5>Arguments</h5>\n<pre>".$args ."\n</pre><h5>Return</h5><pre>" .$return."</pre><hr><br /><br />"; echo($this->debug)?$msg:""; //echo debug message if debugging enabled } } //End SimpleSQL class ?>