initial checkin

1 files changed, 1497 insertions, 0 deletions

diff --git a/vendor/adodb/adodb-php/adodb-active-recordx.inc.php b/vendor/adodb/adodb-php/adodb-active-recordx.inc.php
new file mode 100644
index 0000000..0d85a74
--- /dev/null
+++ b/vendor/adodb/adodb-php/adodb-active-recordx.inc.php
@@ -0,0 +1,1497 @@
+<?php
+/*
+
+@version   v5.20.14  06-Jan-2019
+@copyright (c) 2000-2013 John Lim (jlim#natsoft.com). All rights reserved.
+@copyright (c) 2014      Damien Regad, Mark Newnham and the ADOdb community
+  Latest version is available at http://adodb.org/
+
+  Released under both BSD license and Lesser GPL library license.
+  Whenever there is any discrepancy between the two licenses,
+  the BSD license will take precedence.
+
+  Active Record implementation. Superset of Zend Framework's.
+
+  This is "Active Record eXtended" to support JOIN, WORK and LAZY mode by Chris Ravenscroft  chris#voilaweb.com
+
+  Version 0.9
+
+  See http://www-128.ibm.com/developerworks/java/library/j-cb03076/?ca=dgr-lnxw01ActiveRecord
+  	for info on Ruby on Rails Active Record implementation
+*/
+
+
+	// CFR: Active Records Definitions
+define('ADODB_JOIN_AR', 0x01);
+define('ADODB_WORK_AR', 0x02);
+define('ADODB_LAZY_AR', 0x03);
+
+
+global $_ADODB_ACTIVE_DBS;
+global $ADODB_ACTIVE_CACHESECS; // set to true to enable caching of metadata such as field info
+global $ACTIVE_RECORD_SAFETY; // set to false to disable safety checks
+global $ADODB_ACTIVE_DEFVALS; // use default values of table definition when creating new active record.
+
+// array of ADODB_Active_DB's, indexed by ADODB_Active_Record->_dbat
+$_ADODB_ACTIVE_DBS = array();
+$ACTIVE_RECORD_SAFETY = true; // CFR: disabled while playing with relations
+$ADODB_ACTIVE_DEFVALS = false;
+
+class ADODB_Active_DB {
+	var $db; // ADOConnection
+	var $tables; // assoc array of ADODB_Active_Table objects, indexed by tablename
+}
+
+class ADODB_Active_Table {
+	var $name; // table name
+	var $flds; // assoc array of adofieldobjs, indexed by fieldname
+	var $keys; // assoc array of primary keys, indexed by fieldname
+	var $_created; // only used when stored as a cached file
+	var $_belongsTo = array();
+	var $_hasMany = array();
+	var $_colsCount; // total columns count, including relations
+
+	function updateColsCount()
+	{
+		$this->_colsCount = sizeof($this->flds);
+		foreach($this->_belongsTo as $foreignTable)
+			$this->_colsCount += sizeof($foreignTable->TableInfo()->flds);
+		foreach($this->_hasMany as $foreignTable)
+			$this->_colsCount += sizeof($foreignTable->TableInfo()->flds);
+	}
+}
+
+// returns index into $_ADODB_ACTIVE_DBS
+function ADODB_SetDatabaseAdapter(&$db)
+{
+	global $_ADODB_ACTIVE_DBS;
+
+		foreach($_ADODB_ACTIVE_DBS as $k => $d) {
+			if (PHP_VERSION >= 5) {
+				if ($d->db === $db) {
+					return $k;
+				}
+			} else {
+				if ($d->db->_connectionID === $db->_connectionID && $db->database == $d->db->database) {
+					return $k;
+				}
+			}
+		}
+
+		$obj = new ADODB_Active_DB();
+		$obj->db = $db;
+		$obj->tables = array();
+
+		$_ADODB_ACTIVE_DBS[] = $obj;
+
+		return sizeof($_ADODB_ACTIVE_DBS)-1;
+}
+
+
+class ADODB_Active_Record {
+	static $_changeNames = true; // dynamically pluralize table names
+	static $_foreignSuffix = '_id'; //
+	var $_dbat; // associative index pointing to ADODB_Active_DB eg. $ADODB_Active_DBS[_dbat]
+	var $_table; // tablename, if set in class definition then use it as table name
+	var $_sTable; // singularized table name
+	var $_pTable; // pluralized table name
+	var $_tableat; // associative index pointing to ADODB_Active_Table, eg $ADODB_Active_DBS[_dbat]->tables[$this->_tableat]
+	var $_where; // where clause set in Load()
+	var $_saved = false; // indicates whether data is already inserted.
+	var $_lasterr = false; // last error message
+	var $_original = false; // the original values loaded or inserted, refreshed on update
+
+	var $foreignName; // CFR: class name when in a relationship
+
+	static function UseDefaultValues($bool=null)
+	{
+	global $ADODB_ACTIVE_DEFVALS;
+		if (isset($bool)) {
+			$ADODB_ACTIVE_DEFVALS = $bool;
+		}
+		return $ADODB_ACTIVE_DEFVALS;
+	}
+
+	// should be static
+	static function SetDatabaseAdapter(&$db)
+	{
+		return ADODB_SetDatabaseAdapter($db);
+	}
+
+
+	public function __set($name, $value)
+	{
+		$name = str_replace(' ', '_', $name);
+		$this->$name = $value;
+	}
+
+	// php5 constructor
+	// Note: if $table is defined, then we will use it as our table name
+	// Otherwise we will use our classname...
+	// In our database, table names are pluralized (because there can be
+	// more than one row!)
+	// Similarly, if $table is defined here, it has to be plural form.
+	//
+	// $options is an array that allows us to tweak the constructor's behaviour
+	// if $options['refresh'] is true, we re-scan our metadata information
+	// if $options['new'] is true, we forget all relations
+	function __construct($table = false, $pkeyarr=false, $db=false, $options=array())
+	{
+	global $ADODB_ASSOC_CASE,$_ADODB_ACTIVE_DBS;
+
+		if ($db == false && is_object($pkeyarr)) {
+			$db = $pkeyarr;
+			$pkeyarr = false;
+		}
+
+		if($table) {
+			// table argument exists. It is expected to be
+			// already plural form.
+			$this->_pTable = $table;
+			$this->_sTable = $this->_singularize($this->_pTable);
+		}
+		else {
+			// We will use current classname as table name.
+			// We need to pluralize it for the real table name.
+			$this->_sTable = strtolower(get_class($this));
+			$this->_pTable = $this->_pluralize($this->_sTable);
+		}
+		$this->_table = &$this->_pTable;
+
+		$this->foreignName = $this->_sTable; // CFR: default foreign name (singular)
+
+		if ($db) {
+			$this->_dbat = ADODB_Active_Record::SetDatabaseAdapter($db);
+		} else
+			$this->_dbat = sizeof($_ADODB_ACTIVE_DBS)-1;
+
+
+		if ($this->_dbat < 0) {
+			$this->Error(
+				"No database connection set; use ADOdb_Active_Record::SetDatabaseAdapter(\$db)",
+				'ADODB_Active_Record::__constructor'
+			);
+		}
+
+		$this->_tableat = $this->_table; # reserved for setting the assoc value to a non-table name, eg. the sql string in future
+
+		// CFR: Just added this option because UpdateActiveTable() can refresh its information
+		// but there was no way to ask it to do that.
+		$forceUpdate = (isset($options['refresh']) && true === $options['refresh']);
+		$this->UpdateActiveTable($pkeyarr, $forceUpdate);
+		if(isset($options['new']) && true === $options['new']) {
+			$table =& $this->TableInfo();
+			unset($table->_hasMany);
+			unset($table->_belongsTo);
+			$table->_hasMany = array();
+			$table->_belongsTo = array();
+		}
+	}
+
+	function __wakeup()
+	{
+		$class = get_class($this);
+		new $class;
+	}
+
+	// CFR: Constants found in Rails
+	static $IrregularP = array(
+		'PERSON'    => 'people',
+		'MAN'       => 'men',
+		'WOMAN'     => 'women',
+		'CHILD'     => 'children',
+		'COW'       => 'kine',
+	);
+
+	static $IrregularS = array(
+		'PEOPLE'    => 'PERSON',
+		'MEN'       => 'man',
+		'WOMEN'     => 'woman',
+		'CHILDREN'  => 'child',
+		'KINE'      => 'cow',
+	);
+
+	static $WeIsI = array(
+		'EQUIPMENT' => true,
+		'INFORMATION'   => true,
+		'RICE'      => true,
+		'MONEY'     => true,
+		'SPECIES'   => true,
+		'SERIES'    => true,
+		'FISH'      => true,
+		'SHEEP'     => true,
+	);
+
+	function _pluralize($table)
+	{
+		if (!ADODB_Active_Record::$_changeNames) {
+			return $table;
+		}
+		$ut = strtoupper($table);
+		if(isset(self::$WeIsI[$ut])) {
+			return $table;
+		}
+		if(isset(self::$IrregularP[$ut])) {
+			return self::$IrregularP[$ut];
+		}
+		$len = strlen($table);
+		$lastc = $ut[$len-1];
+		$lastc2 = substr($ut,$len-2);
+		switch ($lastc) {
+			case 'S':
+				return $table.'es';
+			case 'Y':
+				return substr($table,0,$len-1).'ies';
+			case 'X':
+				return $table.'es';
+			case 'H':
+				if ($lastc2 == 'CH' || $lastc2 == 'SH') {
+					return $table.'es';
+				}
+			default:
+				return $table.'s';
+		}
+	}
+
+	// CFR Lamest singular inflector ever - @todo Make it real!
+	// Note: There is an assumption here...and it is that the argument's length >= 4
+	function _singularize($table)
+	{
+
+		if (!ADODB_Active_Record::$_changeNames) {
+		return $table;
+	}
+		$ut = strtoupper($table);
+		if(isset(self::$WeIsI[$ut])) {
+			return $table;
+		}
+		if(isset(self::$IrregularS[$ut])) {
+			return self::$IrregularS[$ut];
+		}
+		$len = strlen($table);
+		if($ut[$len-1] != 'S') {
+			return $table; // I know...forget oxen
+		}
+		if($ut[$len-2] != 'E') {
+			return substr($table, 0, $len-1);
+		}
+		switch($ut[$len-3]) {
+			case 'S':
+			case 'X':
+				return substr($table, 0, $len-2);
+			case 'I':
+				return substr($table, 0, $len-3) . 'y';
+			case 'H';
+				if($ut[$len-4] == 'C' || $ut[$len-4] == 'S') {
+					return substr($table, 0, $len-2);
+				}
+			default:
+				return substr($table, 0, $len-1); // ?
+		}
+	}
+
+	/*
+	 * ar->foreignName will contain the name of the tables associated with this table because
+	 * these other tables' rows may also be referenced by this table using theirname_id or the provided
+	 * foreign keys (this index name is stored in ar->foreignKey)
+	 *
+	 * this-table.id = other-table-#1.this-table_id
+	 *               = other-table-#2.this-table_id
+	 */
+	function hasMany($foreignRef,$foreignKey=false)
+	{
+		$ar = new ADODB_Active_Record($foreignRef);
+		$ar->foreignName = $foreignRef;
+		$ar->UpdateActiveTable();
+		$ar->foreignKey = ($foreignKey) ? $foreignKey : strtolower(get_class($this)) . self::$_foreignSuffix;
+
+		$table =& $this->TableInfo();
+		if(!isset($table->_hasMany[$foreignRef])) {
+			$table->_hasMany[$foreignRef] = $ar;
+			$table->updateColsCount();
+		}
+# @todo Can I make this guy be lazy?
+		$this->$foreignRef = $table->_hasMany[$foreignRef]; // WATCHME Removed assignment by ref. to please __get()
+	}
+
+	/**
+	 * ar->foreignName will contain the name of the tables associated with this table because
+	 * this table's rows may also be referenced by those tables using thistable_id or the provided
+	 * foreign keys (this index name is stored in ar->foreignKey)
+	 *
+	 * this-table.other-table_id = other-table.id
+	 */
+	function belongsTo($foreignRef,$foreignKey=false)
+	{
+		global $inflector;
+
+		$ar = new ADODB_Active_Record($this->_pluralize($foreignRef));
+		$ar->foreignName = $foreignRef;
+		$ar->UpdateActiveTable();
+		$ar->foreignKey = ($foreignKey) ? $foreignKey : $ar->foreignName . self::$_foreignSuffix;
+
+		$table =& $this->TableInfo();
+		if(!isset($table->_belongsTo[$foreignRef])) {
+			$table->_belongsTo[$foreignRef] = $ar;
+			$table->updateColsCount();
+		}
+		$this->$foreignRef = $table->_belongsTo[$foreignRef];
+	}
+
+	/**
+	 * __get Access properties - used for lazy loading
+	 *
+	 * @param mixed $name
+	 * @access protected
+	 * @return void
+	 */
+	function __get($name)
+	{
+		return $this->LoadRelations($name, '', -1. -1);
+	}
+
+	function LoadRelations($name, $whereOrderBy, $offset=-1, $limit=-1)
+	{
+		$extras = array();
+		if($offset >= 0) {
+			$extras['offset'] = $offset;
+		}
+		if($limit >= 0) {
+			$extras['limit'] = $limit;
+		}
+		$table =& $this->TableInfo();
+
+		if (strlen($whereOrderBy)) {
+			if (!preg_match('/^[ \n\r]*AND/i',$whereOrderBy)) {
+				if (!preg_match('/^[ \n\r]*ORDER[ \n\r]/i',$whereOrderBy)) {
+					$whereOrderBy = 'AND '.$whereOrderBy;
+				}
+			}
+		}
+
+		if(!empty($table->_belongsTo[$name])) {
+			$obj = $table->_belongsTo[$name];
+			$columnName = $obj->foreignKey;
+			if(empty($this->$columnName)) {
+				$this->$name = null;
+			}
+			else {
+				if(($k = reset($obj->TableInfo()->keys))) {
+					$belongsToId = $k;
+				}
+				else {
+					$belongsToId = 'id';
+				}
+
+				$arrayOfOne =
+					$obj->Find(
+						$belongsToId.'='.$this->$columnName.' '.$whereOrderBy, false, false, $extras);
+				$this->$name = $arrayOfOne[0];
+			}
+			return $this->$name;
+		}
+		if(!empty($table->_hasMany[$name])) {
+			$obj = $table->_hasMany[$name];
+			if(($k = reset($table->keys))) {
+				$hasManyId   = $k;
+			}
+			else {
+				$hasManyId   = 'id';
+			}
+
+			$this->$name =
+				$obj->Find(
+					$obj->foreignKey.'='.$this->$hasManyId.' '.$whereOrderBy, false, false, $extras);
+			return $this->$name;
+		}
+	}
+	//////////////////////////////////
+
+	// update metadata
+	function UpdateActiveTable($pkeys=false,$forceUpdate=false)
+	{
+	global $ADODB_ASSOC_CASE,$_ADODB_ACTIVE_DBS , $ADODB_CACHE_DIR, $ADODB_ACTIVE_CACHESECS;
+	global $ADODB_ACTIVE_DEFVALS, $ADODB_FETCH_MODE;
+
+		$activedb = $_ADODB_ACTIVE_DBS[$this->_dbat];
+
+		$table = $this->_table;
+		$tables = $activedb->tables;
+		$tableat = $this->_tableat;
+		if (!$forceUpdate && !empty($tables[$tableat])) {
+
+			$tobj = $tables[$tableat];
+			foreach($tobj->flds as $name => $fld) {
+				if ($ADODB_ACTIVE_DEFVALS && isset($fld->default_value)) {
+					$this->$name = $fld->default_value;
+				}
+				else {
+					$this->$name = null;
+				}
+			}
+			return;
+		}
+
+		$db = $activedb->db;
+		$fname = $ADODB_CACHE_DIR . '/adodb_' . $db->databaseType . '_active_'. $table . '.cache';
+		if (!$forceUpdate && $ADODB_ACTIVE_CACHESECS && $ADODB_CACHE_DIR && file_exists($fname)) {
+			$fp = fopen($fname,'r');
+			@flock($fp, LOCK_SH);
+			$acttab = unserialize(fread($fp,100000));
+			fclose($fp);
+			if ($acttab->_created + $ADODB_ACTIVE_CACHESECS - (abs(rand()) % 16) > time()) {
+				// abs(rand()) randomizes deletion, reducing contention to delete/refresh file
+				// ideally, you should cache at least 32 secs
+				$activedb->tables[$table] = $acttab;
+
+				//if ($db->debug) ADOConnection::outp("Reading cached active record file: $fname");
+					return;
+			} else if ($db->debug) {
+				ADOConnection::outp("Refreshing cached active record file: $fname");
+			}
+		}
+		$activetab = new ADODB_Active_Table();
+		$activetab->name = $table;
+
+		$save = $ADODB_FETCH_MODE;
+		$ADODB_FETCH_MODE = ADODB_FETCH_ASSOC;
+		if ($db->fetchMode !== false) {
+			$savem = $db->SetFetchMode(false);
+		}
+
+		$cols = $db->MetaColumns($table);
+
+		if (isset($savem)) {
+			$db->SetFetchMode($savem);
+		}
+		$ADODB_FETCH_MODE = $save;
+
+		if (!$cols) {
+			$this->Error("Invalid table name: $table",'UpdateActiveTable');
+			return false;
+		}
+		$fld = reset($cols);
+		if (!$pkeys) {
+			if (isset($fld->primary_key)) {
+				$pkeys = array();
+				foreach($cols as $name => $fld) {
+					if (!empty($fld->primary_key)) {
+						$pkeys[] = $name;
+					}
+				}
+			} else {
+				$pkeys = $this->GetPrimaryKeys($db, $table);
+			}
+		}
+		if (empty($pkeys)) {
+			$this->Error("No primary key found for table $table",'UpdateActiveTable');
+			return false;
+		}
+
+		$attr = array();
+		$keys = array();
+
+		switch($ADODB_ASSOC_CASE) {
+		case 0:
+			foreach($cols as $name => $fldobj) {
+				$name = strtolower($name);
+				if ($ADODB_ACTIVE_DEFVALS && isset($fldobj->default_value)) {
+					$this->$name = $fldobj->default_value;
+				}
+				else {
+					$this->$name = null;
+				}
+				$attr[$name] = $fldobj;
+			}
+			foreach($pkeys as $k => $name) {
+				$keys[strtolower($name)] = strtolower($name);
+			}
+			break;
+
+		case 1:
+			foreach($cols as $name => $fldobj) {
+				$name = strtoupper($name);
+
+				if ($ADODB_ACTIVE_DEFVALS && isset($fldobj->default_value)) {
+					$this->$name = $fldobj->default_value;
+				}
+				else {
+					$this->$name = null;
+				}
+				$attr[$name] = $fldobj;
+			}
+
+			foreach($pkeys as $k => $name) {
+				$keys[strtoupper($name)] = strtoupper($name);
+			}
+			break;
+		default:
+			foreach($cols as $name => $fldobj) {
+				$name = ($fldobj->name);
+
+				if ($ADODB_ACTIVE_DEFVALS && isset($fldobj->default_value)) {
+					$this->$name = $fldobj->default_value;
+				}
+				else {
+					$this->$name = null;
+				}
+				$attr[$name] = $fldobj;
+			}
+			foreach($pkeys as $k => $name) {
+				$keys[$name] = $cols[$name]->name;
+			}
+			break;
+		}
+
+		$activetab->keys = $keys;
+		$activetab->flds = $attr;
+		$activetab->updateColsCount();
+
+		if ($ADODB_ACTIVE_CACHESECS && $ADODB_CACHE_DIR) {
+			$activetab->_created = time();
+			$s = serialize($activetab);
+			if (!function_exists('adodb_write_file')) {
+				include(ADODB_DIR.'/adodb-csvlib.inc.php');
+			}
+			adodb_write_file($fname,$s);
+		}
+		if (isset($activedb->tables[$table])) {
+			$oldtab = $activedb->tables[$table];
+
+			if ($oldtab) {
+				$activetab->_belongsTo = $oldtab->_belongsTo;
+				$activetab->_hasMany = $oldtab->_hasMany;
+			}
+		}
+		$activedb->tables[$table] = $activetab;
+	}
+
+	function GetPrimaryKeys(&$db, $table)
+	{
+		return $db->MetaPrimaryKeys($table);
+	}
+
+	// error handler for both PHP4+5.
+	function Error($err,$fn)
+	{
+	global $_ADODB_ACTIVE_DBS;
+
+		$fn = get_class($this).'::'.$fn;
+		$this->_lasterr = $fn.': '.$err;
+
+		if ($this->_dbat < 0) {
+			$db = false;
+		}
+		else {
+			$activedb = $_ADODB_ACTIVE_DBS[$this->_dbat];
+			$db = $activedb->db;
+		}
+
+		if (function_exists('adodb_throw')) {
+			if (!$db) {
+				adodb_throw('ADOdb_Active_Record', $fn, -1, $err, 0, 0, false);
+			}
+			else {
+				adodb_throw($db->databaseType, $fn, -1, $err, 0, 0, $db);
+			}
+		} else {
+			if (!$db || $db->debug) {
+				ADOConnection::outp($this->_lasterr);
+			}
+		}
+
+	}
+
+	// return last error message
+	function ErrorMsg()
+	{
+		if (!function_exists('adodb_throw')) {
+			if ($this->_dbat < 0) {
+				$db = false;
+			}
+			else {
+				$db = $this->DB();
+			}
+
+			// last error could be database error too
+			if ($db && $db->ErrorMsg()) {
+				return $db->ErrorMsg();
+			}
+		}
+		return $this->_lasterr;
+	}
+
+	function ErrorNo()
+	{
+		if ($this->_dbat < 0) {
+			return -9999; // no database connection...
+		}
+		$db = $this->DB();
+
+		return (int) $db->ErrorNo();
+	}
+
+
+	// retrieve ADOConnection from _ADODB_Active_DBs
+	function DB()
+	{
+	global $_ADODB_ACTIVE_DBS;
+
+		if ($this->_dbat < 0) {
+			$false = false;
+			$this->Error("No database connection set: use ADOdb_Active_Record::SetDatabaseAdaptor(\$db)", "DB");
+			return $false;
+		}
+		$activedb = $_ADODB_ACTIVE_DBS[$this->_dbat];
+		$db = $activedb->db;
+		return $db;
+	}
+
+	// retrieve ADODB_Active_Table
+	function &TableInfo()
+	{
+	global $_ADODB_ACTIVE_DBS;
+
+		$activedb = $_ADODB_ACTIVE_DBS[$this->_dbat];
+		$table = $activedb->tables[$this->_tableat];
+		return $table;
+	}
+
+
+	// I have an ON INSERT trigger on a table that sets other columns in the table.
+	// So, I find that for myTable, I want to reload an active record after saving it. -- Malcolm Cook
+	function Reload()
+	{
+		$db =& $this->DB();
+		if (!$db) {
+			return false;
+		}
+		$table =& $this->TableInfo();
+		$where = $this->GenWhere($db, $table);
+		return($this->Load($where));
+	}
+
+
+	// set a numeric array (using natural table field ordering) as object properties
+	function Set(&$row)
+	{
+	global $ACTIVE_RECORD_SAFETY;
+
+		$db = $this->DB();
+
+		if (!$row) {
+			$this->_saved = false;
+			return false;
+		}
+
+		$this->_saved = true;
+
+		$table = $this->TableInfo();
+		$sizeofFlds = sizeof($table->flds);
+		$sizeofRow  = sizeof($row);
+		if ($ACTIVE_RECORD_SAFETY && $table->_colsCount != $sizeofRow && $sizeofFlds != $sizeofRow) {
+			# <AP>
+			$bad_size = TRUE;
+			if($sizeofRow == 2 * $table->_colsCount || $sizeofRow == 2 * $sizeofFlds) {
+				// Only keep string keys
+				$keys = array_filter(array_keys($row), 'is_string');
+				if (sizeof($keys) == sizeof($table->flds)) {
+					$bad_size = FALSE;
+				}
+			}
+			if ($bad_size) {
+				$this->Error("Table structure of $this->_table has changed","Load");
+				return false;
+			}
+			# </AP>
+		}
+		else {
+			$keys = array_keys($row);
+		}
+
+		# <AP>
+		reset($keys);
+		$this->_original = array();
+		foreach($table->flds as $name=>$fld) {
+			$value = $row[current($keys)];
+			$this->$name = $value;
+			$this->_original[] = $value;
+			if(!next($keys)) {
+				break;
+			}
+		}
+		$table =& $this->TableInfo();
+		foreach($table->_belongsTo as $foreignTable) {
+			$ft = $foreignTable->TableInfo();
+			$propertyName = $ft->name;
+			foreach($ft->flds as $name=>$fld) {
+				$value = $row[current($keys)];
+				$foreignTable->$name = $value;
+				$foreignTable->_original[] = $value;
+				if(!next($keys)) {
+					break;
+				}
+			}
+		}
+		foreach($table->_hasMany as $foreignTable) {
+			$ft = $foreignTable->TableInfo();
+			foreach($ft->flds as $name=>$fld) {
+				$value = $row[current($keys)];
+				$foreignTable->$name = $value;
+				$foreignTable->_original[] = $value;
+				if(!next($keys)) {
+					break;
+				}
+			}
+		}
+		# </AP>
+
+		return true;
+	}
+
+	// get last inserted id for INSERT
+	function LastInsertID(&$db,$fieldname)
+	{
+		if ($db->hasInsertID) {
+			$val = $db->Insert_ID($this->_table,$fieldname);
+		}
+		else {
+			$val = false;
+		}
+
+		if (is_null($val) || $val === false) {
+			// this might not work reliably in multi-user environment
+			return $db->GetOne("select max(".$fieldname.") from ".$this->_table);
+		}
+		return $val;
+	}
+
+	// quote data in where clause
+	function doquote(&$db, $val,$t)
+	{
+		switch($t) {
+		case 'D':
+		case 'T':
+			if (empty($val)) {
+				return 'null';
+			}
+		case 'C':
+		case 'X':
+			if (is_null($val)) {
+				return 'null';
+			}
+			if (strlen($val)>0 &&
+				(strncmp($val,"'",1) != 0 || substr($val,strlen($val)-1,1) != "'")
+			) {
+				return $db->qstr($val);
+				break;
+			}
+		default:
+			return $val;
+			break;
+		}
+	}
+
+	// generate where clause for an UPDATE/SELECT
+	function GenWhere(&$db, &$table)
+	{
+		$keys = $table->keys;
+		$parr = array();
+
+		foreach($keys as $k) {
+			$f = $table->flds[$k];
+			if ($f) {
+				$parr[] = $k.' = '.$this->doquote($db,$this->$k,$db->MetaType($f->type));
+			}
+		}
+		return implode(' and ', $parr);
+	}
+
+
+	//------------------------------------------------------------ Public functions below
+
+	function Load($where=null,$bindarr=false)
+	{
+		$db = $this->DB();
+		if (!$db) {
+			return false;
+		}
+		$this->_where = $where;
+
+		$save = $db->SetFetchMode(ADODB_FETCH_NUM);
+		$qry = "select * from ".$this->_table;
+		$table =& $this->TableInfo();
+
+		if(($k = reset($table->keys))) {
+			$hasManyId   = $k;
+		}
+		else {
+			$hasManyId   = 'id';
+		}
+
+		foreach($table->_belongsTo as $foreignTable) {
+			if(($k = reset($foreignTable->TableInfo()->keys))) {
+				$belongsToId = $k;
+			}
+			else {
+				$belongsToId = 'id';
+			}
+			$qry .= ' LEFT JOIN '.$foreignTable->_table.' ON '.
+				$this->_table.'.'.$foreignTable->foreignKey.'='.
+				$foreignTable->_table.'.'.$belongsToId;
+		}
+		foreach($table->_hasMany as $foreignTable)
+		{
+			$qry .= ' LEFT JOIN '.$foreignTable->_table.' ON '.
+				$this->_table.'.'.$hasManyId.'='.
+				$foreignTable->_table.'.'.$foreignTable->foreignKey;
+		}
+		if($where) {
+			$qry .= ' WHERE '.$where;
+		}
+
+		// Simple case: no relations. Load row and return.
+		if((count($table->_hasMany) + count($table->_belongsTo)) < 1) {
+			$row = $db->GetRow($qry,$bindarr);
+			if(!$row) {
+				return false;
+			}
+			$db->SetFetchMode($save);
+			return $this->Set($row);
+		}
+
+		// More complex case when relations have to be collated
+		$rows = $db->GetAll($qry,$bindarr);
+		if(!$rows) {
+			return false;
+		}
+		$db->SetFetchMode($save);
+		if(count($rows) < 1) {
+			return false;
+		}
+		$class = get_class($this);
+		$isFirstRow = true;
+
+		if(($k = reset($this->TableInfo()->keys))) {
+			$myId   = $k;
+		}
+		else {
+			$myId   = 'id';
+		}
+		$index = 0; $found = false;
+		/** @todo Improve by storing once and for all in table metadata */
+		/** @todo Also re-use info for hasManyId */
+		foreach($this->TableInfo()->flds as $fld) {
+			if($fld->name == $myId) {
+				$found = true;
+				break;
+			}
+			$index++;
+		}
+		if(!$found) {
+			$this->outp_throw("Unable to locate key $myId for $class in Load()",'Load');
+		}
+
+		foreach($rows as $row) {
+			$rowId = intval($row[$index]);
+			if($rowId > 0) {
+				if($isFirstRow) {
+					$isFirstRow = false;
+					if(!$this->Set($row)) {
+						return false;
+					}
+				}
+				$obj = new $class($table,false,$db);
+				$obj->Set($row);
+				// TODO Copy/paste code below: bad!
+				if(count($table->_hasMany) > 0) {
+					foreach($table->_hasMany as $foreignTable) {
+						$foreignName = $foreignTable->foreignName;
+						if(!empty($obj->$foreignName)) {
+							if(!is_array($this->$foreignName)) {
+								$foreignObj = $this->$foreignName;
+								$this->$foreignName = array(clone($foreignObj));
+							}
+							else {
+								$foreignObj = $obj->$foreignName;
+								array_push($this->$foreignName, clone($foreignObj));
+							}
+						}
+					}
+				}
+				if(count($table->_belongsTo) > 0) {
+					foreach($table->_belongsTo as $foreignTable) {
+						$foreignName = $foreignTable->foreignName;
+						if(!empty($obj->$foreignName)) {
+							if(!is_array($this->$foreignName)) {
+								$foreignObj = $this->$foreignName;
+								$this->$foreignName = array(clone($foreignObj));
+							}
+							else {
+								$foreignObj = $obj->$foreignName;
+								array_push($this->$foreignName, clone($foreignObj));
+							}
+						}
+					}
+				}
+			}
+		}
+		return true;
+	}
+
+	// false on error
+	function Save()
+	{
+		if ($this->_saved) {
+			$ok = $this->Update();
+		}
+		else {
+			$ok = $this->Insert();
+		}
+
+		return $ok;
+	}
+
+	// CFR: Sometimes we may wish to consider that an object is not to be replaced but inserted.
+	// Sample use case: an 'undo' command object (after a delete())
+	function Dirty()
+	{
+		$this->_saved = false;
+	}
+
+	// false on error
+	function Insert()
+	{
+		$db = $this->DB();
+		if (!$db) {
+			return false;
+		}
+		$cnt = 0;
+		$table = $this->TableInfo();
+
+		$valarr = array();
+		$names = array();
+		$valstr = array();
+
+		foreach($table->flds as $name=>$fld) {
+			$val = $this->$name;
+			if(!is_null($val) || !array_key_exists($name, $table->keys)) {
+				$valarr[] = $val;
+				$names[] = $name;
+				$valstr[] = $db->Param($cnt);
+				$cnt += 1;
+			}
+		}
+
+		if (empty($names)){
+			foreach($table->flds as $name=>$fld) {
+				$valarr[] = null;
+				$names[] = $name;
+				$valstr[] = $db->Param($cnt);
+				$cnt += 1;
+			}
+		}
+		$sql = 'INSERT INTO '.$this->_table."(".implode(',',$names).') VALUES ('.implode(',',$valstr).')';
+		$ok = $db->Execute($sql,$valarr);
+
+		if ($ok) {
+			$this->_saved = true;
+			$autoinc = false;
+			foreach($table->keys as $k) {
+				if (is_null($this->$k)) {
+					$autoinc = true;
+					break;
+				}
+			}
+			if ($autoinc && sizeof($table->keys) == 1) {
+				$k = reset($table->keys);
+				$this->$k = $this->LastInsertID($db,$k);
+			}
+		}
+
+		$this->_original = $valarr;
+		return !empty($ok);
+	}
+
+	function Delete()
+	{
+		$db = $this->DB();
+		if (!$db) {
+			return false;
+		}
+		$table = $this->TableInfo();
+
+		$where = $this->GenWhere($db,$table);
+		$sql = 'DELETE FROM '.$this->_table.' WHERE '.$where;
+		$ok = $db->Execute($sql);
+
+		return $ok ? true : false;
+	}
+
+	// returns an array of active record objects
+	function Find($whereOrderBy,$bindarr=false,$pkeysArr=false,$extra=array())
+	{
+		$db = $this->DB();
+		if (!$db || empty($this->_table)) {
+			return false;
+		}
+		$table =& $this->TableInfo();
+		$arr = $db->GetActiveRecordsClass(get_class($this),$this, $whereOrderBy,$bindarr,$pkeysArr,$extra,
+			array('foreignName'=>$this->foreignName, 'belongsTo'=>$table->_belongsTo, 'hasMany'=>$table->_hasMany));
+		return $arr;
+	}
+
+	// CFR: In introduced this method to ensure that inner workings are not disturbed by
+	// subclasses...for instance when GetActiveRecordsClass invokes Find()
+	// Why am I not invoking parent::Find?
+	// Shockingly because I want to preserve PHP4 compatibility.
+	function packageFind($whereOrderBy,$bindarr=false,$pkeysArr=false,$extra=array())
+	{
+		$db = $this->DB();
+		if (!$db || empty($this->_table)) {
+			return false;
+		}
+		$table =& $this->TableInfo();
+		$arr = $db->GetActiveRecordsClass(get_class($this),$this, $whereOrderBy,$bindarr,$pkeysArr,$extra,
+			array('foreignName'=>$this->foreignName, 'belongsTo'=>$table->_belongsTo, 'hasMany'=>$table->_hasMany));
+		return $arr;
+	}
+
+	// returns 0 on error, 1 on update, 2 on insert
+	function Replace()
+	{
+	global $ADODB_ASSOC_CASE;
+
+		$db = $this->DB();
+		if (!$db) {
+			return false;
+		}
+		$table = $this->TableInfo();
+
+		$pkey = $table->keys;
+
+		foreach($table->flds as $name=>$fld) {
+			$val = $this->$name;
+			/*
+			if (is_null($val)) {
+				if (isset($fld->not_null) && $fld->not_null) {
+					if (isset($fld->default_value) && strlen($fld->default_value)) {
+						continue;
+					}
+					else {
+						$this->Error("Cannot update null into $name","Replace");
+						return false;
+					}
+				}
+			}*/
+			if (is_null($val) && !empty($fld->auto_increment)) {
+				continue;
+			}
+			$t = $db->MetaType($fld->type);
+			$arr[$name] = $this->doquote($db,$val,$t);
+			$valarr[] = $val;
+		}
+
+		if (!is_array($pkey)) {
+			$pkey = array($pkey);
+		}
+
+
+		switch ($ADODB_ASSOC_CASE == 0) {
+			case ADODB_ASSOC_CASE_LOWER:
+				foreach($pkey as $k => $v) {
+					$pkey[$k] = strtolower($v);
+				}
+				break;
+			case ADODB_ASSOC_CASE_UPPER:
+				foreach($pkey as $k => $v) {
+					$pkey[$k] = strtoupper($v);
+				}
+				break;
+		}
+
+		$ok = $db->Replace($this->_table,$arr,$pkey);
+		if ($ok) {
+			$this->_saved = true; // 1= update 2=insert
+			if ($ok == 2) {
+				$autoinc = false;
+				foreach($table->keys as $k) {
+					if (is_null($this->$k)) {
+						$autoinc = true;
+						break;
+					}
+				}
+				if ($autoinc && sizeof($table->keys) == 1) {
+					$k = reset($table->keys);
+					$this->$k = $this->LastInsertID($db,$k);
+				}
+			}
+
+			$this->_original = $valarr;
+		}
+		return $ok;
+	}
+
+	// returns 0 on error, 1 on update, -1 if no change in data (no update)
+	function Update()
+	{
+		$db = $this->DB();
+		if (!$db) {
+			return false;
+		}
+		$table = $this->TableInfo();
+
+		$where = $this->GenWhere($db, $table);
+
+		if (!$where) {
+			$this->error("Where missing for table $table", "Update");
+			return false;
+		}
+		$valarr = array();
+		$neworig = array();
+		$pairs = array();
+		$i = -1;
+		$cnt = 0;
+		foreach($table->flds as $name=>$fld) {
+			$i += 1;
+			$val = $this->$name;
+			$neworig[] = $val;
+
+			if (isset($table->keys[$name])) {
+				continue;
+			}
+
+			if (is_null($val)) {
+				if (isset($fld->not_null) && $fld->not_null) {
+					if (isset($fld->default_value) && strlen($fld->default_value)) {
+						continue;
+					}
+					else {
+						$this->Error("Cannot set field $name to NULL","Update");
+						return false;
+					}
+				}
+			}
+
+			if (isset($this->_original[$i]) && $val === $this->_original[$i]) {
+				continue;
+			}
+			$valarr[] = $val;
+			$pairs[] = $name.'='.$db->Param($cnt);
+			$cnt += 1;
+		}
+
+
+		if (!$cnt) {
+			return -1;
+		}
+		$sql = 'UPDATE '.$this->_table." SET ".implode(",",$pairs)." WHERE ".$where;
+		$ok = $db->Execute($sql,$valarr);
+		if ($ok) {
+			$this->_original = $neworig;
+			return 1;
+		}
+		return 0;
+	}
+
+	function GetAttributeNames()
+	{
+		$table = $this->TableInfo();
+		if (!$table) {
+			return false;
+		}
+		return array_keys($table->flds);
+	}
+
+};
+
+function adodb_GetActiveRecordsClass(&$db, $class, $tableObj,$whereOrderBy,$bindarr, $primkeyArr,
+			$extra, $relations)
+{
+	global $_ADODB_ACTIVE_DBS;
+
+		if (empty($extra['loading'])) {
+			$extra['loading'] = ADODB_LAZY_AR;
+		}
+		$save = $db->SetFetchMode(ADODB_FETCH_NUM);
+		$table = &$tableObj->_table;
+		$tableInfo =& $tableObj->TableInfo();
+		if(($k = reset($tableInfo->keys))) {
+			$myId = $k;
+		}
+		else {
+			$myId = 'id';
+		}
+		$index = 0; $found = false;
+		/** @todo Improve by storing once and for all in table metadata */
+		/** @todo Also re-use info for hasManyId */
+		foreach($tableInfo->flds as $fld)
+		{
+			if($fld->name == $myId) {
+				$found = true;
+				break;
+			}
+			$index++;
+		}
+		if(!$found) {
+			$db->outp_throw("Unable to locate key $myId for $class in GetActiveRecordsClass()",'GetActiveRecordsClass');
+		}
+
+		$qry = "select * from ".$table;
+		if(ADODB_JOIN_AR == $extra['loading']) {
+			if(!empty($relations['belongsTo'])) {
+				foreach($relations['belongsTo'] as $foreignTable) {
+					if(($k = reset($foreignTable->TableInfo()->keys))) {
+						$belongsToId = $k;
+					}
+					else {
+						$belongsToId = 'id';
+					}
+
+					$qry .= ' LEFT JOIN '.$foreignTable->_table.' ON '.
+						$table.'.'.$foreignTable->foreignKey.'='.
+						$foreignTable->_table.'.'.$belongsToId;
+				}
+			}
+			if(!empty($relations['hasMany'])) {
+				if(empty($relations['foreignName'])) {
+					$db->outp_throw("Missing foreignName is relation specification in GetActiveRecordsClass()",'GetActiveRecordsClass');
+				}
+				if(($k = reset($tableInfo->keys))) {
+					$hasManyId   = $k;
+				}
+				else {
+					$hasManyId   = 'id';
+				}
+
+				foreach($relations['hasMany'] as $foreignTable) {
+					$qry .= ' LEFT JOIN '.$foreignTable->_table.' ON '.
+						$table.'.'.$hasManyId.'='.
+						$foreignTable->_table.'.'.$foreignTable->foreignKey;
+				}
+			}
+		}
+		if (!empty($whereOrderBy)) {
+			$qry .= ' WHERE '.$whereOrderBy;
+		}
+		if(isset($extra['limit'])) {
+			$rows = false;
+			if(isset($extra['offset'])) {
+				$rs = $db->SelectLimit($qry, $extra['limit'], $extra['offset']);
+			} else {
+				$rs = $db->SelectLimit($qry, $extra['limit']);
+			}
+			if ($rs) {
+				while (!$rs->EOF) {
+					$rows[] = $rs->fields;
+					$rs->MoveNext();
+				}
+			}
+		} else
+			$rows = $db->GetAll($qry,$bindarr);
+
+		$db->SetFetchMode($save);
+
+		$false = false;
+
+		if ($rows === false) {
+			return $false;
+		}
+
+
+		if (!isset($_ADODB_ACTIVE_DBS)) {
+			include(ADODB_DIR.'/adodb-active-record.inc.php');
+		}
+		if (!class_exists($class)) {
+			$db->outp_throw("Unknown class $class in GetActiveRecordsClass()",'GetActiveRecordsClass');
+			return $false;
+		}
+		$uniqArr = array(); // CFR Keep track of records for relations
+		$arr = array();
+		// arrRef will be the structure that knows about our objects.
+		// It is an associative array.
+		// We will, however, return arr, preserving regular 0.. order so that
+		// obj[0] can be used by app developpers.
+		$arrRef = array();
+		$bTos = array(); // Will store belongTo's indices if any
+		foreach($rows as $row) {
+
+			$obj = new $class($table,$primkeyArr,$db);
+			if ($obj->ErrorNo()){
+				$db->_errorMsg = $obj->ErrorMsg();
+				return $false;
+			}
+			$obj->Set($row);
+			// CFR: FIXME: Insane assumption here:
+			// If the first column returned is an integer, then it's a 'id' field
+			// And to make things a bit worse, I use intval() rather than is_int() because, in fact,
+			// $row[0] is not an integer.
+			//
+			// So, what does this whole block do?
+			// When relationships are found, we perform JOINs. This is fast. But not accurate:
+			// instead of returning n objects with their n' associated cousins,
+			// we get n*n' objects. This code fixes this.
+			// Note: to-many relationships mess around with the 'limit' parameter
+			$rowId = intval($row[$index]);
+
+			if(ADODB_WORK_AR == $extra['loading']) {
+				$arrRef[$rowId] = $obj;
+				$arr[] = &$arrRef[$rowId];
+				if(!isset($indices)) {
+					$indices = $rowId;
+				}
+				else {
+					$indices .= ','.$rowId;
+				}
+				if(!empty($relations['belongsTo'])) {
+					foreach($relations['belongsTo'] as $foreignTable) {
+						$foreignTableRef = $foreignTable->foreignKey;
+						// First array: list of foreign ids we are looking for
+						if(empty($bTos[$foreignTableRef])) {
+							$bTos[$foreignTableRef] = array();
+						}
+						// Second array: list of ids found
+						if(empty($obj->$foreignTableRef)) {
+							continue;
+						}
+						if(empty($bTos[$foreignTableRef][$obj->$foreignTableRef])) {
+							$bTos[$foreignTableRef][$obj->$foreignTableRef] = array();
+						}
+						$bTos[$foreignTableRef][$obj->$foreignTableRef][] = $obj;
+					}
+				}
+				continue;
+			}
+
+			if($rowId>0) {
+				if(ADODB_JOIN_AR == $extra['loading']) {
+					$isNewObj = !isset($uniqArr['_'.$row[0]]);
+					if($isNewObj) {
+						$uniqArr['_'.$row[0]] = $obj;
+					}
+
+					// TODO Copy/paste code below: bad!
+					if(!empty($relations['hasMany'])) {
+						foreach($relations['hasMany'] as $foreignTable) {
+							$foreignName = $foreignTable->foreignName;
+							if(!empty($obj->$foreignName)) {
+								$masterObj = &$uniqArr['_'.$row[0]];
+								// Assumption: this property exists in every object since they are instances of the same class
+								if(!is_array($masterObj->$foreignName)) {
+									// Pluck!
+									$foreignObj = $masterObj->$foreignName;
+									$masterObj->$foreignName = array(clone($foreignObj));
+								}
+								else {
+									// Pluck pluck!
+									$foreignObj = $obj->$foreignName;
+									array_push($masterObj->$foreignName, clone($foreignObj));
+								}
+							}
+						}
+					}
+					if(!empty($relations['belongsTo'])) {
+						foreach($relations['belongsTo'] as $foreignTable) {
+							$foreignName = $foreignTable->foreignName;
+							if(!empty($obj->$foreignName)) {
+								$masterObj = &$uniqArr['_'.$row[0]];
+								// Assumption: this property exists in every object since they are instances of the same class
+								if(!is_array($masterObj->$foreignName)) {
+									// Pluck!
+									$foreignObj = $masterObj->$foreignName;
+									$masterObj->$foreignName = array(clone($foreignObj));
+								}
+								else {
+									// Pluck pluck!
+									$foreignObj = $obj->$foreignName;
+									array_push($masterObj->$foreignName, clone($foreignObj));
+								}
+							}
+						}
+					}
+					if(!$isNewObj) {
+						unset($obj); // We do not need this object itself anymore and do not want it re-added to the main array
+					}
+				}
+				else if(ADODB_LAZY_AR == $extra['loading']) {
+					// Lazy loading: we need to give AdoDb a hint that we have not really loaded
+					// anything, all the while keeping enough information on what we wish to load.
+					// Let's do this by keeping the relevant info in our relationship arrays
+					// but get rid of the actual properties.
+					// We will then use PHP's __get to load these properties on-demand.
+					if(!empty($relations['hasMany'])) {
+						foreach($relations['hasMany'] as $foreignTable) {
+							$foreignName = $foreignTable->foreignName;
+							if(!empty($obj->$foreignName)) {
+								unset($obj->$foreignName);
+							}
+						}
+					}
+					if(!empty($relations['belongsTo'])) {
+						foreach($relations['belongsTo'] as $foreignTable) {
+							$foreignName = $foreignTable->foreignName;
+							if(!empty($obj->$foreignName)) {
+								unset($obj->$foreignName);
+							}
+						}
+					}
+				}
+			}
+
+			if(isset($obj)) {
+				$arr[] = $obj;
+			}
+		}
+
+		if(ADODB_WORK_AR == $extra['loading']) {
+			// The best of both worlds?
+			// Here, the number of queries is constant: 1 + n*relationship.
+			// The second query will allow us to perform a good join
+			// while preserving LIMIT etc.
+			if(!empty($relations['hasMany'])) {
+				foreach($relations['hasMany'] as $foreignTable) {
+					$foreignName = $foreignTable->foreignName;
+					$className = ucfirst($foreignTable->_singularize($foreignName));
+					$obj = new $className();
+					$dbClassRef = $foreignTable->foreignKey;
+					$objs = $obj->packageFind($dbClassRef.' IN ('.$indices.')');
+					foreach($objs as $obj) {
+						if(!is_array($arrRef[$obj->$dbClassRef]->$foreignName)) {
+							$arrRef[$obj->$dbClassRef]->$foreignName = array();
+						}
+						array_push($arrRef[$obj->$dbClassRef]->$foreignName, $obj);
+					}
+				}
+
+			}
+			if(!empty($relations['belongsTo'])) {
+				foreach($relations['belongsTo'] as $foreignTable) {
+					$foreignTableRef = $foreignTable->foreignKey;
+					if(empty($bTos[$foreignTableRef])) {
+						continue;
+					}
+					if(($k = reset($foreignTable->TableInfo()->keys))) {
+						$belongsToId = $k;
+					}
+					else {
+						$belongsToId = 'id';
+					}
+					$origObjsArr = $bTos[$foreignTableRef];
+					$bTosString = implode(',', array_keys($bTos[$foreignTableRef]));
+					$foreignName = $foreignTable->foreignName;
+					$className = ucfirst($foreignTable->_singularize($foreignName));
+					$obj = new $className();
+					$objs = $obj->packageFind($belongsToId.' IN ('.$bTosString.')');
+					foreach($objs as $obj)
+					{
+						foreach($origObjsArr[$obj->$belongsToId] as $idx=>$origObj)
+						{
+							$origObj->$foreignName = $obj;
+						}
+					}
+				}
+			}
+		}
+
+		return $arr;
+}