DatabasePostgres Class Reference

Inheritance diagram for DatabasePostgres:

Collaboration diagram for DatabasePostgres:

List of all members.

Public Member Functions
	addQuotes ($s)
	affectedRows ()
	Get the number of rows affected by the last write query.
	aggregateValue ($valuedata, $valuename= 'value')
	Return aggregated value function call.
	buildConcat ($stringList)
	Build a concatenation list to feed into a SQL query.
	cascadingDeletes ()
	Returns true if this database supports (and uses) cascading deletes.
	cleanupTriggers ()
	Returns true if this database supports (and uses) triggers (e.g.
	constraintExists ($table, $constraint)
	currentSequenceValue ($seqName)
	Return the current value of a sequence.
	dataSeek ($res, $row)
	Change the position of the cursor in a result object.
	decodeBlob ($b)
	Some DBMSs return a special placeholder object representing blob fields in result objects.
	determineCoreSchema ($desired_schema)
	Determine default schema for MediaWiki core Adjust this session schema search path if desired schema exists and is not alread there.
	doQuery ($sql)
	The DBMS-dependent part of query()
	duplicateTableStructure ($oldName, $newName, $temporary=false, $fname= 'DatabasePostgres::duplicateTableStructure')
	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)
	estimateRowCount ($table, $vars= '*', $conds= '', $fname= 'DatabasePostgres::estimateRowCount', $options=array())
	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()
	fetchObject ($res)
	Fetch the next row from the given result object, in object form.
	fetchRow ($res)
	Fetch the next row from the given result object, in associative array form.
	fieldInfo ($table, $field)
	mysql_fetch_field() wrapper Returns false if the field doesn't exist
	fieldName ($res, $n)
	Get a field name in a result object.
	fieldType ($res, $index)
	pg_field_type() wrapper
	freeResult ($res)
	Free a result object returned by query() or select().
	functionalIndexes ()
	Returns true if this database can use functional indexes.
	getCoreSchema ()
	Return schema name fore core MediaWiki tables.
	getCurrentSchema ()
	Return current schema (executes SELECT current_schema()) Needs transaction.
	getDBname ()
	Get the current DB name.
	getSchemas ()
	Return list of schemas which are accessible without schema name This is list does not contain magic keywords like "$user" Needs transaction.
	getSearchEngine ()
	Get search engine class.
	getSearchPath ()
	Return search patch for schemas This is different from getSchemas() since it contain magic keywords (like "$user").
	getServer ()
	Get the server hostname or IP address.
	getServerVersion ()
	getType ()
	Get the type of the DBMS, as it appears in $wgDBtype.
	hasConstraint ($name)
	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.
	indexAttributes ($index, $schema=false)
	Returns is of attributes used in index.
	indexInfo ($table, $index, $fname= 'DatabasePostgres::indexInfo')
	Returns information about an index If errors are explicitly ignored, returns NULL on failure.
	indexUnique ($table, $index, $fname= 'DatabasePostgres::indexUnique')
	insert ($table, $args, $fname= 'DatabasePostgres::insert', $options=array())
	INSERT wrapper, inserts an array into a table.
	insertId ()
	This must be called after nextSequenceVal.
	insertSelect ($destTable, $srcTable, $varMap, $conds, $fname= 'DatabasePostgres::insertSelect', $insertOptions=array(), $selectOptions=array())
	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.
	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= 'DatabasePostgres::listTables')
	List all tables on the database.
	lock ($lockName, $method, $timeout=5)
	See http://www.postgresql.org/docs/8.2/static/functions-admin.html#FUNCTIONS-ADVISORY-LOCKS.
	lockIsFree ($lockName, $method)
	Check to see if a named lock is available.
	makeConnectionString ($vars)
	makeSelectOptions ($options)
	Various select options.
	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.
	pg_array_parse ($text, &$output, $limit=false, $offset=1)
	queryIgnore ($sql, $fname= 'DatabasePostgres::queryIgnore')
	realTableName ($name, $format= 'quoted')
	realTimestamps ()
	Returns true if this database uses timestamps rather than integers.
	relationExists ($table, $types, $schema=false)
	Query whether a given relation exists (in the given schema, or the default mw one if not given)
	reportQueryError ($error, $errno, $sql, $fname, $tempIgnore=false)
	Report a query error.
	roleExists ($roleName)
	Returns true if a given role (i.e.
	ruleExists ($table, $rule)
	schemaExists ($schema)
	Query whether a given schema exists.
	searchableIPs ()
	Returns true if this database can do a native search on IP columns e.g.
	selectDB ($db)
	Postgres doesn't support selectDB in the same way MySQL does.
	sequenceExists ($sequence, $schema=false)
	setFakeMaster ($enabled=true)
	Make this connection a fake master.
	setSearchPath ($search_path)
	Update search_path, values should already be sanitized Values may contain magic keywords like "$user".
	streamStatementEnd (&$sql, &$newLine)
	Called by sourceStream() to check if we've reached a statement end.
	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__, $schema=false)
	For backward compatibility, this function checks both tables and views.
	tableName ($name, $format= 'quoted')
	Format a table name ready for use in constructing an SQL query.
	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.
	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.
	wasDeadlock ()
	Determines if the last failure was due to a deadlock STUB.
