Documentation TYPO3 par Ameos
Disponible dans d'autres versions de TYPO3 -> 3.7.0  3.8.1  4.0.0  4.0.1  4.1.0   <- Available in other TYPO3 versions

ux_t3lib_DB Class Reference

Inheritance diagram for ux_t3lib_DB:

Inheritance graph
[legend]
Collaboration diagram for ux_t3lib_DB:

Collaboration graph
[legend]
List of all members.

Public Member Functions

 ux_t3lib_DB ()
 initInternalVariables ()
 clearCachedFieldInfo ()
 cacheFieldInfo ()
 analyzeFields ($parsedExtSQL)
 mapCachedFieldInfo ($fieldInfo)
 exec_INSERTquery ($table, $fields_values, $no_quote_fields='')
 exec_UPDATEquery ($table, $where, $fields_values, $no_quote_fields='')
 exec_DELETEquery ($table, $where)
 exec_SELECTquery ($select_fields, $from_table, $where_clause, $groupBy='', $orderBy='', $limit='')
 INSERTquery ($table, $fields_values, $no_quote_fields='')
 UPDATEquery ($table, $where, $fields_values, $no_quote_fields='')
 DELETEquery ($table, $where)
 SELECTquery ($select_fields, $from_table, $where_clause, $groupBy='', $orderBy='', $limit='')
 quoteSelectFields ($select_fields)
 quoteFieldNames ($select_fields)
 quoteFromTables ($from_table)
 quoteWhereClause ($where_clause)
 _quoteWhereClause ($where_clause)
 quoteGroupBy ($groupBy)
 quoteOrderBy ($orderBy)
 fullQuoteStr ($str, $table)
 quoteStr ($str, $table)
 MetaType ($type, $table, $max_length=-1)
 MySQLMetaType ($t)
 MySQLActualType ($meta)
 sql_error ()
 sql_num_rows (&$res)
 sql_fetch_assoc (&$res)
 sql_fetch_row (&$res)
 sql_free_result (&$res)
 sql_insert_id ()
 sql_affected_rows ()
 sql_data_seek (&$res, $seek)
 sql_field_metatype ($table, $field)
 sql_field_type (&$res, $pointer)
 sql ($db, $query)
 sql_query ($query)
 sql_pconnect ($TYPO3_db_host, $TYPO3_db_username, $TYPO3_db_password)
 sql_select_db ($TYPO3_db)
 admin_get_dbs ()
 admin_get_tables ()
 admin_get_fields ($tableName)
 admin_get_keys ($tableName)
 admin_query ($query)
 handler_getFromTableList ($tableList)
 handler_init ($handlerKey)
 map_needMapping ($tableList, $fieldMappingOnly=FALSE)
 map_assocArray ($input, $tables, $rev=FALSE)
 map_remapSELECTQueryParts (&$select_fields, &$from_table, &$where_clause, &$groupBy, &$orderBy)
 map_sqlParts (&$sqlPartArray, $defaultTable)
 map_genericQueryParsed (&$parsedQuery)
 map_fieldNamesInArray ($table, &$fieldArray)
 debugHandler ($function, $execTime, $inData)
 debug_WHERE ($table, $where, $script='')
 debug_log ($query, $ms, $data, $join, $errorFlag, $script='')
 debug_explain ($query)

Public Attributes

 $printErrors = FALSE
 $debug = FALSE
 $conf = array()
 $mapping = array()
 $table2handlerKeys = array()
 $handlerCfg
 $handlerInstance = array()
 $lastHandlerKey = ''
 $lastQuery = ''
 $lastParsedAndMappedQueryArray = array()
 $resourceIdToTableNameMap = array()
 $cache_handlerKeyFromTableList = array()
 $cache_mappingFromTableList = array()
 $cache_autoIncFields = array()
 $cache_fieldType = array()
 $cache_primaryKeys = array()

Detailed Description

Definition at line 127 of file class.ux_t3lib_db.php.

Constructor & Destructor Documentation

ux_t3lib_DB::ux_t3lib_DB (   ) 
 

Constructor. Creates SQL parser object and imports configuration from $TYPO3_CONF_VARS['EXTCONF']['dbal']

