C:/usr/local/lib/php/blueshoes-4.2/core/db/Bs_DbWrapper.class.phpandrej arn <andrej at blueshoes dot org>samuel blume <sam at blueshoes dot org>todo:this class is old and needs some major cleaning. especially more down the file.i think that some methods should be moved into a new Bs_DbUtil class. maybe:rlArrayToHashArray(), sqlPrepareByArray(), sqlArrayToOrderBy()i took the old class and made the needed changes to get it running, not more.28.2.2002 --andrejdependencies:DB Wrapper4.0.$id$blueshoes.orgconstructorno check is made if that table exists.sets the table name that should be used.$_recordData(default is null. case sensitive.) &(array or string)null on an unknown key. the key is case sensitive.if the param $key is not set or set to null, the whole data array will be returned.you may bet the value by reference.returns the desirec data.tells if the wrapper has been initialized and is ready to use.tells if the object has any data.initByData()(the identifier of the table. (The ID field))(default is 'ID'. if your field is called different, change that.)Init by fetching the data from the DB and then call $this->initByData().(hash from db-select => record data.)init using the result set (as array). (new record id)bool FALSE (not initializedno data) or bs_exception (db problem/failure)It expects the primery Key to be called "ID", which must be temporarlyremoved to execute the SQL INSERT successfully.Also a field named "timestap" will be temp. removed.Insert a new set of data (record) into the DB.TRUE bool FALSE (not initializedno data) or bs_exception (db problem/failure)Replace an existing record or, if not existent, insert a new one.TRUE bool FALSE (not initializedno data) or bs_exception (db problem/failure)Delete the record from the DB. (hash where key is the table name, value is bool TRUE.)finds things like db.table.field and table.field.i don't think this one will check "SELECT blah FROM table, table, table" ... dunno. --andrejExtracts all table names of a SQL clause.(see above)(see above)bool FALSE (not initialized) or bs_exception (db problem/failure)put them into a comma separated list.//FROM <tab1>,<tab2> part of the sql query string.param $whereCondition:"WHERE db.table.field = 'foo' AND table.field = 'bar'"param $selectAddition:"db.table.field, table.field, field, "hrm. dunno exactly what's going on here. --andrejIf dbCount finds any foreign tables in the where clause then it will[$fieldArray]; field list, example "firstName", default = select all fields[$whereCondition]; where conditions, example "WHERE firstName LIKE '%tobler%' AND (ID >= 15 OR someShit = 'hello')",[$orderArray]; fieldnames for order by, example array("firstName" => "DESC"), default = no order[$offset]; first record, where to start, example 20, default = no offset[$maxAmount]; number of records to get, example 50, default = all (2d array with the records. output that we got from db->getAll().)bool FALSE (not initialized) or bs_exception (db problem/failure)//FROM <tab1>,<tab2> part of the sql query string.//If getRecordList finds any foreign tables in the where clause OR in the fieldArray, it will put it in the the: A sql string with 1 (one) %s (string placeholders): Normal or hash array (see above) with dbField and value pair (as given from $this->FArray()) Examples SELECT The Array: array("ID"=>41, "TXT"=>"sample 1", "whatEver"=>"oooo") or: array("ID", "TXT", "whatEver") A) SELECT %s FROM [WHERE where_definition] [LIMIT #] Will return A) SELECT ID,TXT,whatEver FROM [WHERE where_definition] [LIMIT #] Examples INSERT, REPLACE or UPDATE The Array: array("ID"=>41, "TXT"=>"sample 1", "whatEver"=>"oooo") A) UPDATE db.table SET %s [WHERE where_definition] [LIMIT #] B) INSERT [INTO] tbl_name SET %s Will return A) UPDATE db.table SET ID='41',TXT='sample 1',whatEver='oooo' [WHERE where_definition] [LIMIT #]" B) INSERT [INTO] tbl_name SET ID='41',TXT='sample 1',whatEver='oooo'This fuction expects $sqlFormatStr of th forma) [INSERT | REPLACE | UPDATE] table SET %s [what ever];b) SELECT %s [what ever];In case of a) the Array ($theArray) MUST be a hash Array of field value pair.In case of b) the Array ($theArray) MAY be either and normal Array of fields or hash Array of field value pair.See example.Usefull INTELLIGENT helper to built a SELECT, INSERT, REPLACE and UPDATE (maybe more) sql string.MAY be either and normal or hash Array. If hash array({"fieldName"=>[ "" | "ASC" | "DESC"]})Expects the passed array ($theArray) to be either a normal array of fields or a hash Arrayof the form array({"fieldName"=>[ "" | "ASC" | "DESC"]}).It will then build the SQL fragment ORDER BY {<field Name> [<order key>]}Examples AGiven: array( "name"=>"", "ID"=>"ASC", "time"=>"DESC")Return: " ORDER BY name,ID ASC,time DESC "Examples BGiven: array( "name", "ID", "time")Return: " ORDER BY name,ID,time "Usefull INTELLIGENT helper to built a the ORDER BY postfix sql string.here (maybe even from another server) we prefer to open a new connection.db object. is not necessarily the global one! if we use another databasethe database name that is in use.the database table name that is in use._hasData()the record data to work with.4.0.$x$isexisexceptiontostringtohtmlpersistunpersistbs_objectbbsetoutputbbawakebbisawakebbxmsgbbxfunctionstartbbxfunctionendbbxechobbxvarbbxvardumpbbforcetracebbbufferstartbbbuffergetbbbufferendflushbbbufferendcleanbs_object_versionBs_ObjectBs_Object