Static Public Member Functions
static	getSoftwareLink ()
Public Attributes
	$mAffectedRows = null
	$mInsertId = null
	$mLastResult = null
	$numeric_version = null
Protected Member Functions
	closeConnection ()
	Closes a database connection, if it is open Returns success, true if already closed.
	dumpError ()
	replaceVars ($ins)
	Postgres specific version of replaceVars.
Private Member Functions
	bigintFromLockName ($lockName)

---

Detailed Description

Definition at line 286 of file DatabasePostgres.php.

---

Member Function Documentation

DatabasePostgres::addQuotes

(

$

s

)

Parameters:

$s	null|bool|Blob

Returns:

int|string

Reimplemented from DatabaseBase.

Definition at line 1333 of file DatabasePostgres.php.

References $s.

Referenced by constraintExists(), listTables(), lock(), lockIsFree(), relationExists(), triggerExists(), and unlock().

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

Definition at line 592 of file DatabasePostgres.php.

References empty.

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

Return aggregated value function call.

Reimplemented from DatabaseBase.

Definition at line 1052 of file DatabasePostgres.php.

DatabasePostgres::bigintFromLockName

(

$

lockName

)

[private]

Parameters:

string

$lockName

Returns:

string Integer

Definition at line 1497 of file DatabasePostgres.php.

References wfBaseConvert().

Referenced by lock(), lockIsFree(), and unlock().

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

Reimplemented from DatabaseBase.

Definition at line 1419 of file DatabasePostgres.php.

DatabasePostgres::cascadingDeletes

(

)

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

Returns:

bool

Reimplemented from DatabaseBase.

Definition at line 296 of file DatabasePostgres.php.

DatabasePostgres::cleanupTriggers

(

)

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

on the page table)

Returns:

bool

Reimplemented from DatabaseBase.

Definition at line 299 of file DatabasePostgres.php.

DatabasePostgres::closeConnection

(

)

[protected]

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

Returns:

bool

Reimplemented from DatabaseBase.

Definition at line 432 of file DatabasePostgres.php.

DatabasePostgres::constraintExists	(	$	table,
		$	constraint
	)

Definition at line 1260 of file DatabasePostgres.php.

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

DatabasePostgres::currentSequenceValue

(

$

seqName

)

Return the current value of a sequence.

Assumes it has been nextval'ed in this session.

Returns:

Definition at line 946 of file DatabasePostgres.php.

References $res, fetchRow(), and DatabaseBase\query().

DatabasePostgres::dataSeek	(	$	res,
		$	row
	)

Change the position of the cursor in a result object.

See also:

http://www.php.net/mysql_data_seek

Parameters:

$res	Mixed: A SQL result
$row	Mixed: Either MySQL row or ResultWrapper

Implements DatabaseType.

Definition at line 566 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:

$b

string

Returns:

string

Reimplemented from DatabaseBase.

Definition at line 1318 of file DatabasePostgres.php.

DatabasePostgres::determineCoreSchema

(

$

desired_schema

)

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:

$desired_schema

string

Definition at line 1134 of file DatabasePostgres.php.