Returns:
void

Definition at line 175 of file class.ux_t3lib_db.php.

References initInternalVariables(), and t3lib_div::makeInstance().

Member Function Documentation

ux_t3lib_DB::_quoteWhereClause (  $  where_clause  ) 
 

[Describe function...]

Parameters:
[type] $$groupBy: ...
Returns:
[type] ...

Definition at line 965 of file class.ux_t3lib_db.php.

References t3lib_div::inList(), and quoteFieldNames().

Referenced by quoteWhereClause().

ux_t3lib_DB::admin_get_dbs (   ) 
 

Listing databases from current MySQL connection. NOTICE: It WILL try to select those databases and thus break selection of current database. Use in Install Tool only! Usage count/core: 1

Returns:
array Each entry represents a database name

Reimplemented from t3lib_DB.

Definition at line 1597 of file class.ux_t3lib_db.php.

References sql_select_db().

ux_t3lib_DB::admin_get_fields (  $  tableName  ) 
 

Returns information about each field in the $table (quering the DBMS) In a DBAL this should look up the right handler for the table and return compatible information This function is important not only for the Install Tool but probably for DBALs as well since they might need to look up table specific information in order to construct correct queries. In such cases this information should probably be cached for quick delivery

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

Reimplemented from t3lib_DB.

Definition at line 1695 of file class.ux_t3lib_db.php.

References handler_getFromTableList(), map_needMapping(), MetaType(), and MySQLActualType().

ux_t3lib_DB::admin_get_keys (  $  tableName  ) 
 

Returns information about each index key in the $table (quering the DBMS) In a DBAL this should look up the right handler for the table and return compatible information

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

Reimplemented from t3lib_DB.

Definition at line 1762 of file class.ux_t3lib_db.php.

References handler_getFromTableList(), and map_needMapping().

ux_t3lib_DB::admin_get_tables (   ) 
 

Returns the list of tables from the system (quering the DBMSs) It looks up all tables from the DBMS of the _DEFAULT handler and then add all tables *configured* to be managed by other handlers

Returns:
array Tables in an array (tablename is in both key and value)

Reimplemented from t3lib_DB.

Definition at line 1634 of file class.ux_t3lib_db.php.

References sql_error(), and sql_fetch_assoc().

ux_t3lib_DB::admin_query (  $  query  ) 
 

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

Reimplemented from t3lib_DB.

Definition at line 1868 of file class.ux_t3lib_db.php.

References exec_INSERTquery(), handler_getFromTableList(), and map_genericQueryParsed().

ux_t3lib_DB::analyzeFields (  $  parsedExtSQL  ) 
 

Analyzes fields and adds the extracted information to the field type, auto increment and primary key info caches.

Parameters:
array $parsedExtSQL The output produced by t3lib_install::getFieldDefinitions_sqlContent()
Returns:
void
See also:
t3lib_install::getFieldDefinitions_sqlContent()

Definition at line 258 of file class.ux_t3lib_db.php.

References MySQLMetaType().

Referenced by cacheFieldInfo().

ux_t3lib_DB::debug_explain (  $  query  ) 
 

Perform EXPLAIN query on DEFAULT handler!

Parameters:
string SELECT Query
Returns:
array The Explain result rows in an array
Todo:
Not supporting other than the default handler? And what about DBMS of other kinds than MySQL - support for EXPLAIN?

Definition at line 2489 of file class.ux_t3lib_db.php.

References sql_fetch_assoc(), and sql_query().

Referenced by debugHandler().

ux_t3lib_DB::debug_log (  $  query,
$  ms,
$  data,
$  join,
$  errorFlag,
$  script = ''
) 
 

Insert row in the log table

Parameters:
string The current query
integer Execution time of query in milliseconds
array Data to be stored serialized.
string Join string if there IS a join.
integer Error status.
Returns:
void

Definition at line 2467 of file class.ux_t3lib_db.php.

References exec_INSERTquery().

Referenced by debugHandler().

ux_t3lib_DB::debug_WHERE (  $  table,
$  where,
$  script = ''
) 
 

