Inheritance diagram for DatabaseOracle:

Collaboration diagram for DatabaseOracle:

Public Member Functions
	__construct ($p=null)
	Constructor.
	__destruct ()
	Run a few simple sanity checks.
	addIdentifierQuotes ($s)
	Quotes an identifier using `backticks` or "double quotes" depending on the database type.
	addQuotes ($s)
	Adds quotes and backslashes.
	affectedRows ()
	Get the number of rows affected by the last write query.
	aggregateValue ($valuedata, $valuename= 'value')
	Return aggregated value function call.
	bitAnd ($fieldLeft, $fieldRight)
	bitNot ($field)
	bitOr ($fieldLeft, $fieldRight)
	buildGroupConcatField ($delim, $table, $field, $conds= '', $join_conds=array())
	Build a GROUP_CONCAT or equivalent statement for a query.
	cascadingDeletes ()
	Returns true if this database supports (and uses) cascading deletes.
	cleanupTriggers ()
	Returns true if this database supports (and uses) triggers (e.g.
	dataSeek ($res, $row)
	decodeBlob ($b)
	Some DBMSs return a special placeholder object representing blob fields in result objects.
	delete ($table, $conds, $fname=__METHOD__)
	DELETE query wrapper.
	dropTable ($tableName, $fName=__METHOD__)
	Delete a table.
	duplicateTableStructure ($oldName, $newName, $temporary=false, $fname=__METHOD__)
	Creates a new table with structure copied from existing table Note that unlike most database abstraction functions, this function does not automatically append database prefix, because it works at a lower abstraction level.
	encodeBlob ($b)
	Some DBMSs have a special format for inserting into blob fields, they don't allow simple quoted strings to be inserted.
	execFlags ()
	fetchObject ($res)
	fetchRow ($res)
	Fetch the next row from the given result object, in associative array form.
	fieldInfo ($table, $field)
	fieldName ($stmt, $n)
	Get a field name in a result object.
	freeResult ($res)
	Frees resources associated with the LOB descriptor.
	getDBname ()
	Get the current DB name.
	getInfinity ()
	Find out when 'infinity' is.
	getSearchEngine ()
	Get search engine class.
	getServer ()
	Get the server hostname or IP address.
	getServerVersion ()
	getSoftwareLink ()
	getType ()
	Get the type of the DBMS, as it appears in $wgDBtype.
	implicitGroupby ()
	Returns true if this database does an implicit sort when doing GROUP BY.
	implicitOrderby ()
	Returns true if this database does an implicit order by when the column has an index For example: SELECT page_title FROM page LIMIT 1.
	indexExists ($table, $index, $fname=__METHOD__)
	Query whether a given index exists.
	indexInfo ($table, $index, $fname=__METHOD__)
	Returns information about an index If errors are explicitly ignored, returns NULL on failure.
	indexUnique ($table, $index, $fname=__METHOD__)
	insert ($table, $a, $fname=__METHOD__, $options=array())
	INSERT wrapper, inserts an array into a table.
	insertId ()
	This must be called after nextSequenceVal.
	insertSelect ($destTable, $srcTable, $varMap, $conds, $fname=__METHOD__, $insertOptions=array(), $selectOptions=array())
	INSERT SELECT wrapper.
	isQuotedIdentifier ($s)
	Returns if the given identifier looks quoted or not according to the database convention for quoting identifiers .
	lastErrno ()
	Get the last error number.
	lastError ()
	Get a description of the last error.
	limitResult ($sql, $limit, $offset=false)
	Construct a LIMIT query with optional offset.
	listTables ($prefix=null, $fname=__METHOD__)
	List all tables on the database.
	makeSelectOptions ($options)
	Returns an optional USE INDEX clause to go after the table, and a string to go at the end of the query.
	nextSequenceValue ($seqName)
	Return the next in a sequence, save the value for retrieval via insertId()
	numFields ($res)
	Get the number of fields in a result object.
	numRows ($res)
	Get the number of rows in a result object.
	open ($server, $user, $password, $dbName)
	Usually aborts on failure.
	queryIgnore ($sql, $fname= '')
	realTimestamps ()
	Returns true if this database uses timestamps rather than integers.
	removeIdentifierQuotes ($s)
	reportQueryError ($error, $errno, $sql, $fname, $tempIgnore=false)
	Report a query error.
	searchableIPs ()
	Returns true if this database can do a native search on IP columns e.g.
	selectDB ($db)
	Change the current database.
	selectRow ($table, $vars, $conds, $fname=__METHOD__, $options=array(), $join_conds=array())
	Single row SELECT wrapper.
	sourceStream ($fp, $lineCallback=false, $resultCallback=false, $fname=__METHOD__, $inputCallback=false)
	';
	strencode ($s)
	Wrapper for addslashes()
	strictIPs ()
	Returns true if this database is strict about what can be put into an IP field.
	tableExists ($table, $fname=__METHOD__)
	Query whether a given table exists (in the given schema, or the default mw one if not given)
	tableName ($name, $format= 'quoted')
	Format a table name ready for use in constructing an SQL query.
	tableNameInternal ($name)
	textFieldSize ($table, $field)
	Returns the size of a text field, or -1 for "unlimited".
	timestamp ($ts=0)
	Convert a timestamp in one of the formats accepted by wfTimestamp() to the format used for inserting into timestamp fields in this DBMS.
	unionQueries ($sqls, $all)
	Construct a UNION query This is used for providing overload point for other DB abstractions not compatible with the MySQL syntax.
	update ($table, $values, $conds, $fname=__METHOD__, $options=array())
	upsert ($table, array $rows, array $uniqueIndexes, array $set, $fname=__METHOD__)
	INSERT ON DUPLICATE KEY UPDATE wrapper, upserts an array into a table.
	wasDeadlock ()
	Determines if the last failure was due to a deadlock STUB.
Protected Member Functions
	closeConnection ()
	Closes a database connection, if it is open Returns success, true if already closed.
	doBegin ($fname=__METHOD__)
	Issues the BEGIN command to the database server.
	doCommit ($fname=__METHOD__)
	Issues the COMMIT command to the database server.
	doQuery ($sql)
	The DBMS-dependent part of query()
	doRollback ($fname=__METHOD__)
	Issues the ROLLBACK command to the database server.
Protected Attributes
int	$mAffectedRows
	The number of rows affected as an integer *.
resource	$mLastResult = null
	*
Private Member Functions
	fieldBindStatement ($table, $col, &$val, $includeCol=false)
	fieldInfoMulti ($table, $field)
	Function translates mysql_fetch_field() functionality on ORACLE.
	getSequenceData ($table)
	Return sequence_name if table has a sequence.
	insertOneRow ($table, $row, $fname)
	wrapConditionsForWhere ($table, $conds, $parentCol=null)
	wrapFieldForWhere ($table, &$col, &$val)
Private Attributes
string	$defaultCharset = 'AL32UTF8'
	Character set for Oracle database *.
bool	$ignoreDupValOnIndex = false
	*
array	$mFieldInfoCache = array()
	*
int	$mInsertId = null
	*
bool array	$sequenceData = null
	*

Detailed Description

Definition at line 188 of file DatabaseOracle.php.

Constructor & Destructor Documentation

DatabaseOracle::__construct ( $ params = null )

Constructor.

FIXME: It is possible to construct a Database object with no associated connection object, by specifying no parameters to __construct(). This feature is deprecated and should be removed.

DatabaseBase subclasses should not be constructed directly in external code. DatabaseBase::factory() should be used instead.

Parameters:

array $params Parameters passed from DatabaseBase::factory()

Reimplemented from DatabaseBase.

Definition at line 203 of file DatabaseOracle.php.

DatabaseOracle::__destruct ( )

Run a few simple sanity checks.

Reimplemented from DatabaseBase.

Definition at line 228 of file DatabaseOracle.php.

Member Function Documentation

DatabaseOracle::addIdentifierQuotes ( $ s )

Quotes an identifier using `backticks` or "double quotes" depending on the database type.

MySQL uses `backticks` while basically everything else uses double quotes. Since MySQL is the odd one out here the double quotes are our generic and we implement backticks in DatabaseMysql.

Parameters:

string $s

Returns:: string

Reimplemented from DatabaseBase.

Definition at line 1288 of file DatabaseOracle.php.

References $s.

DatabaseOracle::addQuotes ( $ s )

Adds quotes and backslashes.

Parameters:

string $s

Returns:: string

Reimplemented from DatabaseBase.

Definition at line 1279 of file DatabaseOracle.php.

DatabaseOracle::affectedRows ( )

Get the number of rows affected by the last write query.

See also:: http://www.php.net/mysql_affected_rows

Returns:: int

Implements DatabaseType.

Definition at line 531 of file DatabaseOracle.php.

DatabaseOracle::aggregateValue	(	$	valuedata,
		$	valuename = `'value'`
	)

Return aggregated value function call.

Parameters:

array	$valuedata
string	$valuename

Returns:: mixed

Reimplemented from DatabaseBase.

Definition at line 977 of file DatabaseOracle.php.

DatabaseOracle::bitAnd	(	$	fieldLeft,
		$	fieldRight
	)

Parameters:

string	$fieldLeft
string	$fieldRight

Returns:: string

Reimplemented from DatabaseBase.

Definition at line 1536 of file DatabaseOracle.php.

DatabaseOracle::bitNot ( $ field )

Parameters:

string $field

Returns:: string

Reimplemented from DatabaseBase.

Definition at line 1531 of file DatabaseOracle.php.

DatabaseOracle::bitOr	(	$	fieldLeft,
		$	fieldRight
	)

Parameters:

string	$fieldLeft
string	$fieldRight

Returns:: string

Reimplemented from DatabaseBase.

Definition at line 1540 of file DatabaseOracle.php.

DatabaseOracle::buildGroupConcatField	(	$	delim,
		$	table,
		$	field,
		$	conds = `''`,
		$	join_conds = `array()`
	)

Build a GROUP_CONCAT or equivalent statement for a query.

This is useful for combining a field for several rows into a single string. NULL values will not appear in the output, duplicated values will appear, and the resulting delimiter-separated values have no defined sort order. Code using the results may need to use the PHP unique() or sort() methods.

Parameters:

string	$delim	Glue to bind the results together
string \| array	$table	Table name
string	$field	Field name
string \| array	$conds	Conditions
string \| array	$join_conds	Join conditions

Returns:: string SQL text

Since:: 1.23

Reimplemented from DatabaseBase.

Definition at line 1552 of file DatabaseOracle.php.

DatabaseOracle::cascadingDeletes ( )

Returns true if this database supports (and uses) cascading deletes.

Returns:: bool

Reimplemented from DatabaseBase.

Definition at line 240 of file DatabaseOracle.php.

DatabaseOracle::cleanupTriggers ( )

Returns true if this database supports (and uses) triggers (e.g.

on the page table)

Returns:: bool

Reimplemented from DatabaseBase.

Definition at line 244 of file DatabaseOracle.php.

DatabaseOracle::closeConnection ( ) [protected]

Closes a database connection, if it is open Returns success, true if already closed.

Returns:: bool

Reimplemented from DatabaseBase.

Definition at line 368 of file DatabaseOracle.php.

DatabaseOracle::dataSeek	(	$	res,
		$	row
	)

Parameters:

mixed	$res
int	$row

Implements DatabaseType.

Definition at line 503 of file DatabaseOracle.php.

DatabaseOracle::decodeBlob ( $ b )

Some DBMSs return a special placeholder object representing blob fields in result objects.

Pass the object through this function to return the original string.

Parameters:

string $b

Returns:: string

Reimplemented from DatabaseBase.

Definition at line 897 of file DatabaseOracle.php.

DatabaseOracle::delete	(	$	table,
		$	conds,
		$	fname = `__METHOD__`
	)

DELETE query wrapper.

Parameters:

array	$table	Table name
string \| array	$conds	Array of conditions. See $conds in DatabaseBase::select() for the format. Use $conds == "*" to delete all rows
string	$fname	Name of the calling function

Exceptions:

DBUnexpectedError

Returns:: bool|ResultWrapper

Reimplemented from DatabaseBase.

Definition at line 1385 of file DatabaseOracle.php.

DatabaseOracle::doBegin ( $ fname = __METHOD__ ) [protected]

Issues the BEGIN command to the database server.

See also:: DatabaseBase::begin()

Parameters:

string $fname

Reimplemented from DatabaseBase.

Definition at line 1141 of file DatabaseOracle.php.

DatabaseOracle::doCommit ( $ fname = __METHOD__ ) [protected]

Issues the COMMIT command to the database server.

See also:: DatabaseBase::commit()

Parameters:

string $fname

Reimplemented from DatabaseBase.

Definition at line 1146 of file DatabaseOracle.php.

DatabaseOracle::doQuery ( $ sql ) [protected]

The DBMS-dependent part of query()

Parameters:

string $sql SQL query.

Returns:: ResultWrapper|bool Result object to feed to fetchObject, fetchRow, ...; or false on failure

Reimplemented from DatabaseBase.

Definition at line 376 of file DatabaseOracle.php.

DatabaseOracle::doRollback ( $ fname = __METHOD__ ) [protected]

Issues the ROLLBACK command to the database server.

See also:: DatabaseBase::rollback()

Parameters:

string $fname

Reimplemented from DatabaseBase.

Definition at line 1157 of file DatabaseOracle.php.

DatabaseOracle::dropTable	(	$	tableName,
		$	fName = `__METHOD__`
	)

Delete a table.

Parameters:

string	$tableName
string	$fName

Returns:: bool|ResultWrapper

Since:: 1.18

Reimplemented from DatabaseBase.

Definition at line 957 of file DatabaseOracle.php.

DatabaseOracle::duplicateTableStructure	(	$	oldName,
		$	newName,
		$	temporary = `false`,
		$	fname = `__METHOD__`
	)

Creates a new table with structure copied from existing table Note that unlike most database abstraction functions, this function does not automatically append database prefix, because it works at a lower abstraction level.

The table names passed to this function shall not be quoted (this function calls addIdentifierQuotes when needed).

Parameters:

string	$oldName	Name of table whose structure should be copied
string	$newName	Name of table to be created
bool	$temporary	Whether the new table should be temporary
string	$fname	Calling function name

Exceptions:

MWException

Returns:: bool True if operation was successful

Reimplemented from DatabaseBase.

Definition at line 916 of file DatabaseOracle.php.

DatabaseOracle::encodeBlob ( $ b )

Some DBMSs have a special format for inserting into blob fields, they don't allow simple quoted strings to be inserted.

To insert into such a field, pass the data through this function before passing it to DatabaseBase::insert().

Parameters:

string $b

Returns:: string

Reimplemented from DatabaseBase.

Definition at line 893 of file DatabaseOracle.php.

DatabaseOracle::execFlags ( )

Definition at line 372 of file DatabaseOracle.php.

DatabaseOracle::fetchObject ( $ res )

Parameters:

ResultWrapper | stdClass $res

Returns:: mixed

Implements DatabaseType.

Definition at line 455 of file DatabaseOracle.php.

DatabaseOracle::fetchRow ( $ res )

Fetch the next row from the given result object, in associative array form.

Fields are retrieved with $row['fieldname']. If no more rows are available, false is returned.

Parameters:

ResultWrapper $res Result object as returned from DatabaseBase::query(), etc.

Returns:: array|bool

Exceptions:

DBUnexpectedError Thrown if the database returns an error

Implements DatabaseType.

Definition at line 463 of file DatabaseOracle.php.

References $res.

DatabaseOracle::fieldBindStatement	(	$	table,
		$	col,
		&$	val,
		$	includeCol = `false`
	)		`[private]`

Definition at line 580 of file DatabaseOracle.php.

DatabaseOracle::fieldInfo	(	$	table,
		$	field
	)

Exceptions:

DBUnexpectedError

Parameters:

string	$table
string	$field

Returns:: ORAField

Implements DatabaseType.

Definition at line 1133 of file DatabaseOracle.php.

DatabaseOracle::fieldInfoMulti	(	$	table,
		$	field
	)		`[private]`

Function translates mysql_fetch_field() functionality on ORACLE.

Caching is present for reducing query time. For internal calls. Use fieldInfo for normal usage. Returns false if the field doesn't exist

Parameters:

array \| string	$table
string	$field

Returns:: ORAField|ORAResult

Definition at line 1075 of file DatabaseOracle.php.

DatabaseOracle::fieldName	(	$	res,
		$	n
	)

Get a field name in a result object.

See also:: http://www.php.net/mysql_field_name

Parameters:

mixed	$res	A SQL result
int	$n

Returns:: string

Implements DatabaseType.

Definition at line 487 of file DatabaseOracle.php.

References $res.

DatabaseOracle::freeResult ( $ res )

Frees resources associated with the LOB descriptor.

Parameters:

ResultWrapper | resource $res

Reimplemented from DatabaseBase.

Definition at line 443 of file DatabaseOracle.php.

DatabaseOracle::getDBname ( )

Get the current DB name.

Returns:: string

Reimplemented from DatabaseBase.

Definition at line 1544 of file DatabaseOracle.php.

DatabaseOracle::getInfinity ( )

Find out when 'infinity' is.

Most DBMSes support this. This is a special keyword for timestamps in PostgreSQL, and works with CHAR(14) as well because "i" sorts after all numbers.

Returns:: string

Reimplemented from DatabaseBase.

Definition at line 1564 of file DatabaseOracle.php.

DatabaseOracle::getSearchEngine ( )

Get search engine class.

All subclasses of this need to implement this if they wish to use searching.

Returns:: string

Reimplemented from DatabaseBase.

Definition at line 1560 of file DatabaseOracle.php.

DatabaseOracle::getSequenceData ( $ table ) [private]

Return sequence_name if table has a sequence.

Parameters:

string $table

Returns:: bool

Definition at line 844 of file DatabaseOracle.php.

References $result, array(), and tableName().

DatabaseOracle::getServer ( )

Get the server hostname or IP address.

Returns:: string

Reimplemented from DatabaseBase.

Definition at line 1548 of file DatabaseOracle.php.

DatabaseOracle::getServerVersion ( )

Returns:: string Version information from the database

Implements DatabaseType.

Definition at line 1005 of file DatabaseOracle.php.

DatabaseOracle::getSoftwareLink ( )

Returns:: string Wikitext of a link to the server software's web site

Implements DatabaseType.

Definition at line 998 of file DatabaseOracle.php.

DatabaseOracle::getType ( )

Get the type of the DBMS, as it appears in $wgDBtype.

Returns:: string

Implements DatabaseType.

Definition at line 236 of file DatabaseOracle.php.

References DatabaseBase\close(), wfRestoreWarnings(), and wfSuppressWarnings().

DatabaseOracle::implicitGroupby ( )

Returns true if this database does an implicit sort when doing GROUP BY.

Returns:: bool

Reimplemented from DatabaseBase.

Definition at line 256 of file DatabaseOracle.php.

DatabaseOracle::implicitOrderby ( )

Returns true if this database does an implicit order by when the column has an index For example: SELECT page_title FROM page LIMIT 1.

Returns:: bool

Reimplemented from DatabaseBase.

Definition at line 260 of file DatabaseOracle.php.

DatabaseOracle::indexExists	(	$	table,
		$	index,
		$	fname = `__METHOD__`
	)

Query whether a given index exists.

Parameters:

string	$table
string	$index
string	$fname

Returns:: bool

Reimplemented from DatabaseBase.

Definition at line 1025 of file DatabaseOracle.php.

DatabaseOracle::indexInfo	(	$	table,
		$	index,
		$	fname = `__METHOD__`
	)

Returns information about an index If errors are explicitly ignored, returns NULL on failure.

Parameters:

string	$table
string	$index
string	$fname

Returns:: bool

Implements DatabaseType.

Definition at line 543 of file DatabaseOracle.php.

DatabaseOracle::indexUnique	(	$	table,
		$	index,
		$	fname = `__METHOD__`
	)

Definition at line 547 of file DatabaseOracle.php.

DatabaseOracle::insert	(	$	table,
		$	a,
		$	fname = `__METHOD__`,
		$	options = `array()`
	)

INSERT wrapper, inserts an array into a table.

$a may be either:

A single associative array. The array keys are the field names, and the values are the values to insert. The values are treated as data and will be quoted appropriately. If NULL is inserted, this will be converted to a database NULL.
An array with numeric keys, holding a list of associative arrays. This causes a multi-row INSERT on DBMSs that support it. The keys in each subarray must be identical to each other, and in the same order.

Usually throws a DBQueryError on failure. If errors are explicitly ignored, returns success.

$options is an array of options, with boolean options encoded as values with numeric keys, in the same style as $options in DatabaseBase::select(). Supported options are:

IGNORE: Boolean: if present, duplicate key errors are ignored, and any rows which cause duplicate key errors are not inserted. It's possible to determine how many rows were successfully inserted using DatabaseBase::affectedRows().

Parameters:

string	$table	Table name. This will be passed through DatabaseBase::tableName().
array	$a	Array of rows to insert
string	$fname	Calling function name (use __METHOD__) for logs/profiling
array	$options	Array of options

Returns:: bool

Reimplemented from DatabaseBase.

Definition at line 551 of file DatabaseOracle.php.

DatabaseOracle::insertId ( )

This must be called after nextSequenceVal.

Returns:: null|int

Implements DatabaseType.

Definition at line 495 of file DatabaseOracle.php.

DatabaseOracle::insertOneRow	(	$	table,
		$	row,
		$	fname
	)		`[private]`

Parameters:

string	$table
array	$row
string	$fname

Returns:: bool

Exceptions:

DBUnexpectedError

Definition at line 622 of file DatabaseOracle.php.

DatabaseOracle::insertSelect	(	$	destTable,
		$	srcTable,
		$	varMap,
		$	conds,
		$	fname = `__METHOD__`,
		$	insertOptions = `array()`,
		$	selectOptions = `array()`
	)

INSERT SELECT wrapper.

Takes data from a SELECT query and inserts it into another table.

Parameters:

string	$destTable	The table name to insert into
string \| array	$srcTable	May be either a table name, or an array of table names to include in a join.
array	$varMap	Must be an associative array of the form array( 'dest1' => 'source1', ...). Source items may be literals rather than field names, but strings should be quoted with DatabaseBase::addQuotes()
array	$conds	Condition array. See $conds in DatabaseBase::select() for the details of the format of condition arrays. May be "*" to copy the whole table.
string	$fname	The function name of the caller, from __METHOD__
array	$insertOptions	Options for the INSERT part of the query, see DatabaseBase::insert() for details.
array	$selectOptions	Options for the SELECT part of the query, see DatabaseBase::select() for details.

Returns:: ResultWrapper

Reimplemented from DatabaseBase.

Definition at line 727 of file DatabaseOracle.php.

DatabaseOracle::isQuotedIdentifier ( $ name )

Returns if the given identifier looks quoted or not according to the database convention for quoting identifiers .

Parameters:

string $name

Returns:: bool

Reimplemented from DatabaseBase.

Definition at line 1300 of file DatabaseOracle.php.

DatabaseOracle::lastErrno ( )

Get the last error number.

See also:: http://www.php.net/mysql_errno

Returns:: int

Implements DatabaseType.

Definition at line 521 of file DatabaseOracle.php.

DatabaseOracle::lastError ( )

Get a description of the last error.

See also:: http://www.php.net/mysql_error

Returns:: string

Implements DatabaseType.

Definition at line 511 of file DatabaseOracle.php.

References $res.

DatabaseOracle::limitResult	(	$	sql,
		$	limit,
		$	offset = `false`
	)

Construct a LIMIT query with optional offset.

This is used for query pages. The SQL should be adjusted so that only the first $limit rows are returned. If $offset is provided as well, then the first $offset rows should be discarded, and the next $limit rows should be returned. If the result of the query is not ordered, then the rows to be returned are theoretically arbitrary.

$sql is expected to be a SELECT, if that makes a difference.

The version provided by default works in MySQL and SQLite. It will very likely need to be overridden for most other DBMSes.

Parameters:

string	$sql	SQL query we will append the limit too
int	$limit	The SQL limit
int \| bool	$offset	The SQL offset (default false)

Exceptions:

DBUnexpectedError

Returns:: string

Reimplemented from DatabaseBase.

Definition at line 885 of file DatabaseOracle.php.

DatabaseOracle::listTables	(	$	prefix = `null`,
		$	fname = `__METHOD__`
	)

List all tables on the database.

Parameters:

string	$prefix	Only show tables with this prefix, e.g. mw_
string	$fname	Calling function name

Exceptions:

MWException

Reimplemented from DatabaseBase.

Definition at line 932 of file DatabaseOracle.php.

DatabaseOracle::makeSelectOptions ( $ options )

Returns an optional USE INDEX clause to go after the table, and a string to go at the end of the query.

Parameters:

array $options An associative array of options to be turned into an SQL query, valid keys are listed in the function.

Returns:: array

Reimplemented from DatabaseBase.

Definition at line 1353 of file DatabaseOracle.php.

DatabaseOracle::nextSequenceValue ( $ seqName )

Return the next in a sequence, save the value for retrieval via insertId()

Parameters:

string $seqName

Returns:: null|int

Reimplemented from DatabaseBase.

Definition at line 830 of file DatabaseOracle.php.

References $res, and query.

DatabaseOracle::numFields ( $ res )

Get the number of fields in a result object.

See also:: http://www.php.net/mysql_num_fields

Parameters:

mixed $res A SQL result

Returns:: int

Implements DatabaseType.

Definition at line 479 of file DatabaseOracle.php.

References $res.

DatabaseOracle::numRows ( $ res )

Get the number of rows in a result object.

Parameters:

mixed $res A SQL result

Returns:: int

Implements DatabaseType.

Definition at line 471 of file DatabaseOracle.php.

References $res.

DatabaseOracle::open	(	$	server,
		$	user,
		$	password,
		$	dbName
	)

Usually aborts on failure.

Parameters:

string	$server
string	$user
string	$password
string	$dbName

Exceptions:

DBConnectionError

Returns:: DatabaseBase|null

Implements DatabaseType.

Definition at line 277 of file DatabaseOracle.php.

DatabaseOracle::queryIgnore	(	$	sql,
		$	fname = `''`
	)

Definition at line 435 of file DatabaseOracle.php.

DatabaseOracle::realTimestamps ( )

Returns true if this database uses timestamps rather than integers.

Returns:: bool

Reimplemented from DatabaseBase.

Definition at line 252 of file DatabaseOracle.php.

DatabaseOracle::removeIdentifierQuotes ( $ s )

Definition at line 1296 of file DatabaseOracle.php.

References $s.

DatabaseOracle::reportQueryError	(	$	error,
		$	errno,
		$	sql,
		$	fname,
		$	tempIgnore = `false`
	)

Report a query error.

Log the error, and if neither the object ignore flag nor the $tempIgnore flag is set, throw a DBQueryError.

Parameters:

string	$error
int	$errno
string	$sql
string	$fname
bool	$tempIgnore

Exceptions:

DBQueryError

Reimplemented from DatabaseBase.

Definition at line 981 of file DatabaseOracle.php.

DatabaseOracle::searchableIPs ( )

Returns true if this database can do a native search on IP columns e.g.

this works as expected: .. WHERE rc_ip = '127.42.12.102/32';

Returns:: bool

Reimplemented from DatabaseBase.

Definition at line 264 of file DatabaseOracle.php.

DatabaseOracle::selectDB ( $ db )

Change the current database.

Todo:: Explain what exactly will fail if this is not overridden.

Parameters:

string $db

Returns:: bool Success or failure

Reimplemented from DatabaseBase.

Definition at line 1253 of file DatabaseOracle.php.

DatabaseOracle::selectRow	(	$	table,
		$	vars,
		$	conds,
		$	fname = `__METHOD__`,
		$	options = `array()`,
		$	join_conds = `array()`
	)

Single row SELECT wrapper.

Equivalent to DatabaseBase::select(), except that a single row object is returned. If the query returns no rows, false is returned.

Parameters:

string \| array	$table	Table name
string \| array	$vars	Field names
array	$conds	Conditions
string	$fname	Caller function name
string \| array	$options	Query options
array \| string	$join_conds	Join conditions

Returns:: stdClass|bool

Reimplemented from DatabaseBase.

Definition at line 1335 of file DatabaseOracle.php.

DatabaseOracle::sourceStream	(	$	fp,
		$	lineCallback = `false`,
		$	resultCallback = `false`,
		$	fname = `__METHOD__`,
		$	inputCallback = `false`
	)

';

Parameters:

resource	$fp
bool \| string	$lineCallback
bool \| callable	$resultCallback
string	$fname
bool \| callable	$inputCallback

Returns:: bool|string

Reimplemented from DatabaseBase.

Definition at line 1175 of file DatabaseOracle.php.

DatabaseOracle::strencode ( $ s )

Wrapper for addslashes()

Parameters:

string $s String to be slashed.

Returns:: string Slashed string.

Implements DatabaseType.

Definition at line 1275 of file DatabaseOracle.php.

DatabaseOracle::strictIPs ( )

Returns true if this database is strict about what can be put into an IP field.

Specifically, it uses a NULL value instead of an empty string.

Returns:: bool

Reimplemented from DatabaseBase.

Definition at line 248 of file DatabaseOracle.php.

DatabaseOracle::tableExists	(	$	table,
		$	fname = `__METHOD__`
	)

Query whether a given table exists (in the given schema, or the default mw one if not given)

Parameters:

string	$table
string	$fname

Returns:: bool

Reimplemented from DatabaseBase.

Definition at line 1048 of file DatabaseOracle.php.

References $res, and tableName().

DatabaseOracle::tableName	(	$	name,
		$	format = `'quoted'`
	)

Format a table name ready for use in constructing an SQL query.

This does two important things: it quotes the table names to clean them up, and it adds a table prefix if only given a table name with no quotes.

All functions of this object which require a table name call this function themselves. Pass the canonical name to such functions. This is only needed when calling query() directly.

Parameters:

string	$name	Database table name
string	$format	One of: quoted - Automatically pass the table name through addIdentifierQuotes() so that it can be used in a query. raw - Do not add identifier quotes to the table name

Returns:: string Full database name

Reimplemented from DatabaseBase.

Definition at line 800 of file DatabaseOracle.php.

References $name.

DatabaseOracle::tableNameInternal ( $ name )

Definition at line 818 of file DatabaseOracle.php.

DatabaseOracle::textFieldSize	(	$	table,
		$	field
	)

Returns the size of a text field, or -1 for "unlimited".

Parameters:

string	$table
string	$field

Returns:: mixed

Reimplemented from DatabaseBase.

Definition at line 879 of file DatabaseOracle.php.

DatabaseOracle::timestamp ( $ ts = 0 )

Convert a timestamp in one of the formats accepted by wfTimestamp() to the format used for inserting into timestamp fields in this DBMS.

The result is unquoted, and needs to be passed through addQuotes() before it can be included in raw SQL.

Parameters:

string | int $ts

Returns:: string

Reimplemented from DatabaseBase.

Definition at line 966 of file DatabaseOracle.php.

DatabaseOracle::unionQueries	(	$	sqls,
		$	all
	)

Construct a UNION query This is used for providing overload point for other DB abstractions not compatible with the MySQL syntax.

Parameters:

array	$sqls	SQL statements to combine
bool	$all	Use UNION ALL

Returns:: string SQL fragment

Reimplemented from DatabaseBase.

Definition at line 905 of file DatabaseOracle.php.

DatabaseOracle::update	(	$	table,
		$	values,
		$	conds,
		$	fname = `__METHOD__`,
		$	options = `array()`
	)

Parameters:

string	$table
array	$values
array	$conds
string	$fname
array	$options

Returns:: bool

Exceptions:

DBUnexpectedError

Reimplemented from DatabaseBase.

Definition at line 1428 of file DatabaseOracle.php.

DatabaseOracle::upsert	(	$	table,
		array $	rows,
		array $	uniqueIndexes,
		array $	set,
		$	fname = `__METHOD__`
	)

INSERT ON DUPLICATE KEY UPDATE wrapper, upserts an array into a table.

This updates any conflicting rows (according to the unique indexes) using the provided SET clause and inserts any remaining (non-conflicted) rows.

$rows may be either:

A single associative array. The array keys are the field names, and the values are the values to insert. The values are treated as data and will be quoted appropriately. If NULL is inserted, this will be converted to a database NULL.
An array with numeric keys, holding a list of associative arrays. This causes a multi-row INSERT on DBMSs that support it. The keys in each subarray must be identical to each other, and in the same order.

It may be more efficient to leave off unique indexes which are unlikely to collide. However if you do this, you run the risk of encountering errors which wouldn't have occurred in MySQL.

Usually throws a DBQueryError on failure. If errors are explicitly ignored, returns success.

Since:: 1.22

Parameters:

string	$table	Table name. This will be passed through DatabaseBase::tableName().
array	$rows	A single row or list of rows to insert
array	$uniqueIndexes	List of single field names or field name tuples
array	$set	An array of values to SET. For each array element, the key gives the field name, and the value gives the data to set that field to. The data will be quoted by DatabaseBase::addQuotes().
string	$fname	Calling function name (use __METHOD__) for logs/profiling

Exceptions:

Exception

Returns:: bool

Reimplemented from DatabaseBase.

Definition at line 774 of file DatabaseOracle.php.

DatabaseOracle::wasDeadlock ( )

Determines if the last failure was due to a deadlock STUB.

Returns:: bool

Reimplemented from DatabaseBase.

Definition at line 912 of file DatabaseOracle.php.

DatabaseOracle::wrapConditionsForWhere	(	$	table,
		$	conds,
		$	parentCol = `null`
	)		`[private]`

Definition at line 1317 of file DatabaseOracle.php.

DatabaseOracle::wrapFieldForWhere	(	$	table,
		&$	col,
		&$	val
	)		`[private]`

Definition at line 1304 of file DatabaseOracle.php.

Member Data Documentation

string DatabaseOracle::$defaultCharset = 'AL32UTF8' [private]

Character set for Oracle database *.

Definition at line 199 of file DatabaseOracle.php.

bool DatabaseOracle::$ignoreDupValOnIndex = false [private]

*

Definition at line 195 of file DatabaseOracle.php.

int DatabaseOracle::$mAffectedRows [protected]

The number of rows affected as an integer *.

Definition at line 191 of file DatabaseOracle.php.

array DatabaseOracle::$mFieldInfoCache = array() [private]

*

Definition at line 201 of file DatabaseOracle.php.

int DatabaseOracle::$mInsertId = null [private]

*

Definition at line 193 of file DatabaseOracle.php.

resource DatabaseOracle::$mLastResult = null [protected]

*

Definition at line 189 of file DatabaseOracle.php.

bool array DatabaseOracle::$sequenceData = null [private]

*

Definition at line 197 of file DatabaseOracle.php.

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

includes/db/DatabaseOracle.php

Public Member Functions

Protected Member Functions

Protected Attributes

Private Member Functions

Private Attributes

Detailed Description

Constructor & Destructor Documentation

Member Function Documentation

Member Data Documentation