References DatabaseBase\addIdentifierQuotes(), DatabaseBase\begin(), DatabaseBase\commit(), getCurrentSchema(), getSchemas(), getSearchPath(), schemaExists(), setSearchPath(), and wfDebug().

Referenced by open().

DatabasePostgres::doQuery

(

$

sql

)

The DBMS-dependent part of query()

Parameters:

$sql	String: SQL query.

Returns:

ResultWrapper Result object to feed to fetchObject, fetchRow, ...; or false on failure

Reimplemented from DatabaseBase.

Definition at line 436 of file DatabasePostgres.php.

Referenced by hasConstraint(), and open().

DatabasePostgres::dumpError

(

)

[protected]

Definition at line 453 of file DatabasePostgres.php.

References array(), as, and wfDebug().

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

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
	$temporary	Boolean: whether the new table should be temporary
string	$fname	calling function name

Exceptions:

MWException

Returns:

Boolean: true if operation was successful

Reimplemented from DatabaseBase.

Definition at line 979 of file DatabasePostgres.php.

References $fname, DatabaseBase\addIdentifierQuotes(), and DatabaseBase\query().

DatabasePostgres::encodeBlob

(

$

b

)

Parameters:

$b

Returns:

Blob

Reimplemented from DatabaseBase.

Definition at line 1314 of file DatabasePostgres.php.

DatabasePostgres::estimateRowCount	(	$	table,
		$	vars = '*',
		$	conds = '',
		$	fname = 'DatabasePostgres::estimateRowCount',
		$	options = array()
	)

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()

Returns:

int

Reimplemented from DatabaseBase.

Definition at line 611 of file DatabasePostgres.php.

References $count, $fname, $options, $res, $vars, array(), fetchRow(), and DatabaseBase\select().

DatabasePostgres::fetchObject

(

$

res

)

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

Fields can be retrieved with $row->fieldname, with fields acting like member variables. If no more rows are available, false is returned.

Parameters:

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

Returns:

object|bool

Exceptions:

DBUnexpectedError

Thrown if the database returns an error

Implements DatabaseType.

Definition at line 501 of file DatabasePostgres.php.

References $res, wfRestoreWarnings(), and wfSuppressWarnings().

Referenced by lock(), lockIsFree(), textFieldSize(), and unlock().

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:

$res	ResultWrapper 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 518 of file DatabasePostgres.php.

References $res, wfRestoreWarnings(), and wfSuppressWarnings().

Referenced by currentSequenceValue(), estimateRowCount(), getCurrentSchema(), getSchemas(), getSearchPath(), and nextSequenceValue().

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

Definition at line 1295 of file DatabasePostgres.php.

References PostgresField\fromText().

DatabasePostgres::fieldName	(	$	res,
		$	n
	)

Get a field name in a result object.

See also:

http://www.php.net/mysql_field_name

Parameters:

$res	Mixed: A SQL result
$n	Integer

Returns:

string

Implements DatabaseType.

Definition at line 551 of file DatabasePostgres.php.

References $n, and $res.

DatabasePostgres::fieldType	(	$	res,
		$	index
	)

pg_field_type() wrapper

Returns:

string

Reimplemented from DatabaseBase.

Definition at line 1303 of file DatabasePostgres.php.

References $res.

DatabasePostgres::freeResult

(

$

res

)

Free a result object returned by query() or select().

It's usually not necessary to call this, just use unset() or let the variable holding the result object go out of scope.

Parameters:

$res	Mixed: A SQL result

Reimplemented from DatabaseBase.

Definition at line 489 of file DatabasePostgres.php.

References $ok, $res, wfRestoreWarnings(), and wfSuppressWarnings().

DatabasePostgres::functionalIndexes

(

)

Returns true if this database can use functional indexes.

Returns:

bool

Reimplemented from DatabaseBase.

Definition at line 317 of file DatabasePostgres.php.

DatabasePostgres::getCoreSchema

(

)

Return schema name fore core MediaWiki tables.

Since:

1.19

Returns:

string core schema name

Definition at line 1167 of file DatabasePostgres.php.

Referenced by constraintExists(), hasConstraint(), indexAttributes(), listTables(), relationExists(), ruleExists(), and triggerExists().