Log the where clause for debugging purposes.

Parameters:
string $table
string $where

Definition at line 2445 of file class.ux_t3lib_db.php.

References exec_INSERTquery().

Referenced by debugHandler().

ux_t3lib_DB::debugHandler (  $  function,
$  execTime,
$  inData
) 
 

Debug handler for query execution

Parameters:
string Function name from which this function is called.
string Execution time in ms of the query
array In-data of various kinds.
Returns:
void private

Definition at line 2371 of file class.ux_t3lib_db.php.

References debug_explain(), debug_log(), debug_WHERE(), exec_DELETEquery(), exec_INSERTquery(), exec_SELECTquery(), exec_UPDATEquery(), t3lib_div::inList(), and sql_error().

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

ux_t3lib_DB::DELETEquery (  $  table,
$  where
) 
 

Creates a DELETE SQL-statement for $table where $where-clause Usage count/core: 3

Parameters:
string See exec_DELETEquery()
string See exec_DELETEquery()
Returns:
string Full SQL query for DELETE use exec_DELETEquery() instead if possible!

Reimplemented from t3lib_DB.

Definition at line 820 of file class.ux_t3lib_db.php.

References quoteFromTables(), and quoteWhereClause().

Referenced by exec_DELETEquery().

ux_t3lib_DB::exec_DELETEquery (  $  table,
$  where
) 
 

Deletes records from table

Parameters:
string Database tablename
string WHERE clause, eg. "uid=1". NOTICE: You must escape values in this argument with $this->fullQuoteStr() yourself!
Returns:
mixed Result from handler

Reimplemented from t3lib_DB.

Definition at line 528 of file class.ux_t3lib_db.php.

References t3lib_DB::debug(), debugHandler(), DELETEquery(), handler_getFromTableList(), map_needMapping(), map_sqlParts(), t3lib_div::milliseconds(), and sql_error().

Referenced by debugHandler().

ux_t3lib_DB::exec_INSERTquery (  $  table,
$  fields_values,
$  no_quote_fields = ''
) 
 

Inserts a record for $table from the array with field/value pairs $fields_values.

Parameters:
string Table name
array Field values as key=>value pairs. Values will be escaped internally. Typically you would fill an array like "$insertFields" with 'fieldname'=>'value' and pass it to this function as argument.
mixed List/array of keys NOT to quote (eg. SQL functions)
Returns:
mixed Result from handler, usually TRUE when success and FALSE on failure

Reimplemented from t3lib_DB.

Definition at line 337 of file class.ux_t3lib_db.php.

References t3lib_DB::debug(), debugHandler(), fullQuoteStr(), handler_getFromTableList(), INSERTquery(), map_assocArray(), map_needMapping(), t3lib_div::milliseconds(), quoteFromTables(), quoteWhereClause(), and sql_error().

Referenced by admin_query(), debug_log(), debug_WHERE(), and debugHandler().

ux_t3lib_DB::exec_SELECTquery (  $  select_fields,
$  from_table,
$  where_clause,
$  groupBy = '',
$  orderBy = '',
$  limit = ''
) 
 

Selects records from Data Source

Parameters:
string $select_fields List of fields to select from the table. This is what comes right after "SELECT ...". Required value.
string $from_table Table(s) from which to select. This is what comes right after "FROM ...". Required value.
string $where_clause Optional additional WHERE clauses put in the end of the query. NOTICE: You must escape values in this argument with $this->fullQquoteStr() yourself! DO NOT PUT IN GROUP BY, ORDER BY or LIMIT!
string $groupBy Optional GROUP BY field(s), if none, supply blank string.
string $orderBy Optional ORDER BY field(s), if none, supply blank string.
string $limit Optional LIMIT value ([begin,]max), if none, supply blank string.
Returns:
mixed Result from handler. Typically object from DBAL layers.

Reimplemented from t3lib_DB.

Definition at line 594 of file class.ux_t3lib_db.php.

References t3lib_DB::debug(), debugHandler(), handler_getFromTableList(), t3lib_div::intExplode(), map_needMapping(), map_remapSELECTQueryParts(), t3lib_div::milliseconds(), SELECTquery(), and sql_error().

