t3lib_sqlengine Class Reference

Inheritance diagram for t3lib_sqlengine:

Inheritance graph
[legend]
Collaboration diagram for t3lib_sqlengine:

Collaboration graph
[legend]
List of all members.

Public Member Functions

 init ($config, $pObj)
 resetStatusVars ()
 processAccordingToConfig (&$value, $fInfo)
 exec_INSERTquery ($table, $fields_values)
 exec_UPDATEquery ($table, $where, $fields_values)
 exec_DELETEquery ($table, $where)
 exec_SELECTquery ($select_fields, $from_table, $where_clause, $groupBy, $orderBy, $limit)
 sql_query ($query)
 sql_error ()
 sql_insert_id ()
 sql_affected_rows ()
 quoteStr ($str)
 admin_get_tables ()
 admin_get_fields ($tableName)
 admin_get_keys ($tableName)
 admin_query ($query)
 readDataSource ($table)
 saveDataSource ($table)
 selectFromData ($table, $where)
 select_evalSingle ($table, $config, &$itemKeys)
 getResultSet ($keys, $table, $fieldList)
 debug_printResultSet ($array)

Public Attributes

 $data = array()
 $errorStatus = ''
 $lastInsertedId = 0
 $lastAffectedRows = 0

Detailed Description

Definition at line 104 of file class.t3lib_sqlengine.php.

Member Function Documentation

t3lib_sqlengine::admin_get_fields ( $  tableName  ) 

(DUMMY) Returns information about each field in the $table

Parameters:
string Table name
Returns:
array Field information in an associative array with fieldname => field row

Definition at line 502 of file class.t3lib_sqlengine.php.

Referenced by exec_INSERTquery(), and exec_UPDATEquery().

t3lib_sqlengine::admin_get_keys ( $  tableName  ) 

(DUMMY) Returns information about each index key in the $table

Parameters:
string Table name
Returns:
array Key information in a numeric array

Definition at line 513 of file class.t3lib_sqlengine.php.

t3lib_sqlengine::admin_get_tables (  ) 

(DUMMY) Returns the list of tables from the database

Returns:
array Tables in an array (tablename is in both key and value)
Todo:
Should return table details in value! see t3lib_db::admin_get_tables()

Definition at line 491 of file class.t3lib_sqlengine.php.

t3lib_sqlengine::admin_query ( $  query  ) 

(DUMMY) mysql() wrapper function, used by the Install Tool and EM for all queries regarding management of the database!

Parameters:
string Query to execute
Returns:
pointer Result pointer

Definition at line 524 of file class.t3lib_sqlengine.php.

References sql_query().

t3lib_sqlengine::debug_printResultSet ( $  array  ) 

Returns the result set (in array) as HTML table. For debugging.

Parameters:
array Result set array (array of rows)
Returns:
string HTML table

Definition at line 791 of file class.t3lib_sqlengine.php.

t3lib_sqlengine::exec_DELETEquery ( $  table,
$  where 
)

Execute DELETE query

Parameters:
string Table to delete from
string WHERE clause
Returns:
boolean TRUE on success and FALSE on failure (error is set internally)

Definition at line 332 of file class.t3lib_sqlengine.php.

References t3lib_sqlparser::parseWhereClause(), readDataSource(), resetStatusVars(), saveDataSource(), and selectFromData().

t3lib_sqlengine::exec_INSERTquery ( $  table,
$  fields_values 
)

Execute an INSERT query

Parameters:
string Table name
array Field values as key=>value pairs.
Returns:
boolean TRUE on success and FALSE on failure (error is set internally)

Definition at line 205 of file class.t3lib_sqlengine.php.

References admin_get_fields(), processAccordingToConfig(), readDataSource(), resetStatusVars(), and saveDataSource().

t3lib_sqlengine::exec_SELECTquery ( $  select_fields,
$  from_table,
$  where_clause,
$  groupBy,
$  orderBy,
$  limit 
)

Execute SELECT query

Parameters:
string List of fields to select from the table. This is what comes right after "SELECT ...". Required value.
string Table(s) from which to select. This is what comes right after "FROM ...". Required value.
string Optional additional WHERE clauses put in the end of the query. NOTICE: You must escape values in this argument with $this->fullQuoteStr() yourself! DO NOT PUT IN GROUP BY, ORDER BY or LIMIT!
string Optional GROUP BY field(s), if none, supply blank string.
string Optional ORDER BY field(s), if none, supply blank string.
string Optional LIMIT value ([begin,]max), if none, supply blank string.
Returns:
object Returns result object, but if errors, returns false

Definition at line 383 of file class.t3lib_sqlengine.php.

References getResultSet(), t3lib_div::makeInstance(), t3lib_sqlparser::parseFromTables(), t3lib_sqlparser::parseWhereClause(), readDataSource(), resetStatusVars(), and selectFromData().

t3lib_sqlengine::exec_UPDATEquery ( $  table,
$  where,
$  fields_values 
)

Execute UPDATE query on table

Parameters:
string Table name
string WHERE clause
array Field values as key=>value pairs.
Returns:
boolean TRUE on success and FALSE on failure (error is set internally)

Definition at line 273 of file class.t3lib_sqlengine.php.