DatabasePostgres::getCurrentSchema

(

)

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

Since:

1.19

Returns:

string return default schema for the current session

Definition at line 1070 of file DatabasePostgres.php.

References $res, fetchRow(), and DatabaseBase\query().

Referenced by determineCoreSchema().

DatabasePostgres::getDBname

(

)

Get the current DB name.

Reimplemented from DatabaseBase.

Definition at line 1411 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 1086 of file DatabasePostgres.php.

References $res, array(), fetchRow(), pg_array_parse(), and DatabaseBase\query().

Referenced by determineCoreSchema().

DatabasePostgres::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 1423 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 1103 of file DatabasePostgres.php.

References $res, fetchRow(), and DatabaseBase\query().

Referenced by determineCoreSchema().

DatabasePostgres::getServer

(

)

Get the server hostname or IP address.

Reimplemented from DatabaseBase.

Definition at line 1415 of file DatabasePostgres.php.

DatabasePostgres::getServerVersion

(

)

Returns:

string Version information from the database

Implements DatabaseType.

Definition at line 1174 of file DatabasePostgres.php.

Referenced by insert(), and open().

static DatabasePostgres::getSoftwareLink

(

)

[static]

Returns:

string wikitext of a link to the server software's web site

Implements DatabaseType.

Definition at line 1059 of file DatabasePostgres.php.

DatabasePostgres::getType

(

)

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

Returns:

string

Implements DatabaseType.

Definition at line 292 of file DatabasePostgres.php.

DatabasePostgres::hasConstraint

(

$

name

)

Definition at line 321 of file DatabasePostgres.php.

References $name, $res, doQuery(), getCoreSchema(), and numRows().

DatabasePostgres::implicitGroupby

(

)

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

Returns:

bool

Reimplemented from DatabaseBase.

Definition at line 308 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

Reimplemented from DatabaseBase.

Definition at line 311 of file DatabasePostgres.php.

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

Returns is of attributes used in index.

Since:

1.19

Returns:

Array

Definition at line 650 of file DatabasePostgres.php.

References $res, array(), as, getCoreSchema(), n, and DatabaseBase\query().

DatabasePostgres::indexInfo	(	$	table,
		$	index,
		$	fname = 'DatabasePostgres::indexInfo'
	)

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

Returns:

bool|null

Implements DatabaseType.

Definition at line 630 of file DatabasePostgres.php.

References $fname, $res, as, and DatabaseBase\query().

DatabasePostgres::indexUnique	(	$	table,
		$	index,
		$	fname = 'DatabasePostgres::indexUnique'
	)

Definition at line 705 of file DatabasePostgres.php.

References $fname, $res, as, DatabaseBase\indexName(), DatabaseBase\query(), and strencode().

DatabasePostgres::insert	(	$	table,
		$	args,
		$	fname = 'DatabasePostgres::insert',
		$	options = array()
	)

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:

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

Returns:

bool Success of insert operation. IGNORE always returns true.

Reimplemented from DatabaseBase.

Definition at line 733 of file DatabasePostgres.php.

References $fname, $keys, $options, $res, array(), as, getServerVersion(), DatabaseBase\makeList(), DatabaseBase\query(), and tableName().

DatabasePostgres::insertId

(

)

This must be called after nextSequenceVal.

Returns:

null

Implements DatabaseType.

Definition at line 562 of file DatabasePostgres.php.

DatabasePostgres::insertSelect	(	$	destTable,
		$	srcTable,
		$	varMap,
		$	conds,
		$	fname = 'DatabasePostgres::insertSelect',
		$	insertOptions = array(),
		$	selectOptions = array()
	)

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)?

Returns:

bool

Reimplemented from DatabaseBase.

Definition at line 850 of file DatabasePostgres.php.

References $fname, $res, array(), list, DatabaseBase\makeList(), makeSelectOptions(), DatabaseBase\query(), and tableName().

DatabasePostgres::lastErrno

(

)

Get the last error number.

See also:

http://www.php.net/mysql_errno

Returns:

int

Implements DatabaseType.

Definition at line 584 of file DatabasePostgres.php.

Referenced by wasDeadlock().