Referenced by debugHandler().

ux_t3lib_DB::exec_UPDATEquery (  $  table,
$  where,
$  fields_values,
$  no_quote_fields = ''
) 
 

Updates a record from $table

Parameters:
string Database tablename
string WHERE clause, eg. "uid=1". NOTICE: You must escape values in this argument with $this->fullQuoteStr() yourself!
array Field values as key=>value pairs. Values will be escaped internally. Typically you would fill an array like "$updateFields" with 'fieldname'=>'value' and pass it to this function as argument.
mixed List/array of keys NOT to quote (eg. SQL functions)
Returns:
mixed Result from handler, usually TRUE when success and FALSE on failure

Reimplemented from t3lib_DB.

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

References t3lib_DB::debug(), debugHandler(), fullQuoteStr(), handler_getFromTableList(), map_assocArray(), map_needMapping(), map_sqlParts(), t3lib_div::milliseconds(), quoteFromTables(), quoteWhereClause(), sql_error(), and UPDATEquery().

Referenced by debugHandler().

ux_t3lib_DB::fullQuoteStr (  $  str,
$  table
) 
 

Escaping and quoting values for SQL statements.

Parameters:
string Input string
string Table name for which to quote string. Just enter the table that the field-value is selected from (and any DBAL will look up which handler to use and then how to quote the string!).
Returns:
string Output string; Wrapped in single quotes and quotes in the string (" / ') and \ will be backslashed (or otherwise based on DBAL handler)
See also:
quoteStr()

Reimplemented from t3lib_DB.

Definition at line 1043 of file class.ux_t3lib_db.php.

Referenced by exec_INSERTquery(), exec_UPDATEquery(), INSERTquery(), and UPDATEquery().

ux_t3lib_DB::handler_getFromTableList (  $  tableList  ) 
 

Return the handler key pointing to an appropriate database handler as found in $this->handlerCfg array Notice: TWO or more tables in the table list MUST use the SAME handler key - otherwise a fatal error is thrown! (Logically, no database can possibly join two tables from separate sources!)

Parameters:
string Table list, eg. "pages" or "pages, tt_content" or "pages AS A, tt_content AS B"
Returns:
string Handler key (see $this->handlerCfg array) for table

Definition at line 1945 of file class.ux_t3lib_db.php.

References handler_init().

Referenced by admin_get_fields(), admin_get_keys(), admin_query(), exec_DELETEquery(), exec_INSERTquery(), exec_SELECTquery(), exec_UPDATEquery(), MetaType(), and quoteStr().

ux_t3lib_DB::handler_init (  $  handlerKey  ) 
 

Initialize handler (connecting to database)

Parameters:
string Handler key
Returns:
boolean If connection went well, return true
See also:
handler_getFromTableList()

Definition at line 1992 of file class.ux_t3lib_db.php.

References t3lib_DB::$link, t3lib_extMgm::extPath(), t3lib_div::getFileAbsFileName(), t3lib_div::makeInstance(), t3lib_div::sysLog(), and t3lib_div::trimExplode().

Referenced by handler_getFromTableList(), and sql_pconnect().

ux_t3lib_DB::initInternalVariables (   ) 
 

Setting internal variables from $this->conf

Returns:
void

Definition at line 191 of file class.ux_t3lib_db.php.

References cacheFieldInfo(), and t3lib_DB::debug().

Referenced by ux_t3lib_DB().

ux_t3lib_DB::INSERTquery (  $  table,
$  fields_values,
$  no_quote_fields = ''
) 
 

Creates an INSERT SQL-statement for $table from the array with field/value pairs $fields_values. Usage count/core: 4

Parameters:
string See exec_INSERTquery()
array See exec_INSERTquery()
mixed See exec_INSERTquery()
Returns:
string Full SQL query for INSERT (unless $fields_values does not contain any elements in which case it will be false) use exec_INSERTquery() instead if possible!

Reimplemented from t3lib_DB.

Definition at line 680 of file class.ux_t3lib_db.php.

References fullQuoteStr(), quoteFieldNames(), and sql_field_metatype().

Referenced by exec_INSERTquery().

ux_t3lib_DB::map_assocArray (  $  input,
$  tables,
$  rev = FALSE
) 
 

Takes an associated array with field => value pairs and remaps the field names if configured for this table in $this->mapping array. Be careful not to map a field name to another existing fields name (although you can use this to swap fieldnames of course...:-) Observe mapping problems with join-results (more than one table): Joined queries should always prefix the table name to avoid problems with this. Observe that alias fields are not mapped of course (should not be a problem though)

Parameters:
array Input array, associative keys
array Array of tables from the query. Normally just one table; many tables in case of a join. NOTICE: for multiple tables (with joins) there MIGHT occur trouble with fields of the same name in the two tables: This function traverses the mapping information for BOTH tables and applies mapping without checking from which table the field really came!
boolean If true, reverse direction. Default direction is to map an array going INTO the database (thus mapping TYPO3 fieldnames to PHYSICAL field names!)
Returns:
array Output array, with mapped associative keys.

Definition at line 2137 of file class.ux_t3lib_db.php.

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

ux_t3lib_DB::map_fieldNamesInArray (  $  table,
&$  fieldArray
) 
 

Re-mapping field names in array

Parameters:
string (TYPO3) Table name for fields.
array Array of fieldnames to remap. Notice: Passed by reference!
Returns:
void

Definition at line 2330 of file class.ux_t3lib_db.php.

Referenced by map_genericQueryParsed().

ux_t3lib_DB::map_genericQueryParsed (  &$  parsedQuery  ) 
 

Will do table/field mapping on a general t3lib_sqlengine-compliant SQL query (May still not support all query types...)

Parameters:
array Parsed QUERY as from t3lib_sqlengine::parseSQL(). NOTICE: Passed by reference!
Returns:
void
See also:
t3lib_sqlengine::parseSQL()
... and here support for all other query types should be!

Definition at line 2263 of file class.ux_t3lib_db.php.

References map_fieldNamesInArray(), and map_needMapping().

Referenced by admin_query().

ux_t3lib_DB::map_needMapping (  $  tableList,
$  fieldMappingOnly = FALSE
) 
 

Checks if mapping is needed for a table(list)

Parameters:
string List of tables in query
boolean If true, it will check only if FIELDs are configured and ignore the mapped table name if any.
Returns:
mixed Returns an array of table names (parsed version of input table) if mapping is needed, otherwise just false.

Definition at line 2101 of file class.ux_t3lib_db.php.

Referenced by admin_get_fields(), admin_get_keys(), exec_DELETEquery(), exec_INSERTquery(), exec_SELECTquery(), exec_UPDATEquery(), map_genericQueryParsed(), and sql_fetch_assoc().

ux_t3lib_DB::map_remapSELECTQueryParts (  &$  select_fields,
&$  from_table,
&$  where_clause,
&$  groupBy,
&$  orderBy
) 
 

Remaps table/field names in a SELECT query's parts Notice: All arguments are passed by reference!

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 ...". Require value.
string Where clause. This is what comes right after "WHERE ...". Can be blank.
string Group by field(s)
string Order by field(s)
Returns:
void
See also:
exec_SELECTquery()

Definition at line 2186 of file class.ux_t3lib_db.php.

References map_sqlParts().

Referenced by exec_SELECTquery().

ux_t3lib_DB::map_sqlParts (  &$  sqlPartArray,
$  defaultTable
) 
 

Generic mapping of table/field names arrays (as parsed by t3lib_sqlengine)

Parameters:
array Array with parsed SQL parts; Takes both fields, tables, where-parts, group and order-by. Passed by reference.
string Default table name to assume if no table is found in $sqlPartArray
Returns:
void private
See also:
map_remapSELECTQueryParts()

Definition at line 2228 of file class.ux_t3lib_db.php.

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

ux_t3lib_DB::mapCachedFieldInfo (  $  fieldInfo  ) 
 

This function builds all definitions for mapped tables and fields

See also:
cacheFieldInfo()

Definition at line 279 of file class.ux_t3lib_db.php.

Referenced by cacheFieldInfo().

ux_t3lib_DB::MetaType (  $  type,
$  table,
$  max_length = -1
) 
 

Return MetaType for native field type (ADOdb only!)

Parameters:
string native type as reported by admin_get_fields()
string Table name for which query type string. Important for detection of DBMS handler of the query!
Returns:
string Meta type (currenly ADOdb syntax only, http://phplens.com/lens/adodb/docs-adodb.htm#metatype)

Definition at line 1084 of file class.ux_t3lib_db.php.

References handler_getFromTableList(), and quoteFromTables().

Referenced by admin_get_fields().

ux_t3lib_DB::MySQLActualType (  $  meta  ) 
 

Return actual MySQL type for meta field type

Parameters:
string Meta type (currenly ADOdb syntax only, http://phplens.com/lens/adodb/docs-adodb.htm#metatype)
Returns:
string native type as reported as in mysqldump files, uppercase

Definition at line 1159 of file class.ux_t3lib_db.php.

Referenced by admin_get_fields().

ux_t3lib_DB::MySQLMetaType (  $  t  ) 
 

Return MetaType for native MySQL field type

Parameters:
string native type as reported as in mysqldump files
Returns:
string Meta type (currenly ADOdb syntax only, http://phplens.com/lens/adodb/docs-adodb.htm#metatype)

Definition at line 1106 of file class.ux_t3lib_db.php.

Referenced by analyzeFields().

ux_t3lib_DB::quoteFieldNames (  $  select_fields  ) 
 

Quotes field (and table) names with the quote character suitable for the DB being used

Parameters:
string List of fields to be used in query to DB
Returns:
string Quoted list of fields to be in query to DB

Definition at line 888 of file class.ux_t3lib_db.php.

Referenced by _quoteWhereClause(), INSERTquery(), quoteSelectFields(), SELECTquery(), and UPDATEquery().

ux_t3lib_DB::quoteFromTables (  $  from_table  ) 
 

Quotes table names with the quote character suitable for the DB being used

Parameters:
string List of tables to be selected from DB
Returns:
string Quoted list of tables to be selected from DB

Definition at line 923 of file class.ux_t3lib_db.php.

Referenced by DELETEquery(), exec_INSERTquery(), exec_UPDATEquery(), MetaType(), and SELECTquery().

ux_t3lib_DB::quoteGroupBy (  $  groupBy  ) 
 

[Describe function...]

Parameters:
[type] $$groupBy: ...
Returns:
[type] ...

Definition at line 995 of file class.ux_t3lib_db.php.

Referenced by SELECTquery().

ux_t3lib_DB::quoteOrderBy (  $  orderBy  ) 
 

[Describe function...]

Parameters:
[type] $$orderBy: ...
Returns:
[type] ...

Definition at line 1014 of file class.ux_t3lib_db.php.

Referenced by SELECTquery().

ux_t3lib_DB::quoteSelectFields (  $  select_fields  ) 
 

Quotes field (and table) names with the quote character suitable for the DB being used Use quoteFieldNames instead!

Parameters:
string List of fields to be selected from DB
Returns:
string Quoted list of fields to be selected from DB
Deprecated:

Definition at line 878 of file class.ux_t3lib_db.php.

References quoteFieldNames().

ux_t3lib_DB::quoteStr (  $  str,
$  table
) 
 

Substitution for PHP function "addslashes()" NOTICE: You must wrap the output of this function in SINGLE QUOTES to be DBAL compatible. Unless you have to apply the single quotes yourself you should rather use ->fullQuoteStr()!

Parameters:
string Input string
string Table name for which to quote string. Just enter the table that the field-value is selected from (and any DBAL will look up which handler to use and then how to quote the string!).
Returns:
string Output string; Quotes (" / ') and \ will be backslashed (or otherwise based on DBAL handler)
See also:
quoteStr()

Reimplemented from t3lib_DB.

Definition at line 1056 of file class.ux_t3lib_db.php.

References handler_getFromTableList().

ux_t3lib_DB::quoteWhereClause (  $  where_clause  ) 
 

Quotes the field (and table) names within a where clause with the quote character suitable for the DB being used

Parameters:
string A where clause that can e parsed by parseWhereClause
Returns:
string Usable where clause with quoted field/table names

Definition at line 949 of file class.ux_t3lib_db.php.

References _quoteWhereClause().

Referenced by DELETEquery(), exec_INSERTquery(), exec_UPDATEquery(), and SELECTquery().

ux_t3lib_DB::SELECTquery (  $  select_fields,
$  from_table,
$  where_clause,
$  groupBy = '',
$  orderBy = '',
$  limit = ''
) 
 

Creates a SELECT SQL-statement Usage count/core: 11

Parameters:
string See exec_SELECTquery()
string See exec_SELECTquery()
string See exec_SELECTquery()
string See exec_SELECTquery()
string See exec_SELECTquery()
string See exec_SELECTquery()
Returns:
string Full SQL query for SELECT use exec_SELECTquery() instead if possible!

Reimplemented from t3lib_DB.

Definition at line 847 of file class.ux_t3lib_db.php.

References quoteFieldNames(), quoteFromTables(), quoteGroupBy(), quoteOrderBy(), and quoteWhereClause().

Referenced by exec_SELECTquery().

ux_t3lib_DB::sql (  $  db,
$  query
) 
 

Executes query (on DEFAULT handler!) DEPRECIATED - use exec_* functions from this class instead!

Parameters:
string Database name
string Query to execute
Returns:
pointer Result pointer

Reimplemented from t3lib_DB.

Definition at line 1499 of file class.ux_t3lib_db.php.

References sql_query().

ux_t3lib_DB::sql_affected_rows (   ) 
 

Returns the number of rows affected by the last INSERT, UPDATE or DELETE query

Returns:
integer Number of rows affected by last query

Reimplemented from t3lib_DB.

Definition at line 1383 of file class.ux_t3lib_db.php.

ux_t3lib_DB::sql_data_seek (  &$  res,
$  seek
) 
 

Move internal result pointer

Parameters:
pointer MySQL result pointer (of SELECT query) / DBAL object
integer Seek result number.
Returns:
boolean Returns TRUE on success or FALSE on failure.

Definition at line 1406 of file class.ux_t3lib_db.php.

ux_t3lib_DB::sql_error (   ) 
 

Returns the error status on the most recent sql() execution (based on $this->lastHandlerKey)

Returns:
string Handler error strings

Reimplemented from t3lib_DB.

Definition at line 1202 of file class.ux_t3lib_db.php.

Referenced by admin_get_tables(), debugHandler(), exec_DELETEquery(), exec_INSERTquery(), exec_SELECTquery(), exec_UPDATEquery(), and sql_query().

ux_t3lib_DB::sql_fetch_assoc (  &$  res  ) 
 

Returns an associative array that corresponds to the fetched row, or FALSE if there are no more rows.

Parameters:
pointer MySQL result pointer (of SELECT query) / DBAL object
Returns:
array Associative array of result row.

Definition at line 1247 of file class.ux_t3lib_db.php.

References map_assocArray(), and map_needMapping().

Referenced by admin_get_tables(), and debug_explain().

ux_t3lib_DB::sql_fetch_row (  &$  res  ) 
 

Returns an array that corresponds to the fetched row, or FALSE if there are no more rows. The array contains the values in numerical indices.

Parameters:
pointer MySQL result pointer (of SELECT query) / DBAL object
Returns:
array Array with result rows.

Definition at line 1298 of file class.ux_t3lib_db.php.

ux_t3lib_DB::sql_field_metatype (  $  table,
$  field
) 
 

Get the type of the specified field in a result

If the first parameter is a string, it is used as table name for the lookup.

Parameters:
pointer MySQL result pointer (of SELECT query) / DBAL object / table name
integer Field index. In case of ADOdb a string (field name!) FIXME
Returns:
string Returns the type of the specified field index

Definition at line 1432 of file class.ux_t3lib_db.php.

Referenced by INSERTquery(), and UPDATEquery().

ux_t3lib_DB::sql_field_type (  &$  res,
$  pointer
) 
 

Get the type of the specified field in a result

If the first parameter is a string, it is used as table name for the lookup.

Parameters:
pointer MySQL result pointer (of SELECT query) / DBAL object / table name
integer Field index. In case of ADOdb a string (field name!) FIXME
Returns:
string Returns the type of the specified field index

Definition at line 1445 of file class.ux_t3lib_db.php.

References t3lib_DB::debug().

ux_t3lib_DB::sql_free_result (  &$  res  ) 
 

Free result memory / unset result object

Parameters:
pointer MySQL result pointer to free / DBAL object
Returns:
boolean Returns TRUE on success or FALSE on failure.

Definition at line 1334 of file class.ux_t3lib_db.php.

ux_t3lib_DB::sql_insert_id (   ) 
 

Get the ID generated from the previous INSERT operation

Returns:
integer The uid of the last inserted record.

Reimplemented from t3lib_DB.

Definition at line 1362 of file class.ux_t3lib_db.php.

ux_t3lib_DB::sql_num_rows (  &$  res  ) 
 

Returns the number of selected rows.

Parameters:
pointer Result pointer / DBAL object
Returns:
integer Number of resulting rows.

Definition at line 1224 of file class.ux_t3lib_db.php.

ux_t3lib_DB::sql_pconnect (  $  TYPO3_db_host,
$  TYPO3_db_username,
$  TYPO3_db_password
) 
 

Opening the _DEFAULT connection handler to the database. This is typically done by the scripts "init.php" in the backend or "index_ts.php" in the frontend (tslib_fe->connectToMySQL()) You wouldn't need to use this at any time - let TYPO3 core handle this.

Parameters:
string Database host IP/domain
string Username to connect with.
string Password to connect with.
Returns:
mixed Returns handler connection value
See also:
handler_init()

Reimplemented from t3lib_DB.

Definition at line 1546 of file class.ux_t3lib_db.php.

References handler_init().

ux_t3lib_DB::sql_query (  $  query  ) 
 

Executes query (on DEFAULT handler!) DEPRECIATED - use exec_* functions from this class instead!

Parameters:
string Query to execute
Returns:
pointer Result pointer / DBAL object

Reimplemented from t3lib_DB.

Definition at line 1511 of file class.ux_t3lib_db.php.

References t3lib_DB::debug(), and sql_error().

Referenced by debug_explain(), and sql().

ux_t3lib_DB::sql_select_db (  $  TYPO3_db  ) 
 

Select database for _DEFAULT handler.

Parameters:
string Database to connect to.
Returns:
boolean Always returns true; function is obsolete, database selection is made in handler_init() function!

Reimplemented from t3lib_DB.

Definition at line 1565 of file class.ux_t3lib_db.php.

Referenced by admin_get_dbs().

ux_t3lib_DB::UPDATEquery (  $  table,
$  where,
$  fields_values,
$  no_quote_fields = ''
) 
 

Creates an UPDATE SQL-statement for $table where $where-clause (typ. 'uid=...') from the array with field/value pairs $fields_values. Usage count/core: 6

Parameters:
string See exec_UPDATEquery()
string See exec_UPDATEquery()
array See exec_UPDATEquery()
mixed See exec_UPDATEquery()
Returns:
string Full SQL query for UPDATE (unless $fields_values does not contain any elements in which case it will be false) use exec_UPDATEquery() instead if possible!

Reimplemented from t3lib_DB.

Definition at line 752 of file class.ux_t3lib_db.php.

References fullQuoteStr(), quoteFieldNames(), and sql_field_metatype().

Referenced by exec_UPDATEquery().

Member Data Documentation

ux_t3lib_DB::$handlerCfg
 

Initial value:

 array (                        // See manual.
        '_DEFAULT' => array (
        'type' => 'native',
        'config' => array(
        'username' => '',               // Set by default (overridden)
        'password' => '',               // Set by default (overridden)
        'host' => '',                   // Set by default (overridden)
        'database' => '',               // Set by default (overridden)
        'driver' => '',                 // ONLY "adodb" type; eg. "mysql"
        )
        ),
        )

Definition at line 136 of file class.ux_t3lib_db.php.

The documentation for this class was generated from the following file:

Généré par Les experts TYPO3 avec  doxygen 1.4.6