Inheritance diagram for DatabasePostgres:

Collaboration diagram for DatabasePostgres:

Public Member Functions
	addQuotes ($s)

	affectedRows ()
	Get the number of rows affected by the last write query. More...

	aggregateValue ($valuedata, $valuename= 'value')
	Return aggregated value function call. More...

	buildConcat ($stringList)
	Build a concatenation list to feed into a SQL query. More...

	buildGroupConcatField ($delimiter, $table, $field, $conds= '', $options=[], $join_conds=[])

	cascadingDeletes ()

	cleanupTriggers ()

	constraintExists ($table, $constraint)

	currentSequenceValue ($seqName)
	Return the current value of a sequence. More...

	dataSeek ($res, $row)

	decodeBlob ($b)
	Some DBMSs return a special placeholder object representing blob fields in result objects. More...

	determineCoreSchema ($desiredSchema)
	Determine default schema for MediaWiki core Adjust this session schema search path if desired schema exists and is not alread there. More...

	doQuery ($sql)

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

	encodeBlob ($b)

	estimateRowCount ($table, $vars= '*', $conds= '', $fname=__METHOD__, $options=[])
	Estimate rows in dataset Returns estimated count, based on EXPLAIN output This is not necessarily an accurate estimate, so use sparingly Returns -1 if count cannot be found Takes same arguments as Database::select() More...

	fetchObject ($res)

	fetchRow ($res)
	Fetch the next row from the given result object, in associative array form. More...

	fieldInfo ($table, $field)
	mysql_fetch_field() wrapper Returns false if the field doesn't exist More...

	fieldName ($res, $n)
	Get a field name in a result object. More...

	fieldType ($res, $index)
	pg_field_type() wrapper More...

	freeResult ($res)

	functionalIndexes ()

	getCoreSchema ()
	Return schema name fore core MediaWiki tables. More...

	getCurrentSchema ()
	Return current schema (executes SELECT current_schema()) Needs transaction. More...

	getDBname ()
	Get the current DB name. More...

	getSchemas ()
	Return list of schemas which are accessible without schema name This is list does not contain magic keywords like "$user" Needs transaction. More...

	getSearchEngine ()

	getSearchPath ()
	Return search patch for schemas This is different from getSchemas() since it contain magic keywords (like "$user"). More...

	getServer ()
	Get the server hostname or IP address. More...

	getServerVersion ()

	getSoftwareLink ()

	getType ()
	Get the type of the DBMS, as it appears in $wgDBtype. More...

	hasConstraint ($name)

	implicitGroupby ()
	Returns true if this database does an implicit sort when doing GROUP BY. More...

	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. More...

	indexAttributes ($index, $schema=false)
	Returns is of attributes used in index. More...

	indexInfo ($table, $index, $fname=__METHOD__)
	Returns information about an index If errors are explicitly ignored, returns NULL on failure. More...

	indexUnique ($table, $index, $fname=__METHOD__)

	insert ($table, $args, $fname=__METHOD__, $options=[])
	INSERT wrapper, inserts an array into a table. More...

	insertId ()
	Return the result of the last call to nextSequenceValue(); This must be called after nextSequenceValue(). More...

	insertSelect ($destTable, $srcTable, $varMap, $conds, $fname=__METHOD__, $insertOptions=[], $selectOptions=[])
	INSERT SELECT wrapper $varMap must be an associative array of the form array( 'dest1' => 'source1', ...) Source items may be literals rather then field names, but strings should be quoted with Database::addQuotes() $conds may be "*" to copy the whole table srcTable may be an array of tables. More...

	lastErrno ()
	Get the last error number. More...

	lastError ()
	Get a description of the last error. More...

	limitResult ($sql, $limit, $offset=false)

	listTables ($prefix=null, $fname=__METHOD__)
	List all tables on the database. More...

	lock ($lockName, $method, $timeout=5)
	See http://www.postgresql.org/docs/8.2/static/functions-admin.html#FUNCTIONS-ADVISORY-LOCKS. More...

	lockIsFree ($lockName, $method)
	Check to see if a named lock is available. More...

	makeConnectionString ($vars)

	makeSelectOptions ($options)
	Various select options. More...

	nextSequenceValue ($seqName)
	Return the next in a sequence, save the value for retrieval via insertId() More...

	numFields ($res)
	Get the number of fields in a result object. More...

	numRows ($res)
	Get the number of rows in a result object. More...

	open ($server, $user, $password, $dbName)
	Usually aborts on failure. More...

	pg_array_parse ($text, &$output, $limit=false, $offset=1)
	Posted by cc[plus]php[at]c2se[dot]com on 25-Mar-2009 09:12 to http://www.php.net/manual/en/ref.pgsql.php. More...

	queryIgnore ($sql, $fname=__METHOD__)

	realTableName ($name, $format= 'quoted')

	realTimestamps ()

	relationExists ($table, $types, $schema=false)
	Query whether a given relation exists (in the given schema, or the default mw one if not given) More...

	reportQueryError ($error, $errno, $sql, $fname, $tempIgnore=false)
	Report a query error. More...

	roleExists ($roleName)
	Returns true if a given role (i.e. More...

	ruleExists ($table, $rule)

	schemaExists ($schema)
	Query whether a given schema exists. More...

	searchableIPs ()

	selectDB ($db)
	Postgres doesn't support selectDB in the same way MySQL does. More...

	selectSQLText ($table, $vars, $conds= '', $fname=__METHOD__, $options=[], $join_conds=[])
	Change the FOR UPDATE option as necessary based on the join conditions. More...

	sequenceExists ($sequence, $schema=false)

	setSearchPath ($search_path)
	Update search_path, values should already be sanitized Values may contain magic keywords like "$user". More...

	streamStatementEnd (&$sql, &$newLine)

	strencode ($s)

	strictIPs ()

	tableExists ($table, $fname=__METHOD__, $schema=false)
	For backward compatibility, this function checks both tables and views. More...

	tableName ($name, $format= 'quoted')

	textFieldSize ($table, $field)

	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. More...

	triggerExists ($table, $trigger)

	unlock ($lockName, $method)
	See http://www.postgresql.org/docs/8.2/static/functions-admin.html#FUNCTIONS-ADVISORY-LOCKSFROM PG DOCS: http://www.postgresql.org/docs/8.2/static/functions-admin.html#FUNCTIONS-ADVISORY-LOCKS. More...

	wasDeadlock ()
	Determines if the last failure was due to a deadlock STUB. More...

Public Member Functions inherited from DatabaseBase
	__construct (array $params)
	Constructor. More...

	__destruct ()
	Run a few simple sanity checks. More...

	__sleep ()
	Called by serialize. More...

	__toString ()

	addIdentifierQuotes ($s)
	Quotes an identifier using `backticks` or "double quotes" depending on the database type. More...

	addQuotes ($s)
	Adds quotes and backslashes. More...

	aggregateValue ($valuedata, $valuename= 'value')
	Return aggregated value alias. More...

	anyChar ()
	Returns a token for buildLike() that denotes a '_' to be used in a LIKE query. More...

	anyString ()
	Returns a token for buildLike() that denotes a '' to be used in a LIKE query. More...

	begin ($fname=__METHOD__)
	Begin a transaction. More...

	bitAnd ($fieldLeft, $fieldRight)

	bitNot ($field)

	bitOr ($fieldLeft, $fieldRight)

	bufferResults ($buffer=null)
	Turns buffering of SQL result sets on (true) or off (false). More...

	buildConcat ($stringList)
	Build a concatenation list to feed into a SQL query. More...

	buildGroupConcatField ($delim, $table, $field, $conds= '', $join_conds=[])
	Build a GROUP_CONCAT or equivalent statement for a query. More...

	buildLike ()
	LIKE statement wrapper, receives a variable-length argument list with parts of pattern to match containing either string literals that will be escaped or tokens returned by anyChar() or anyString(). More...

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

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

	clearFlag ($flag)
	Clear a flag for this connection. More...

	clearViewsCache ()
	Reset the views process cache set by listViews() More...

	close ()
	Closes a database connection. More...

	commit ($fname=__METHOD__, $flush= '')
	Commits a transaction previously started using begin(). More...

	conditional ($cond, $trueVal, $falseVal)
	Returns an SQL expression for a simple conditional. More...

	connectionErrorHandler ($errno, $errstr)

	dbSchema ($schema=null)
	Get/set the db schema. More...

	deadlockLoop ()
	Perform a deadlock-prone transaction. More...

	debug ($debug=null)
	Boolean, controls output of large amounts of debug information. More...

	decodeBlob ($b)
	Some DBMSs return a special placeholder object representing blob fields in result objects. More...

	decodeExpiry ($expiry, $format=TS_MW)
	Decode an expiry time into a DBMS independent format. More...

	delete ($table, $conds, $fname=__METHOD__)
	DELETE query wrapper. More...

	deleteJoin ($delTable, $joinTable, $delVar, $joinVar, $conds, $fname=__METHOD__)
	DELETE where the condition is a join. More...

	doAtomicSection ($fname, $callback)
	Run a callback to do an atomic set of updates for this database. More...

	doneWrites ()
	Returns true if the connection may have been used for write queries. More...

	dropTable ($tableName, $fName=__METHOD__)
	Delete a table. More...

	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. More...

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

	encodeExpiry ($expiry)
	Encode an expiry time into the DBMS dependent format. More...

	endAtomic ($fname=__METHOD__)
	Ends an atomic section of SQL statements. More...

	estimateRowCount ($table, $vars= '*', $conds= '', $fname=__METHOD__, $options=[])
	Estimate the number of rows in dataset. More...

	execute ($prepared, $args=null)
	Execute a prepared query with the various arguments. More...

	fieldExists ($table, $field, $fname=__METHOD__)
	Determines whether a field exists in a table. More...

	fieldNamesWithAlias ($fields)
	Gets an array of aliased field names. More...

	fieldNameWithAlias ($name, $alias=false)
	Get an aliased field name e.g. More...

	fillPrepared ($preparedQuery, $args)
	For faking prepared SQL statements on DBs that don't support it directly. More...

	freeResult ($res)
	Free a result object returned by query() or select(). More...

	functionalIndexes ()
	Returns true if this database can use functional indexes. More...

	getApproximateLagStatus ()
	Get a slave lag estimate for this server. More...

	getDBname ()
	Get the current DB name. More...

	getDelimiter ()

	getFlag ($flag)
	Returns a boolean whether the flag $flag is set for this connection. More...

	getInfinity ()
	Find out when 'infinity' is. More...

	getLag ()
	Get slave lag. More...

	getLazyMasterHandle ()

	getLBInfo ($name=null)
	Get properties passed down from the server info array of the load balancer. More...

	getMasterPos ()
	Get the position of this master. More...

	getProperty ($name)
	General read-only accessor. More...

	getSchemaPath ()
	Return a path to the DBMS-specific schema file, otherwise default to tables.sql. More...

	getScopedLockAndFlush ($lockKey, $fname, $timeout)
	Acquire a named lock, flush any transaction, and return an RAII style unlocker object. More...

	getSearchEngine ()
	Get search engine class. More...

	getServer ()
	Get the server hostname or IP address. More...

	getServerInfo ()
	A string describing the current software version, and possibly other details in a user-friendly way. More...

	getServerUptime ()
	Determines how long the server has been up STUB. More...

	getSessionLagStatus ()
	Get the slave lag when the current transaction started or a general lag estimate if not transaction is active. More...

	getSlavePos ()
	Get the replication position of this slave. More...

	getTransactionLagStatus ()
	Get the slave lag when the current transaction started. More...

	getUpdateKeysPath ()
	Return a path to the DBMS-specific update key file, otherwise default to update-keys.sql. More...

	getWikiID ()

	implicitGroupby ()
	Returns true if this database does an implicit sort when doing GROUP BY. More...

	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. More...

	indexExists ($table, $index, $fname=__METHOD__)
	Determines whether an index exists Usually throws a DBQueryError on failure If errors are explicitly ignored, returns NULL on failure. More...

	indexInfo ($table, $index, $fname=__METHOD__)
	Get information about an index into an object. More...

	indexUnique ($table, $index)
	Determines if a given index is unique. More...

	insert ($table, $a, $fname=__METHOD__, $options=[])
	INSERT wrapper, inserts an array into a table. More...

	insertSelect ($destTable, $srcTable, $varMap, $conds, $fname=__METHOD__, $insertOptions=[], $selectOptions=[])
	INSERT SELECT wrapper. More...

	isOpen ()
	Is a connection to the database open? More...

	isQuotedIdentifier ($name)
	Returns if the given identifier looks quoted or not according to the database convention for quoting identifiers . More...

	isReadOnly ()

	isView ($name)
	Differentiates between a TABLE and a VIEW. More...

	lastDoneWrites ()
	Returns the last time the connection may have been used for write queries. More...

	lastQuery ()
	Return the last query that went through IDatabase::query() More...

	limitResult ($sql, $limit, $offset=false)
	Construct a LIMIT query with optional offset. More...

	listTables ($prefix=null, $fname=__METHOD__)
	List all tables on the database. More...

	listViews ($prefix=null, $fname=__METHOD__)
	Lists all the VIEWs in the database. More...

	lock ($lockName, $method, $timeout=5)
	Acquire a named lock. More...

	lockIsFree ($lockName, $method)
	Check to see if a named lock is available (non-blocking) More...

	lockTables ($read, $write, $method, $lowPriority=true)
	Lock specific tables. More...

	lowPriorityOption ()
	A string to insert into queries to show that they're low-priority, like MySQL's LOW_PRIORITY. More...

	makeGroupByWithHaving ($options)
	Returns an optional GROUP BY with an optional HAVING. More...

	makeList ($a, $mode=LIST_COMMA)
	Makes an encoded list of strings from an array. More...

	makeOrderBy ($options)
	Returns an optional ORDER BY. More...

	makeSelectOptions ($options)
	Returns an optional USE INDEX clause to go after the table, and a string to go at the end of the query. More...

	makeWhereFrom2d ($data, $baseKey, $subKey)
	Build a partial where clause from a 2-d array such as used for LinkBatch. More...

	masterPosWait (DBMasterPos $pos, $timeout)
	Wait for the slave to catch up to a given master position. More...

	maxListLen ()
	Return the maximum number of items allowed in a list, or 0 for unlimited. More...

	namedLocksEnqueue ()
	Check to see if a named lock used by lock() use blocking queues. More...

	nextSequenceValue ($seqName)
	Returns an appropriately quoted sequence value for inserting a new row. More...

	onTransactionIdle ($callback)
	Run an anonymous function as soon as there is no transaction pending. More...

	onTransactionPreCommitOrIdle ($callback)
	Run an anonymous function before the current transaction commits or now if there is none. More...

	patchPath ($patch)
	Get the full path of a patch file. More...

	pendingWriteCallers ()
	Get the list of method names that did write queries for this transaction. More...

	pendingWriteQueryDuration ()
	Get the time spend running write queries for this transaction. More...

	ping ()
	Ping the server and try to reconnect if it there is no connection. More...

	query ($sql, $fname=__METHOD__, $tempIgnore=false)
	Run an SQL query and return the result. More...

	realTimestamps ()
	Returns true if this database uses timestamps rather than integers. More...

	replace ($table, $uniqueIndexes, $rows, $fname=__METHOD__)
	REPLACE query wrapper. More...

	reportConnectionError ($error= 'Unknown error')

	reportQueryError ($error, $errno, $sql, $fname, $tempIgnore=false)
	Report a query error. More...

	rollback ($fname=__METHOD__, $flush= '')
	Rollback a transaction previously started using begin(). More...

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

	select ($table, $vars, $conds= '', $fname=__METHOD__, $options=[], $join_conds=[])
	Execute a SELECT query constructed using the various parameters provided. More...

	selectDB ($db)
	Change the current database. More...

	selectField ($table, $var, $cond= '', $fname=__METHOD__, $options=[])
	A SELECT wrapper which returns a single field from a single result row. More...

	selectFieldValues ($table, $var, $cond= '', $fname=__METHOD__, $options=[], $join_conds=[])

	selectRow ($table, $vars, $conds, $fname=__METHOD__, $options=[], $join_conds=[])
	Single row SELECT wrapper. More...

	selectRowCount ($tables, $vars= '*', $conds= '', $fname=__METHOD__, $options=[], $join_conds=[])
	Get the number of rows in dataset. More...

	selectSQLText ($table, $vars, $conds= '', $fname=__METHOD__, $options=[], $join_conds=[])
	The equivalent of IDatabase::select() except that the constructed SQL is returned, instead of being immediately executed. More...

	setBigSelects ($value=true)
	Allow or deny "big selects" for this session only. More...

	setFileHandle ($fh)
	Set the filehandle to copy write statements to. More...

	setFlag ($flag)
	Set a flag for this connection. More...

	setLazyMasterHandle (IDatabase $conn)
	Set a lazy-connecting DB handle to the master DB (for replication status purposes) More...

	setLBInfo ($name, $value=null)
	Set the LB info array, or a member of it. More...

	setSchemaVars ($vars)
	Set variables to be used in sourceFile/sourceStream, in preference to the ones in $GLOBALS. More...

	setSessionOptions (array $options)
	Override database's default behavior. More...

	setTransactionProfiler (TransactionProfiler $profiler)

	sourceFile ($filename, $lineCallback=false, $resultCallback=false, $fname=false, $inputCallback=false)
	Read and execute SQL commands from a file. More...

	sourceStream ($fp, $lineCallback=false, $resultCallback=false, $fname=__METHOD__, $inputCallback=false)
	Read and execute commands from an open file handle. More...

	startAtomic ($fname=__METHOD__)
	Begin an atomic section of statements. More...

	streamStatementEnd (&$sql, &$newLine)
	Called by sourceStream() to check if we've reached a statement end. More...

	strencode ($s)
	Wrapper for addslashes() More...

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

	strreplace ($orig, $old, $new)
	Returns a comand for str_replace function in SQL query. More...

	tableExists ($table, $fname=__METHOD__)
	Query whether a given table exists. More...

	tableName ($name, $format= 'quoted')
	Format a table name ready for use in constructing an SQL query. More...

	tableNames ()
	Fetch a number of table names into an array This is handy when you need to construct SQL for joins. More...

	tableNamesN ()
	Fetch a number of table names into an zero-indexed numerical array This is handy when you need to construct SQL for joins. More...

	tableNamesWithAlias ($tables)
	Gets an array of aliased table names. More...

	tableNameWithAlias ($name, $alias=false)
	Get an aliased table name e.g. More...

	tablePrefix ($prefix=null)
	Get/set the table prefix. More...

	textFieldSize ($table, $field)
	Returns the size of a text field, or -1 for "unlimited". More...

	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. More...

	timestampOrNull ($ts=null)
	Convert a timestamp in one of the formats accepted by wfTimestamp() to the format used for inserting into timestamp fields in this DBMS. More...

	trxLevel ()
	Gets the current transaction level. More...

	trxTimestamp ()
	Get the UNIX timestamp of the time that the transaction was established. More...

	unionQueries ($sqls, $all)
	Construct a UNION query This is used for providing overload point for other DB abstractions not compatible with the MySQL syntax. More...

	unionSupportsOrderAndLimit ()
	Returns true if current database backend supports ORDER BY or LIMIT for separate subqueries within the UNION construct. More...

	unlock ($lockName, $method)
	Release a lock. More...

	unlockTables ($method)
	Unlock specific tables. More...

	update ($table, $values, $conds, $fname=__METHOD__, $options=[])
	UPDATE wrapper. More...

	upsert ($table, array $rows, array $uniqueIndexes, array $set, $fname=__METHOD__)
	INSERT ON DUPLICATE KEY UPDATE wrapper, upserts an array into a table. More...

	useIndexClause ($index)
	USE INDEX clause. More...

	wasConnectionError ($errno)
	Determines if the given query error was a connection drop STUB. More...

	wasDeadlock ()
	Determines if the last failure was due to a deadlock STUB. More...

	wasErrorReissuable ()
	Determines if the last query error was something that should be dealt with by pinging the connection and reissuing the query. More...

	wasLockTimeout ()
	Determines if the last failure was due to a lock timeout STUB. More...

	wasReadOnlyError ()
	Determines if the last failure was due to the database being read-only. More...

	writesOrCallbacksPending ()
	Returns true if there is a transaction open with possible write queries or transaction pre-commit/idle callbacks waiting on it to finish. More...

	writesPending ()

Public Member Functions inherited from IDatabase
	selectFieldValues ($table, $var, $cond= '', $fname=__METHOD__, $options=[])
	A SELECT wrapper which returns a list of single field values from result rows. More...

Protected Member Functions
	closeConnection ()
	Closes a database connection, if it is open Returns success, true if already closed. More...

	dumpError ()

	replaceVars ($ins)
	Postgres specific version of replaceVars. More...

Protected Member Functions inherited from DatabaseBase
	assertOpen ()
	Make sure isOpen() returns true as a sanity check. More...

	closeConnection ()
	Closes underlying database connection. More...

	doBegin ($fname)
	Issues the BEGIN command to the database server. More...

	doCommit ($fname)
	Issues the COMMIT command to the database server. More...

	doQuery ($sql)
	The DBMS-dependent part of query() More...

	doRollback ($fname)
	Issues the ROLLBACK command to the database server. More...

	escapeLikeInternal ($s)

	fillPreparedArg ($matches)
	preg_callback func for fillPrepared() The arguments should be in $this->preparedArgs and must not be touched while we're doing this. More...

	freePrepared ($prepared)
	Free a prepared query, generated by prepare(). More...

	getDefaultSchemaVars ()
	Get schema variables to use if none have been set via setSchemaVars(). More...

	getLogContext (array $extras=[])
	Create a log context to pass to wfLogDBError or other logging functions. More...

	getReadOnlyReason ()

	getSchemaVars ()
	Get schema variables. More...

	getTransactionProfiler ()

	ignoreErrors ($ignoreErrors=null)
	Turns on (false) or off (true) the automatic generation and sending of a "we're sorry, but there has been a database error" page on database errors. More...

	indexName ($index)
	Get the name of an index in a given table. More...

	installErrorHandler ()

	isTransactableQuery ($sql)
	Determine whether a SQL statement is sensitive to isolation level. More...

	isWriteQuery ($sql)
	Determine whether a query writes to the DB. More...

	makeInsertOptions ($options)
	Helper for DatabaseBase::insert(). More...

	makeUpdateOptions ($options)
	Make UPDATE options for the DatabaseBase::update function. More...

	makeUpdateOptionsArray ($options)
	Make UPDATE options array for DatabaseBase::makeUpdateOptions. More...

	nativeReplace ($table, $rows, $fname)
	REPLACE query wrapper for MySQL and SQLite, which have a native REPLACE statement. More...

	prepare ($sql, $func= 'DatabaseBase::prepare')
	Intended to be compatible with the PEAR::DB wrapper functions. More...

	replaceVars ($ins)
	Database independent variable replacement. More...

	restoreErrorHandler ()

	resultObject ($result)
	Take the result from a query, and wrap it in a ResultWrapper if necessary. More...

	runOnTransactionIdleCallbacks ()
	Actually any "on transaction idle" callbacks. More...

	runOnTransactionPreCommitCallbacks ()
	Actually any "on transaction pre-commit" callbacks. More...

	tableNamesWithUseIndexOrJOIN ($tables, $use_index=[], $join_conds=[])
	Get the aliased table name clause for a FROM clause which might have a JOIN and/or USE INDEX clause. More...

Protected Attributes
int	$mAffectedRows = null
	The number of rows affected as an integer. More...

resource	$mLastResult = null

Protected Attributes inherited from DatabaseBase
string[]	$allViews = null

	$delimiter = ';'

resource	$fileHandle = null

	$htmlErrors

resource	$mConn = null
	Database connection. More...

	$mDefaultBigSelects = null

	$mDoneWrites = false

	$mFlags

	$mForeign

	$mLastQuery = ''

	$mLBInfo = []

	$mOpened = false

	$mPHPError = false

	$mSchema

	$mSchemaVars = false

	$mServer

array	$mSessionVars = []

	$mTablePrefix

callable[]	$mTrxIdleCallbacks = []

int	$mTrxLevel = 0
	Either 1 if a transaction is active or 0 otherwise. More...

callable[]	$mTrxPreCommitCallbacks = []

string	$mTrxShortId = ''
	Either a short hexidecimal string if a transaction is active or "". More...

	$preparedArgs

BagOStuff	$srvCache
	APC cache. More...

TransactionProfiler	$trxProfiler

Private Member Functions
	bigintFromLockName ($lockName)

Private Attributes
string	$connectString
	Connect string to open a PostgreSQL connection. More...

string	$mCoreSchema

int	$mInsertId = null

float string	$numericVersion = null

Additional Inherited Members
Static Public Member Functions inherited from DatabaseBase
static	factory ($dbType, $p=[])
	Given a DB type, construct the name of the appropriate child class of DatabaseBase. More...

static	getCacheSetOptions (IDatabase $db1)
	Merge the result of getSessionLagStatus() for several DBs using the most pessimistic values to estimate the lag of any data derived from them in combination. More...

Public Attributes inherited from DatabaseBase
	$mDBname

	$mPassword

	$mUser

const	DEADLOCK_DELAY_MAX = 1500000
	Maximum time to wait before retry. More...

const	DEADLOCK_DELAY_MIN = 500000
	Minimum time to wait before retry, in microseconds. More...

const	DEADLOCK_TRIES = 4
	Number of times to re-try an operation in case of deadlock. More...

Static Protected Member Functions inherited from DatabaseBase
static	generalizeSQL ($sql)
	Removes most variables from an SQL query and replaces them with X or N for numbers. More...

Detailed Description

Definition at line 185 of file DatabasePostgres.php.

Member Function Documentation

DatabasePostgres::addQuotes ( $s )

Parameters

null | bool | Blob $s

Returns: int|string

Implements IDatabase.

Definition at line 1410 of file DatabasePostgres.php.

Referenced by schemaExists().

DatabasePostgres::affectedRows ( )

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

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

Returns: int

Implements IDatabase.

Definition at line 568 of file DatabasePostgres.php.

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

Return aggregated value function call.

Parameters

array	$valuedata
string	$valuename

Returns: array

Definition at line 1099 of file DatabasePostgres.php.

DatabasePostgres::bigintFromLockName ( $lockName )

private

Parameters

string $lockName

Returns: string Integer

Definition at line 1598 of file DatabasePostgres.php.

DatabasePostgres::buildConcat ( $stringList )

Build a concatenation list to feed into a SQL query.

Parameters

array $stringList List of raw SQL expressions; caller is responsible for any quoting

Returns: string

Implements IDatabase.

Definition at line 1499 of file DatabasePostgres.php.

References $options.

DatabasePostgres::buildGroupConcatField	(	$delimiter,
		$table,
		$field,
		$conds = `''`,
		$options = `[]`,
		$join_conds = `[]`
	)

Definition at line 1503 of file DatabasePostgres.php.

DatabasePostgres::cascadingDeletes ( )

Definition at line 208 of file DatabasePostgres.php.

DatabasePostgres::cleanupTriggers ( )

Definition at line 212 of file DatabasePostgres.php.

DatabasePostgres::closeConnection ( )

protected

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

Returns: bool

Definition at line 368 of file DatabasePostgres.php.

References open().

DatabasePostgres::constraintExists	(	$table,
		$constraint
	)

Definition at line 1324 of file DatabasePostgres.php.

DatabasePostgres::currentSequenceValue ( $seqName )

Return the current value of a sequence.

Assumes it has been nextval'ed in this session.

Parameters

string $seqName

Returns: int

Definition at line 985 of file DatabasePostgres.php.

References $res, and DatabaseBase\query().

DatabasePostgres::dataSeek	(	$res,
		$row
	)

Parameters

mixed	$res
int	$row

Returns: bool

Implements IDatabase.

Definition at line 540 of file DatabasePostgres.php.

References $res.

DatabasePostgres::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 | Blob $b

Returns: string

Implements IDatabase.

Definition at line 1390 of file DatabasePostgres.php.

DatabasePostgres::determineCoreSchema ( $desiredSchema )

Determine default schema for MediaWiki core Adjust this session schema search path if desired schema exists and is not alread there.

We need to have name of the core schema stored to be able to query database metadata.

This will be also called by the installer after the schema is created

Since: 1.19

Parameters

string $desiredSchema

Definition at line 1187 of file DatabasePostgres.php.

DatabasePostgres::doQuery ( $sql )

Definition at line 372 of file DatabasePostgres.php.

DatabasePostgres::dumpError ( )

protected

Definition at line 390 of file DatabasePostgres.php.

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

Definition at line 1020 of file DatabasePostgres.php.

DatabasePostgres::encodeBlob ( $b )

Parameters

string $b

Returns: Blob

Implements IDatabase.

Definition at line 1386 of file DatabasePostgres.php.

References PostgresField\fromText().

DatabasePostgres::estimateRowCount	(	$table,
		$vars = `'*'`,
		$conds = `''`,
		$fname = `__METHOD__`,
		$options = `[]`
	)

Estimate rows in dataset Returns estimated count, based on EXPLAIN output This is not necessarily an accurate estimate, so use sparingly Returns -1 if count cannot be found Takes same arguments as Database::select()

Parameters

string	$table
string	$vars
string	$conds
string	$fname
array	$options

Returns: int

Implements IDatabase.

Definition at line 594 of file DatabasePostgres.php.

DatabasePostgres::fetchObject ( $res )

Parameters

ResultWrapper | stdClass $res

Returns: stdClass

Exceptions

DBUnexpectedError

Implements IDatabase.

Definition at line 454 of file DatabasePostgres.php.

References $res.

DatabasePostgres::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 IDatabase::query(), etc.

Returns: array|bool

Exceptions

DBUnexpectedError Thrown if the database returns an error

Implements IDatabase.

Definition at line 475 of file DatabasePostgres.php.

DatabasePostgres::fieldInfo	(	$table,
		$field
	)

mysql_fetch_field() wrapper Returns false if the field doesn't exist

Parameters

string	$table	Table name
string	$field	Field name

Returns: Field

Implements IDatabase.

Definition at line 1364 of file DatabasePostgres.php.

DatabasePostgres::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 IDatabase.

Definition at line 517 of file DatabasePostgres.php.

DatabasePostgres::fieldType	(	$res,
		$index
	)

pg_field_type() wrapper

Parameters

ResultWrapper \| resource	$res	ResultWrapper or PostgreSQL query result resource
int	$index	Field number, starting from 0

Returns: string

Definition at line 1374 of file DatabasePostgres.php.

DatabasePostgres::freeResult ( $res )

Parameters

stdClass | ResultWrapper $res

Exceptions

DBUnexpectedError

Implements IDatabase.

Definition at line 437 of file DatabasePostgres.php.

DatabasePostgres::functionalIndexes ( )

Definition at line 236 of file DatabasePostgres.php.

DatabasePostgres::getCoreSchema ( )

Return schema name fore core MediaWiki tables.

Since: 1.19

Returns: string Core schema name

Definition at line 1221 of file DatabasePostgres.php.

Referenced by schemaExists().

DatabasePostgres::getCurrentSchema ( )

Return current schema (executes SELECT current_schema()) Needs transaction.

Since: 1.19

Returns: string Default schema for the current session

Definition at line 1117 of file DatabasePostgres.php.

DatabasePostgres::getDBname ( )

Get the current DB name.

Returns: string

Implements IDatabase.

Definition at line 1491 of file DatabasePostgres.php.

DatabasePostgres::getSchemas ( )

Return list of schemas which are accessible without schema name This is list does not contain magic keywords like "$user" Needs transaction.

See also: getSearchPath(); setSearchPath()

Since: 1.19

Returns: array List of actual schemas for the current sesson

Definition at line 1134 of file DatabasePostgres.php.

DatabasePostgres::getSearchEngine ( )

Definition at line 1511 of file DatabasePostgres.php.

DatabasePostgres::getSearchPath ( )

Return search patch for schemas This is different from getSchemas() since it contain magic keywords (like "$user").

Needs transaction

Since: 1.19

Returns: array How to search for table names schemas for the current user

Definition at line 1153 of file DatabasePostgres.php.

DatabasePostgres::getServer ( )

Get the server hostname or IP address.

Returns: string

Implements IDatabase.

Definition at line 1495 of file DatabasePostgres.php.

DatabasePostgres::getServerVersion ( )

Returns: string Version information from the database

Implements IDatabase.

Definition at line 1228 of file DatabasePostgres.php.

DatabasePostgres::getSoftwareLink ( )

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

Implements IDatabase.

Definition at line 1106 of file DatabasePostgres.php.

DatabasePostgres::getType ( )

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

Returns: string

Implements IDatabase.

Definition at line 204 of file DatabasePostgres.php.

DatabasePostgres::hasConstraint ( $name )

Definition at line 240 of file DatabasePostgres.php.

DatabasePostgres::implicitGroupby ( )

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

Returns: bool

Implements IDatabase.

Definition at line 224 of file DatabasePostgres.php.

DatabasePostgres::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

Implements IDatabase.

Definition at line 228 of file DatabasePostgres.php.

DatabasePostgres::indexAttributes	(	$index,
		$schema = `false`
	)

Returns is of attributes used in index.

Since: 1.19

Parameters

string	$index
bool \| string	$schema

Returns: array

Definition at line 643 of file DatabasePostgres.php.

DatabasePostgres::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|null

Definition at line 620 of file DatabasePostgres.php.

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

Definition at line 700 of file DatabasePostgres.php.

References as.

DatabasePostgres::insert	(	$table,
		$args,
		$fname = `__METHOD__`,
		$options = `[]`
	)

INSERT wrapper, inserts an array into a table.

$args may be a single associative array, or an array of these with numeric keys, for multi-row insert (Postgres version 8.2 and above only).

Parameters

string	$table	Name of the table to insert to.
array	$args	Items to insert into the table.
string	$fname	Name of the function, for profiling
array \| string	$options	String or array. Valid options: IGNORE

Returns: bool Success of insert operation. IGNORE always returns true.

Implements IDatabase.

Definition at line 759 of file DatabasePostgres.php.

DatabasePostgres::insertId ( )

Return the result of the last call to nextSequenceValue(); This must be called after nextSequenceValue().

Returns: int|null

Implements IDatabase.

Definition at line 531 of file DatabasePostgres.php.

References $res.

DatabasePostgres::insertSelect	(	$destTable,
		$srcTable,
		$varMap,
		$conds,
		$fname = `__METHOD__`,
		$insertOptions = `[]`,
		$selectOptions = `[]`
	)

INSERT SELECT wrapper $varMap must be an associative array of the form array( 'dest1' => 'source1', ...) Source items may be literals rather then field names, but strings should be quoted with Database::addQuotes() $conds may be "*" to copy the whole table srcTable may be an array of tables.

Todo:: FIXME: Implement this a little better (seperate select/insert)?

Parameters

string	$destTable
array \| string	$srcTable
array	$varMap
array	$conds
string	$fname
array	$insertOptions
array	$selectOptions

Returns: bool

Implements IDatabase.

Definition at line 885 of file DatabasePostgres.php.

DatabasePostgres::lastErrno ( )

Get the last error number.

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

Returns: int

Implements IDatabase.

Definition at line 560 of file DatabasePostgres.php.

DatabasePostgres::lastError ( )

Get a description of the last error.

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

Returns: string

Implements IDatabase.

Definition at line 548 of file DatabasePostgres.php.

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

Definition at line 1012 of file DatabasePostgres.php.

DatabasePostgres::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

Returns: array

Implements IDatabase.

Definition at line 1028 of file DatabasePostgres.php.

DatabasePostgres::lock	(	$lockName,
		$method,
		$timeout = `5`
	)

See http://www.postgresql.org/docs/8.2/static/functions-admin.html#FUNCTIONS-ADVISORY-LOCKS.

Parameters

string	$lockName
string	$method
int	$timeout

Returns: bool

Implements IDatabase.

Definition at line 1553 of file DatabasePostgres.php.

DatabasePostgres::lockIsFree	(	$lockName,
		$method
	)

Check to see if a named lock is available.

This is non-blocking. See http://www.postgresql.org/docs/8.2/static/functions-admin.html#FUNCTIONS-ADVISORY-LOCKS

Parameters

string	$lockName	Name of lock to poll
string	$method	Name of method calling us

Returns: bool

Since: 1.20

Implements IDatabase.

Definition at line 1537 of file DatabasePostgres.php.

DatabasePostgres::makeConnectionString ( $vars )

Definition at line 354 of file DatabasePostgres.php.

DatabasePostgres::makeSelectOptions ( $options )

Various select options.

Parameters

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

Returns: array

Definition at line 1456 of file DatabasePostgres.php.

DatabasePostgres::nextSequenceValue ( $seqName )

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

Parameters

string $seqName

Returns: int|null

Implements IDatabase.

Definition at line 970 of file DatabasePostgres.php.

References $name, and realTableName().

DatabasePostgres::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 IDatabase.

Definition at line 509 of file DatabasePostgres.php.

DatabasePostgres::numRows ( $res )

Get the number of rows in a result object.

Parameters

mixed $res A SQL result

Returns: int

Implements IDatabase.

Definition at line 492 of file DatabasePostgres.php.

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

Usually aborts on failure.

Parameters

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

Exceptions

DBConnectionError|Exception

Returns: DatabaseBase|null

Implements IDatabase.

Definition at line 259 of file DatabasePostgres.php.

Referenced by closeConnection().

DatabasePostgres::pg_array_parse	(		$text,
		&	$output,
			$limit = `false`,
			$offset = `1`
	)

Posted by cc[plus]php[at]c2se[dot]com on 25-Mar-2009 09:12 to http://www.php.net/manual/en/ref.pgsql.php.

Parsing a postgres array can be a tricky problem, he's my take on this, it handles multi-dimensional arrays plus escaping using a nasty regexp to determine the limits of each data-item.

This should really be handled by PHP PostgreSQL module

Since: 1.19

Parameters

string	$text	Postgreql array returned in a text form like {a,b}
string	$output
int	$limit
int	$offset

Returns: string

Definition at line 1066 of file DatabasePostgres.php.

References TS_POSTGRES, and wfTimestamp().

DatabasePostgres::queryIgnore	(	$sql,
		$fname = `__METHOD__`
	)

Definition at line 429 of file DatabasePostgres.php.

DatabasePostgres::realTableName	(	$name,
		$format = `'quoted'`
	)

Definition at line 960 of file DatabasePostgres.php.

Referenced by nextSequenceValue().

DatabasePostgres::realTimestamps ( )

Definition at line 220 of file DatabasePostgres.php.

DatabasePostgres::relationExists	(	$table,
		$types,
		$schema = `false`
	)

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

Parameters

string	$table
array \| string	$types
bool \| string	$schema

Returns: bool

Definition at line 1254 of file DatabasePostgres.php.

DatabasePostgres::replaceVars ( $ins )

protected

Postgres specific version of replaceVars.

Calls the parent version in Database.php

Parameters

string $ins SQL string, read from a stream (usually tables.sql)

Returns: string SQL string

Definition at line 1434 of file DatabasePostgres.php.

DatabasePostgres::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

Implements IDatabase.

Definition at line 411 of file DatabasePostgres.php.

References as, and wfDebug().

DatabasePostgres::roleExists ( $roleName )

Returns true if a given role (i.e.

user) exists, false otherwise.

Parameters

string $roleName

Returns: bool

Definition at line 1357 of file DatabasePostgres.php.

DatabasePostgres::ruleExists	(	$table,
		$rule
	)

Definition at line 1312 of file DatabasePostgres.php.

DatabasePostgres::schemaExists ( $schema )

Query whether a given schema exists.

Returns true if it does, false if it doesn't.

Parameters

string $schema

Returns: bool

Definition at line 1345 of file DatabasePostgres.php.

References $res, addQuotes(), getCoreSchema(), and DatabaseBase\query().

DatabasePostgres::searchableIPs ( )

Definition at line 232 of file DatabasePostgres.php.

DatabasePostgres::selectDB ( $db )

Postgres doesn't support selectDB in the same way MySQL does.

So if the DB name doesn't match the open connection, open a new one

Parameters

string $db

Returns: bool

Implements IDatabase.

Definition at line 346 of file DatabasePostgres.php.

DatabasePostgres::selectSQLText	(	$table,
		$vars,
		$conds = `''`,
		$fname = `__METHOD__`,
		$options = `[]`,
		$join_conds = `[]`
	)

Change the FOR UPDATE option as necessary based on the join conditions.

Then pass to the parent function to get the actual SQL text.

In Postgres when using FOR UPDATE, only the main table and tables that are inner joined can be locked. That means tables in an outer join cannot be FOR UPDATE locked. Trying to do so causes a DB error. This wrapper checks which tables can be locked and adjusts it accordingly.

MySQL uses "ORDER BY NULL" as an optimization hint, but that syntax is illegal in PostgreSQL.

See also: DatabaseBase::selectSQLText

Implements IDatabase.

Definition at line 724 of file DatabasePostgres.php.

DatabasePostgres::sequenceExists	(	$sequence,
		$schema = `false`
	)

Definition at line 1285 of file DatabasePostgres.php.

DatabasePostgres::setSearchPath ( $search_path )

Update search_path, values should already be sanitized Values may contain magic keywords like "$user".

Since: 1.19

Parameters

array $search_path List of schemas to be searched by default

Definition at line 1169 of file DatabasePostgres.php.

DatabasePostgres::streamStatementEnd	(	&	$sql,
		&	$newLine
	)

Definition at line 1515 of file DatabasePostgres.php.

DatabasePostgres::strencode ( $s )

Definition at line 1400 of file DatabasePostgres.php.

DatabasePostgres::strictIPs ( )

Definition at line 216 of file DatabasePostgres.php.

DatabasePostgres::tableExists	(	$table,
		$fname = `__METHOD__`,
		$schema = `false`
	)

For backward compatibility, this function checks both tables and views.

Parameters

string	$table
string	$fname
bool \| string	$schema

Returns: bool

Definition at line 1281 of file DatabasePostgres.php.

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

Definition at line 947 of file DatabasePostgres.php.

Referenced by wasDeadlock().

DatabasePostgres::textFieldSize	(	$table,
		$field
	)

Definition at line 995 of file DatabasePostgres.php.

DatabasePostgres::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

Implements IDatabase.

Definition at line 1044 of file DatabasePostgres.php.

DatabasePostgres::triggerExists	(	$table,
		$trigger
	)

Definition at line 1289 of file DatabasePostgres.php.

DatabasePostgres::unlock	(	$lockName,
		$method
	)

See http://www.postgresql.org/docs/8.2/static/functions-admin.html#FUNCTIONS-ADVISORY-LOCKSFROM PG DOCS: http://www.postgresql.org/docs/8.2/static/functions-admin.html#FUNCTIONS-ADVISORY-LOCKS.

Parameters

string	$lockName
string	$method

Returns: bool

Implements IDatabase.

Definition at line 1579 of file DatabasePostgres.php.

DatabasePostgres::wasDeadlock ( )

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

Returns: bool

Implements IDatabase.

Definition at line 1016 of file DatabasePostgres.php.

References tableName().

Member Data Documentation

string DatabasePostgres::$connectString

private

Connect string to open a PostgreSQL connection.

Definition at line 199 of file DatabasePostgres.php.

int DatabasePostgres::$mAffectedRows = null

protected

The number of rows affected as an integer.

Definition at line 190 of file DatabasePostgres.php.

string DatabasePostgres::$mCoreSchema

private

Definition at line 202 of file DatabasePostgres.php.

int DatabasePostgres::$mInsertId = null

private

Definition at line 193 of file DatabasePostgres.php.

resource DatabasePostgres::$mLastResult = null

protected

Definition at line 187 of file DatabasePostgres.php.

float string DatabasePostgres::$numericVersion = null

private

Definition at line 196 of file DatabasePostgres.php.

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

includes/db/DatabasePostgres.php

Public Member Functions

Protected Member Functions

Protected Attributes

Private Member Functions

Private Attributes

Additional Inherited Members

Detailed Description

Member Function Documentation

Member Data Documentation