DatabasePostgres::lastError

(

)

Get a description of the last error.

See also:

http://www.php.net/mysql_error

Returns:

string

Implements DatabaseType.

Definition at line 573 of file DatabasePostgres.php.

Referenced by open().

DatabasePostgres::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
	$limit	Integer the SQL limit
	$offset	Integer|bool the SQL offset (default false)

Exceptions:

DBUnexpectedError

Returns:

string

Reimplemented from DatabaseBase.

Definition at line 971 of file DatabasePostgres.php.

DatabasePostgres::listTables	(	$	prefix = null,
		$	fname = 'DatabasePostgres::listTables'
	)

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 985 of file DatabasePostgres.php.

References $fname, $result, $vars, addQuotes(), array(), as, getCoreSchema(), and DatabaseBase\query().

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

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

Parameters:

$lockName	string
$method	string
$timeout	int

Returns:

bool

Reimplemented from DatabaseBase.

Definition at line 1464 of file DatabasePostgres.php.

References $result, addQuotes(), bigintFromLockName(), fetchObject(), DatabaseBase\query(), and wfDebug().

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:

Boolean

Since:

1.20

Reimplemented from DatabaseBase.

Definition at line 1449 of file DatabasePostgres.php.

References $result, addQuotes(), bigintFromLockName(), fetchObject(), and DatabaseBase\query().

DatabasePostgres::makeConnectionString

(

$

vars

)

Definition at line 419 of file DatabasePostgres.php.

References $name, $s, $value, $vars, and as.

Referenced by open().

DatabasePostgres::makeSelectOptions

(

$

options

)

Various select options.

Access:

private

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 1378 of file DatabasePostgres.php.

References $options, array(), as, DatabaseBase\makeGroupByWithHaving(), and DatabaseBase\makeOrderBy().

Referenced by insertSelect().

DatabasePostgres::nextSequenceValue

(

$

seqName

)

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

Returns:

null

Reimplemented from DatabaseBase.

Definition at line 934 of file DatabasePostgres.php.

References $res, fetchRow(), and DatabaseBase\query().

DatabasePostgres::numFields

(

$

res

)

Get the number of fields in a result object.

See also:

http://www.php.net/mysql_num_fields

Parameters:

$res	Mixed: A SQL result

Returns:

int

Implements DatabaseType.

Definition at line 544 of file DatabasePostgres.php.

References $res.

DatabasePostgres::numRows

(

$

res

)

Get the number of rows in a result object.

Parameters:

$res	Mixed: A SQL result

Returns:

int

Implements DatabaseType.

Definition at line 531 of file DatabasePostgres.php.

References $n, $res, wfRestoreWarnings(), and wfSuppressWarnings().

Referenced by hasConstraint().

DatabasePostgres::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 337 of file DatabasePostgres.php.

References $password, $user, $wgCommandLineMode, array(), DatabaseBase\close(), determineCoreSchema(), doQuery(), e, getServerVersion(), global, DatabaseBase\installErrorHandler(), is, lastError(), makeConnectionString(), DatabaseBase\query(), DatabaseBase\restoreErrorHandler(), and wfDebug().

Referenced by selectDB().

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

Definition at line 1023 of file DatabasePostgres.php.

References $limit, $output, and array().

Referenced by getSchemas().

DatabasePostgres::queryIgnore	(	$	sql,
		$	fname = 'DatabasePostgres::queryIgnore'
	)

Definition at line 485 of file DatabasePostgres.php.

References $fname, and DatabaseBase\query().

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

Definition at line 926 of file DatabasePostgres.php.

References $name, and tableName().

Referenced by relationExists(), and tableName().

DatabasePostgres::realTimestamps

(

)

Returns true if this database uses timestamps rather than integers.

Returns:

bool

Reimplemented from DatabaseBase.

Definition at line 305 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)

Returns:

bool

Definition at line 1196 of file DatabasePostgres.php.

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

Referenced by sequenceExists(), and tableExists().

DatabasePostgres::replaceVars

(

$

ins

)

[protected]

Postgres specific version of replaceVars.

Calls the parent version in Database.php

Access:

private

Parameters:

string

$ins

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

Returns:

string SQL string