References admin_get_fields(), t3lib_sqlparser::parseWhereClause(), processAccordingToConfig(), readDataSource(), resetStatusVars(), saveDataSource(), and selectFromData().

t3lib_sqlengine::getResultSet ( $  keys,
$  table,
$  fieldList 
)

Returning result set based on result keys, table and field list

Parameters:
array Result keys
string Tablename
string Fieldlist (commaseparated)
Returns:
array Result array with "rows"

Definition at line 748 of file class.t3lib_sqlengine.php.

References t3lib_div::trimExplode().

Referenced by exec_SELECTquery().

t3lib_sqlengine::init ( $  config,
$  pObj 
)

Dummy function for initializing SQL handler. Create you own in derived classes.

Parameters:
array Configuration array from handler
object Parent object
Returns:
void

Definition at line 126 of file class.t3lib_sqlengine.php.

t3lib_sqlengine::processAccordingToConfig ( &$  value,
$  fInfo 
)

Processing of update/insert values based on field type.

The input value is typecast and trimmed/shortened according to the field type and the configuration options from the $fInfo parameter.

Parameters:
mixed $value The input value to process
array $fInfo Field configuration data
Returns:
mixed The processed input value

Definition at line 150 of file class.t3lib_sqlengine.php.

References $value, t3lib_div::intInRange(), and t3lib_sqlparser::parseFieldDef().

Referenced by exec_INSERTquery(), and exec_UPDATEquery().

t3lib_sqlengine::quoteStr ( $  str  ) 

Quoting strings for insertion in SQL queries

Parameters:
string Input String
Returns:
string String, with quotes escaped

Definition at line 465 of file class.t3lib_sqlengine.php.

t3lib_sqlengine::readDataSource ( $  table  ) 

Dummy function for setting table data. Create your own. NOTICE: Handler to "table-locking" needs to be made probably!

Parameters:
string Table name
Returns:
void
Todo:
Table locking tools?

Definition at line 549 of file class.t3lib_sqlengine.php.

Referenced by exec_DELETEquery(), exec_INSERTquery(), exec_SELECTquery(), and exec_UPDATEquery().

t3lib_sqlengine::resetStatusVars (  ) 

Reset SQL engine status variables (insert id, affected rows, error status)

Returns:
void

Definition at line 134 of file class.t3lib_sqlengine.php.

Referenced by exec_DELETEquery(), exec_INSERTquery(), exec_SELECTquery(), and exec_UPDATEquery().

t3lib_sqlengine::saveDataSource ( $  table  ) 

Dummy function for setting table data. Create your own. NOTICE: Handler to "table-locking" needs to be made probably!

Parameters:
string Table name
Returns:
void
Todo:
Table locking tools?

Definition at line 561 of file class.t3lib_sqlengine.php.

References debug().

Referenced by exec_DELETEquery(), exec_INSERTquery(), and exec_UPDATEquery().

t3lib_sqlengine::select_evalSingle ( $  table,
$  config,
&$  itemKeys 
)

Evalutaion of a WHERE-clause-array. Yet EXPERIMENTAL

Parameters:
string Tablename
array WHERE-configuration array
array Data array to work on.
Returns:
void Data array passed by reference
See also:
selectFromData()

Definition at line 629 of file class.t3lib_sqlengine.php.

References selectFromData().

Referenced by selectFromData().

t3lib_sqlengine::selectFromData ( $  table,
$  where 
)

PHP simulation of SQL "SELECT" Yet EXPERIMENTAL!

Parameters:
string Table name
array Where clause parsed into array
Returns:
array Array of keys pointing to result rows in $this->data[$table]

Definition at line 591 of file class.t3lib_sqlengine.php.

References select_evalSingle().

Referenced by exec_DELETEquery(), exec_SELECTquery(), exec_UPDATEquery(), and select_evalSingle().

t3lib_sqlengine::sql_affected_rows (  ) 

Returns affected rows (of UPDATE and DELETE queries)

Returns:
integer Last amount of affected rows.

Definition at line 455 of file class.t3lib_sqlengine.php.

t3lib_sqlengine::sql_error (  ) 

Returns most recent error

Returns:
string Error message, if any

Definition at line 437 of file class.t3lib_sqlengine.php.

t3lib_sqlengine::sql_insert_id (  ) 

Returns most recently create unique ID (of INSERT queries)

Returns:
integer Last unique id created.

Definition at line 446 of file class.t3lib_sqlengine.php.

t3lib_sqlengine::sql_query ( $  query  ) 

Performs an SQL query on the "database"

Parameters:
string Query to execute
Returns:
object Result object or false if error

Definition at line 426 of file class.t3lib_sqlengine.php.

References $res, and t3lib_div::makeInstance().

Referenced by admin_query().

Member Data Documentation

t3lib_sqlengine::$data = array()

Definition at line 107 of file class.t3lib_sqlengine.php.

t3lib_sqlengine::$errorStatus = ''

Definition at line 111 of file class.t3lib_sqlengine.php.

t3lib_sqlengine::$lastAffectedRows = 0

Definition at line 113 of file class.t3lib_sqlengine.php.

t3lib_sqlengine::$lastInsertedId = 0

Definition at line 112 of file class.t3lib_sqlengine.php.

The documentation for this class was generated from the following file:
Generated on Sat Mar 6 04:18:09 2010 for TYPO3 API by  doxygen 1.4.7