DB_DataObject

An SQL Builder, Object Interface to Database Tables

DataObject performs 2 tasks: 1. Builds SQL statements based on the objects vars and the builder methods. 2. acts as a datastore for a table row. The core class is designed to be extended for each of your tables so that you put the data logic inside the data classes. included is a Generator to make your configuration files and your base classes. nd alan_k Alan Knowles alan@akbkhome.com lead 1.3 2003-10-15 PHP License stable New Features - Inserts and updates do not use keys in the data creation part of the query (Markus Wolff) - MsSQL native get_last_insert ID using SELECT @@IDENTITY ** you may want to consider using this with transactions eg. $dataobject->query('BEGIN') and $dataobject->query('COMMIT') to ensure thread safety. (Markus Wolff) - DB_DataObject_Cast - a experimental generic casting feature for assigning variables * Common usages: // blobs $dataObject->someblobfield = DB_DataObject_Cast::blob(file_get_contents('xxx.jpg')); $dataObject->someblobfield = DB_DataObject_Cast::string('xxxxx'); // dates? $dataObject->at_date = DB_DataObject_Cast::date('12/12/2000'); //Human $dataObject->at_date = DB_DataObject_Cast::date('2000-12-12'); //ISO $dataObject->at_date = DB_DataObject_Cast::date(2000,12,12); //YYYY,dd,mm $d2 = DB_DataObject_Cast::date(); // today! // some addition $dataObject->expires = DB_DataObject_Cast::date($d1->year, $d1->month+30, $d1->day+30); // raw sql???? $dataObject->maxids = DB_DataObject_Cast::sql('max(id) > 12'); $dataObject->emptyfield = DB_DataObject_Cast::sql('NULL'); You can extend this object to provide your own datatypes.. - PHP5 Compatibility Return values should work with PHP5beta2 Overload (__call) should work with PHP5beta2 - table() and keys() Allow setting of data with a value (so you can use dataobjects without extended instances.) - factory/ getLinks and autoloading Will use the full path location in config to check if the file exists, after that it is included without warnings turned off.. (autoloading check to see if class exists first - should be faster) Fixes: - Validate is an optional dependency (Arnaud Limbourg) - Bug #228, BOOL type on postgresql correctly quoted. - Bug #133, No error is raised when calling fetch with no data returned, just produces a debug warning now - Bug #172,Turning of Overload If you define DB_DATAOBJECT_NO_OVERLOAD to any value, then dataobjects will not be overloaded, This is usefull when working with ZendOptimizer, that may segfault with certain optimization levels DB Validate 1.2 2003-08-07 stable New Features: - A Number of the private methods have been made Public, changes: - _get_table() = table() - _get_keys() = keys() additions - tableName() = returns or assign the table name - database() = returns or assign the database name changes by Markus Wolff POSSIBLE BC IMPLICATIONS: If you define _get_table or _get_keys manually (rather than using the ini file) you should rename your methods table() and keys() Fixes: - Generator is now more tollerant of editors that alter the spaces before the autocode markers ### (Andreas Ljunggren) 1.1 2003-08-07 stable Bug Fixes - limit argument testing now accepts "10" (a string with an integer in it, as a valid argument) (Demian Turner) New Features - JoinAdd has additional Argument $joinCol, so you can specify multiple targets links of the same table, eg. user->friend, user->parent both connect to the user table.. (Andy Crain) 1.0.2 2003-07-31 stable Minor Bugfix Release - Fix static Get call, case sensitivity properly. 1.0.1 2003-07-18 stable Minor Bugfix Release - Fix Select defaults back to * after an fetch - Fix Update with NULL values 1.0 2003-07-16 stable - Gold 1.0 Release.. - final stable release in this series. Future versions (eg. 1.1.*(dev)->1.2.*(release)) series will be generally API compatible, however is likely to use MDB rather than DB. - fix bug #23983 - argument checking on whereAdd, orderBy, limit and a few others (Mike Carter) - fix bug with cache clearing not working with staticGet and update/insert - null comparison for $object->var = 'null' will generate IS NULL query - null insert/update works when using 'null' as a value. - getLinks returns true on success - getLinks now has a formatter eg. '_%s' is default to allow user to define the format of variables to assign child objects to. - generator uses UNIQUE only if no primary/autoincrement type field is found. - added support for $object->having('sum(value) > 10'); - fetch will remove some query lines (so if you want to see how the query was built you will have to print_r() the object after find(), and before fetch(), or just use debugLevel(1) - overload calls from setFrom and toArray do method checks, as overload is still proving to be a little unstable especially with Zend Encoder. (Note: if DataObjects causes crashes , remove the overload code at the bottom of DataObjects.php) 0.19 2003-05-22 stable - fix bug #23712 - deleting (and probably updating as well) an object while being fetched. (Michael McCarthy for spotting this) - fix generator overwriting code when file was edited in a Windows editor (Robert Janeczek) - validation will not produce errors on empty numeric data by default. - overload extension enabled to relay setFrom and toArray calls to get*, set* methods, which are predefined as getXXX = returns $object->XXX setXXX($V) = returns true (or an error string if you create your own) (only affects php-4.3.2RC2 or later..) - selectAs($dataobject,'prefix_%s') to help control the way join queries return their data * doing selectAs() - clears the select and sets it to table.id as id ... etc. - joinAdd has 2 extra optional arguments $dataObject->joinAdd($otherDataObject, $joinType, $joinAs) existing behaviour (INNER Joins) is default (eg. no value) $joinType can be: INNER,LEFT,RIGHT = eg. INNER JOIN ... etc. '' = just added with a , and the link conditions are added with a WHERE statement. $joinAs can be used to name the table differently in the join eg. SELECT .. FROM person INNER JOIN address as homeaddress ...... - setFrom has an extra optional parameter for formating: eg. $object->setFrom($_POST,'prefix_%s') would map prefix_name to $object->name the default is '%s' which is the same as the previous behaviour - added option dont_die (default no) to ini file default (no) means that DataObjects will emit a PEAR_ERROR_DIE on configuration and programming errors true or 1 means that you can write a PEAR::error handler to catch the errors and display a nice it's not working message 0.18 2003-05-17 stable - add table prefix to autobuilt queries (assist in ambigous querys for joins) (Daniel Von Fange) - change update and delete to return the number of rows affected or false on failure - various code tidy ups - standards etc. (Arnaud Limbourg) - fix generator for postgres and mdb - use unique keys and look for 'nextval' as keys. - fix no key insert bug (G Moxley Kempster) - fix empty table bug in generator (Robert Janeczek) - staticAutoloadTable(), now handles parse errors in included files alot cleaner - added dependancies on PHP4.3, DB 1.3 and Validate (although Validate is optional) - added table prefix to count query (Richard Wallace) 0.17 2003-03-12 stable - Usual post feature bug fix release - fix loading of links.ini for joinAdd, getLinks etc. (Geoff Hopson) 0.16 2003-03-06 stable - replaced config storage - should improve performance - removed production option (not required due to improved config storage) - bugfix : added checks for is_array on ignore_sequence_keys (Hermen Heinen) - add toArray($format) which supports sprintf to enable easy integration with Quickforms etc. (Demian Turner) - add optional dataobject as variable to update(), so you can update will only create an update based on what has changed. (Geoff Hopson) - add join condition to count() (Daniel Von Fange) - modify limit() to work with postgresql and make it emit a fatal error if you try this on databases that do not directly support limit queries. (Geoff Hopson) * I'm open on better ideas for this - probably wrapping the find() select call 0.15 2003-02-13 stable - modified find(true), so that it calls fetch rather than fetchrow so that overriding fetch will affect get() calls. (probably depreciates fetchrow now .. shout if anyone is using it) - added escape method as a quasi quote wrapper into pear::DB - useful for building your own queries - eg. like requests.. (does not add quotes) - fixed bug with delete not using primary key if it was set. (Ian Eure) 0.14 2003-02-06 stable - added get affected rows to update/insert/delete they will return false if no data is affected and set the Objects lastError value. Note: databases that do not support affectedRows(), will always return false. 0.13 2003-01-23 stable - bug fix release - debug_ignore_updates worked in reverse.. (Alexander Mazurov) 0.12 2003-01-22 stable - Usual post release bug fix. - fixes *.links.ini incorrectly using *.links (Damian Turner) - Adds the ability to get PEAR Connection and result objects getDatabaseConnection() and getDatabaseResult() (jason rust) 0.11 2003-01-21 stable - changed connecition and result caching to use global private variable, rather than getStaticProperty - results objects are not stored on insert/update/delete (speed increase on large inserts can be as much as 10x faster) - bug fix - Checks that primary keys are integers (Anthony Juou) - typo on No data returned warning - unit tests in CVS - new configuration option for whether to use insert id's and sequences. - Generator no creates boolean bit (mitchell perilstein) 0.10 2002-12-09 stable - bug fix - Generator incorrectly set _database, causing generation of database.ini files to fail - change addslashes to PEAR::DB::quote() - generator now only replaces DB_DataObjects with extends variable if set, you can use generator_rewrite_class to set what is a valid replacement. 0.9 2002-12-06 stable - bug fix release - dsn was not set correctly 0.8 2002-09-21 stable - changed to stable status as it appears to be pretty stable now. - update and insert now return FALSE on error conditions (Peter Gebauer) which can be checked using === FALSE, and the error obtained using $object->_lastError - delete will only use primary keys if they are set, otherwise it will use all object variables to build the condition. (Daniel Ferreira) - Added derivedHookFunctions(), and derivedHookVar() to enable extensions to generator to make user defined methods. (Michael Lund Rasmussen) - support for INT4, BPCHAR, TIMESTAMPTZ and postres Primary keys (Xavier) - better PEAR CS complience (tabs and TRUE -> true), removed short open tags in generator (Thomas Volkmar Worm) - experimental addJoin method (Stijn de Reede) - Allow active options array (eg. dynamic changing of database config) (Sergey Lipnevich) 0.6 2002-09-10 beta - bug fix release on insert (broke due to compatibility fixes) 0.5 2002-09-07 beta - fixed database.links.ini file loading in wrong location (Jens Fischer) - fixed type on extends (Jens Fischer) - added __clone() support to pre- php5 classes - added multiple linked table support 0.4 2002-08-21 beta - Bug fix release - createTables used wrong argv 0.3 2002-08-16 beta - Fixed Globals requirement in createTables, 0.2 2002-07-12 beta Removed list method, First upload as pear package. - Documentation now in PEAR Manual 0.1 2002-06-25 beta PEARified