Reimplemented from DatabaseBase.

Definition at line 1354 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:

$error	String
$errno	Integer
$sql	String
$fname	String
$tempIgnore	Boolean

Exceptions:

DBQueryError

Reimplemented from DatabaseBase.

Definition at line 471 of file DatabasePostgres.php.

References $error, $fname, and DatabaseBase\rollback().

DatabasePostgres::roleExists

(

$

roleName

)

Returns true if a given role (i.e.

user) exists, false otherwise.

Returns:

bool

Definition at line 1289 of file DatabasePostgres.php.

References array(), and DatabaseBase\selectField().

DatabasePostgres::ruleExists	(	$	table,
		$	rule
	)

Definition at line 1249 of file DatabasePostgres.php.

References array(), getCoreSchema(), and DatabaseBase\selectField().

DatabasePostgres::schemaExists

(

$

schema

)

Query whether a given schema exists.

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

Returns:

bool

Definition at line 1279 of file DatabasePostgres.php.

References array(), and DatabaseBase\selectField().

Referenced by determineCoreSchema().

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

Returns:

Reimplemented from DatabaseBase.

Definition at line 411 of file DatabasePostgres.php.

References open().

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

Definition at line 1223 of file DatabasePostgres.php.

References relationExists().

DatabasePostgres::setFakeMaster

(

$

enabled = true

)

Make this connection a fake master.

Parameters:

$enabled

bool

Reimplemented from DatabaseBase.

Definition at line 1409 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:

$search_path

array list of schemas to be searched by default

Definition at line 1117 of file DatabasePostgres.php.

References DatabaseBase\query().

Referenced by determineCoreSchema().

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

Called by sourceStream() to check if we've reached a statement end.

Parameters:

string	$sql	SQL assembled so far
string	$newLine	New line about to be added to $sql

Returns:

Bool Whether $newLine contains end of the statement

Reimplemented from DatabaseBase.

Definition at line 1427 of file DatabasePostgres.php.

DatabasePostgres::strencode

(

$

s

)

Wrapper for addslashes()

Parameters:

string

$s

to be slashed.

Returns:

string: slashed string.

Implements DatabaseType.

Definition at line 1325 of file DatabasePostgres.php.

References $s.

Referenced by indexUnique().

DatabasePostgres::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 302 of file DatabasePostgres.php.

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

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

Returns:

bool

Definition at line 1219 of file DatabasePostgres.php.

References array(), and relationExists().

DatabasePostgres::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 913 of file DatabasePostgres.php.

References $name, and realTableName().

Referenced by insert(), insertSelect(), realTableName(), and textFieldSize().

DatabasePostgres::textFieldSize	(	$	table,
		$	field
	)

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

Parameters:

$table	string
$field	string

Returns:

int

Reimplemented from DatabaseBase.

Definition at line 955 of file DatabasePostgres.php.

References $res, $size, fetchObject(), DatabaseBase\query(), and tableName().

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:

$ts	string|int

Returns:

string

Reimplemented from DatabaseBase.

Definition at line 1001 of file DatabasePostgres.php.

References wfTimestamp().

DatabasePostgres::triggerExists	(	$	table,
		$	trigger
	)

Definition at line 1227 of file DatabasePostgres.php.

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

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:

$lockName	string
$method	string

Returns:

bool

Reimplemented from DatabaseBase.

Definition at line 1486 of file DatabasePostgres.php.

References $result, addQuotes(), bigintFromLockName(), fetchObject(), and DatabaseBase\query().

DatabasePostgres::wasDeadlock

(

)

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

Returns:

bool

Reimplemented from DatabaseBase.

Definition at line 975 of file DatabasePostgres.php.

References lastErrno().

---

Member Data Documentation

DatabasePostgres::$mAffectedRows = null

Definition at line 290 of file DatabasePostgres.php.

DatabasePostgres::$mInsertId = null

Definition at line 287 of file DatabasePostgres.php.

DatabasePostgres::$mLastResult = null

Definition at line 288 of file DatabasePostgres.php.

DatabasePostgres::$numeric_version = null

Definition at line 289 of file DatabasePostgres.php.

---

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

• includes/db/DatabasePostgres.php