29 $this->params =
$conn;
34 if ( $this->conn === null ) {
36 $this->conn = $this->lb->getConnection( $db, $groups, $wiki );
39 return call_user_func_array( [ $this->conn,
$name ], $arguments );
43 return $this->
__call( __FUNCTION__, func_get_args() );
47 return $this->
__call( __FUNCTION__, func_get_args() );
51 return $this->
__call( __FUNCTION__, func_get_args() );
55 return $this->
__call( __FUNCTION__, func_get_args() );
59 return $this->
__call( __FUNCTION__, func_get_args() );
63 return $this->
__call( __FUNCTION__, func_get_args() );
67 return $this->
__call( __FUNCTION__, func_get_args() );
71 return $this->
__call( __FUNCTION__, func_get_args() );
75 return $this->
__call( __FUNCTION__, func_get_args() );
79 return $this->
__call( __FUNCTION__, func_get_args() );
83 return $this->
__call( __FUNCTION__, func_get_args() );
87 return $this->
__call( __FUNCTION__, func_get_args() );
91 return $this->
__call( __FUNCTION__, func_get_args() );
95 return $this->
__call( __FUNCTION__, func_get_args() );
99 return $this->
__call( __FUNCTION__, func_get_args() );
103 return $this->
__call( __FUNCTION__, func_get_args() );
107 return $this->
__call( __FUNCTION__, func_get_args() );
111 return $this->
__call( __FUNCTION__, func_get_args() );
115 return $this->
__call( __FUNCTION__, func_get_args() );
119 return $this->
__call( __FUNCTION__, func_get_args() );
123 return $this->
__call( __FUNCTION__, func_get_args() );
127 return $this->
__call( __FUNCTION__, func_get_args() );
131 return $this->
__call( __FUNCTION__, func_get_args() );
135 return $this->
__call( __FUNCTION__, func_get_args() );
138 public function open( $server,
$user, $password, $dbName ) {
139 return $this->
__call( __FUNCTION__, func_get_args() );
143 return $this->
__call( __FUNCTION__, func_get_args() );
147 return $this->
__call( __FUNCTION__, func_get_args() );
151 return $this->
__call( __FUNCTION__, func_get_args() );
155 return $this->
__call( __FUNCTION__, func_get_args() );
159 return $this->
__call( __FUNCTION__, func_get_args() );
163 return $this->
__call( __FUNCTION__, func_get_args() );
167 return $this->
__call( __FUNCTION__, func_get_args() );
171 return $this->
__call( __FUNCTION__, func_get_args() );
175 return $this->
__call( __FUNCTION__, func_get_args() );
179 return $this->
__call( __FUNCTION__, func_get_args() );
183 return $this->
__call( __FUNCTION__, func_get_args() );
187 return $this->
__call( __FUNCTION__, func_get_args() );
191 return $this->
__call( __FUNCTION__, func_get_args() );
195 return $this->
__call( __FUNCTION__, func_get_args() );
199 return $this->
__call( __FUNCTION__, func_get_args() );
202 public function query( $sql,
$fname = __METHOD__, $tempIgnore =
false ) {
203 return $this->
__call( __FUNCTION__, func_get_args() );
207 return $this->
__call( __FUNCTION__, func_get_args() );
211 return $this->
__call( __FUNCTION__, func_get_args() );
217 return $this->
__call( __FUNCTION__, func_get_args() );
223 return $this->
__call( __FUNCTION__, func_get_args() );
230 return $this->
__call( __FUNCTION__, func_get_args() );
237 return $this->
__call( __FUNCTION__, func_get_args() );
244 return $this->
__call( __FUNCTION__, func_get_args() );
250 return $this->
__call( __FUNCTION__, func_get_args() );
256 return $this->
__call( __FUNCTION__, func_get_args() );
260 return $this->
__call( __FUNCTION__, func_get_args() );
264 return $this->
__call( __FUNCTION__, func_get_args() );
268 return $this->
__call( __FUNCTION__, func_get_args() );
272 return $this->
__call( __FUNCTION__, func_get_args() );
276 return $this->
__call( __FUNCTION__, func_get_args() );
280 return $this->
__call( __FUNCTION__, func_get_args() );
284 return $this->
__call( __FUNCTION__, func_get_args() );
288 return $this->
__call( __FUNCTION__, func_get_args() );
292 return $this->
__call( __FUNCTION__, func_get_args() );
295 public function bitAnd( $fieldLeft, $fieldRight ) {
296 return $this->
__call( __FUNCTION__, func_get_args() );
299 public function bitOr( $fieldLeft, $fieldRight ) {
300 return $this->
__call( __FUNCTION__, func_get_args() );
304 return $this->
__call( __FUNCTION__, func_get_args() );
308 $delim, $table, $field, $conds =
'', $join_conds = []
310 return $this->
__call( __FUNCTION__, func_get_args() );
314 return $this->
__call( __FUNCTION__, func_get_args() );
318 return $this->
__call( __FUNCTION__, func_get_args() );
322 return $this->
__call( __FUNCTION__, func_get_args() );
326 return $this->
__call( __FUNCTION__, func_get_args() );
330 return $this->
__call( __FUNCTION__, func_get_args() );
334 return $this->
__call( __FUNCTION__, func_get_args() );
338 return $this->
__call( __FUNCTION__, func_get_args() );
342 return $this->
__call( __FUNCTION__, func_get_args() );
345 public function replace( $table, $uniqueIndexes, $rows,
$fname = __METHOD__ ) {
346 return $this->
__call( __FUNCTION__, func_get_args() );
352 return $this->
__call( __FUNCTION__, func_get_args() );
356 $delTable, $joinTable, $delVar, $joinVar, $conds,
$fname = __METHOD__
358 return $this->
__call( __FUNCTION__, func_get_args() );
361 public function delete( $table, $conds,
$fname = __METHOD__ ) {
362 return $this->
__call( __FUNCTION__, func_get_args() );
366 $destTable, $srcTable, $varMap, $conds,
367 $fname = __METHOD__, $insertOptions = [], $selectOptions = []
369 return $this->
__call( __FUNCTION__, func_get_args() );
373 return $this->
__call( __FUNCTION__, func_get_args() );
377 return $this->
__call( __FUNCTION__, func_get_args() );
381 return $this->
__call( __FUNCTION__, func_get_args() );
385 return $this->
__call( __FUNCTION__, func_get_args() );
389 return $this->
__call( __FUNCTION__, func_get_args() );
393 return $this->
__call( __FUNCTION__, func_get_args() );
397 return $this->
__call( __FUNCTION__, func_get_args() );
401 return $this->
__call( __FUNCTION__, func_get_args() );
405 return $this->
__call( __FUNCTION__, func_get_args() );
409 return $this->
__call( __FUNCTION__, func_get_args() );
413 return $this->
__call( __FUNCTION__, func_get_args() );
417 return $this->
__call( __FUNCTION__, func_get_args() );
421 return $this->
__call( __FUNCTION__, func_get_args() );
425 return $this->
__call( __FUNCTION__, func_get_args() );
429 return $this->
__call( __FUNCTION__, func_get_args() );
433 return $this->
__call( __FUNCTION__, func_get_args() );
437 return $this->
__call( __FUNCTION__, func_get_args() );
441 return $this->
__call( __FUNCTION__, func_get_args() );
445 return $this->
__call( __FUNCTION__, func_get_args() );
449 return $this->
__call( __FUNCTION__, func_get_args() );
453 return $this->
__call( __FUNCTION__, func_get_args() );
457 return $this->
__call( __FUNCTION__, func_get_args() );
461 return $this->
__call( __FUNCTION__, func_get_args() );
465 return $this->
__call( __FUNCTION__, func_get_args() );
469 return $this->
__call( __FUNCTION__, func_get_args() );
473 return $this->
__call( __FUNCTION__, func_get_args() );
477 return $this->
__call( __FUNCTION__, func_get_args() );
481 return $this->
__call( __FUNCTION__, func_get_args() );
485 return $this->
__call( __FUNCTION__, func_get_args() );
489 return $this->
__call( __FUNCTION__, func_get_args() );
493 return $this->
__call( __FUNCTION__, func_get_args() );
497 return $this->
__call( __FUNCTION__, func_get_args() );
501 return $this->
__call( __FUNCTION__, func_get_args() );
505 return $this->
__call( __FUNCTION__, func_get_args() );
508 public function lock( $lockName, $method, $timeout = 5 ) {
509 return $this->
__call( __FUNCTION__, func_get_args() );
512 public function unlock( $lockName, $method ) {
513 return $this->
__call( __FUNCTION__, func_get_args() );
517 return $this->
__call( __FUNCTION__, func_get_args() );
521 return $this->
__call( __FUNCTION__, func_get_args() );
525 return $this->
__call( __FUNCTION__, func_get_args() );
529 return $this->
__call( __FUNCTION__, func_get_args() );
533 return $this->
__call( __FUNCTION__, func_get_args() );
537 return $this->
__call( __FUNCTION__, func_get_args() );
541 return $this->
__call( __FUNCTION__, func_get_args() );
548 if ( $this->conn !== null ) {
549 $this->lb->reuseConnection( $this->conn );
namedLocksEnqueue()
Check to see if a named lock used by lock() use blocking queues.
anyString()
Returns a token for buildLike() that denotes a '' to be used in a LIKE query.
unionQueries($sqls, $all)
Construct a UNION query This is used for providing overload point for other DB abstractions not compa...
startAtomic($fname=__METHOD__)
Begin an atomic section of statements.
deferred txt A few of the database updates required by various functions here can be deferred until after the result page is displayed to the user For updating the view updating the linked to tables after a etc PHP does not yet have any way to tell the server to actually return and disconnect while still running these but it might have such a feature in the future We handle these by creating a deferred update object and putting those objects on a global list
close()
Closes a database connection.
wasErrorReissuable()
Determines if the last query error was something that should be dealt with by pinging the connection ...
wasReadOnlyError()
Determines if the last failure was due to the database being read-only.
the array() calling protocol came about after MediaWiki 1.4rc1.
buildGroupConcatField($delim, $table, $field, $conds= '', $join_conds=[])
Build a GROUP_CONCAT or equivalent statement for a query.
decodeExpiry($expiry, $format=TS_MW)
Decode an expiry time into a DBMS independent format.
buildLike()
LIKE statement wrapper, receives a variable-length argument list with parts of pattern to match conta...
indexUnique($table, $index)
Determines if a given index is unique.
setSessionOptions(array $options)
Override database's default behavior.
lockIsFree($lockName, $method)
Check to see if a named lock is available (non-blocking)
begin($fname=__METHOD__)
Begin a transaction.
__call($name, array $arguments)
getServerVersion()
A string describing the current software version, like from mysql_get_server_info().
getFlag($flag)
Returns a boolean whether the flag $flag is set for this connection.
deleteJoin($delTable, $joinTable, $delVar, $joinVar, $conds, $fname=__METHOD__)
DELETE where the condition is a join.
affectedRows()
Get the number of rows affected by the last write query.
select($table, $vars, $conds= '', $fname=__METHOD__, $options=[], $join_conds=[])
Execute a SELECT query constructed using the various parameters provided.
addQuotes($s)
Adds quotes and backslashes.
commit($fname=__METHOD__, $flush= '')
Commits a transaction previously started using begin().
masterPosWait(DBMasterPos $pos, $timeout)
Wait for the slave to catch up to a given master position.
makeList($a, $mode=LIST_COMMA)
Makes an encoded list of strings from an array.
writesOrCallbacksPending()
Returns true if there is a transaction open with possible write queries or transaction pre-commit/idl...
setLBInfo($name, $value=null)
Set the LB info array, or a member of it.
bitAnd($fieldLeft, $fieldRight)
setBigSelects($value=true)
Allow or deny "big selects" for this session only.
reportConnectionError($error= 'Unknown error')
An object representing a master or slave position in a replicated setup.
lastError()
Get a description of the last error.
tablePrefix($prefix=null)
Get/set the table prefix.
maxListLen()
Return the maximum number of items allowed in a list, or 0 for unlimited.
onTransactionPreCommitOrIdle(callable $callback)
Run a callback before the current transaction commits or now if there is none.
selectRowCount($tables, $vars= '*', $conds= '', $fname=__METHOD__, $options=[], $join_conds=[])
Get the number of rows in dataset.
this hook is for auditing only RecentChangesLinked and Watchlist RecentChangesLinked and Watchlist e g Watchlist & $tables
open($server, $user, $password, $dbName)
Open a connection to the database.
__construct(LoadBalancer $lb, $conn)
lastErrno()
Get the last error number.
fieldInfo($table, $field)
mysql_fetch_field() wrapper Returns false if the field doesn't exist
bitOr($fieldLeft, $fieldRight)
tableExists($table, $fname=__METHOD__)
Query whether a given table exists.
listTables($prefix=null, $fname=__METHOD__)
List all tables on the database.
Database load balancing object.
bufferResults($buffer=null)
Turns buffering of SQL result sets on (true) or off (false).
pendingWriteCallers()
Get the list of method names that did write queries for this transaction.
trxLevel()
Gets the current transaction level.
freeResult($res)
Free a result object returned by query() or select().
doneWrites()
Returns true if the connection may have been used for write queries.
setSchemaVars($vars)
Set variables to be used in sourceFile/sourceStream, in preference to the ones in $GLOBALS...
nextSequenceValue($seqName)
Returns an appropriately quoted sequence value for inserting a new row.
getServerUptime()
Determines how long the server has been up STUB.
pendingWriteQueryDuration()
Get the time spend running write queries for this transaction.
this hook is for auditing only RecentChangesLinked and Watchlist RecentChangesLinked and Watchlist e g Watchlist removed from all revisions and log entries to which it was applied This gives extensions a chance to take it off their books as the deletion has already been partly carried out by this point or something similar the user will be unable to create the tag set and then return false from the hook function Ensure you consume the ChangeTagAfterDelete hook to carry out custom deletion actions as context called by AbstractContent::getParserOutput May be used to override the normal model specific rendering of page content as context as context $options
fieldName($res, $n)
Get a field name in a result object.
timestamp($ts=0)
Convert a timestamp in one of the formats accepted by wfTimestamp() to the format used for inserting ...
doAtomicSection($fname, callable $callback)
Run a callback to do an atomic set of updates for this database.
endAtomic($fname=__METHOD__)
Ends an atomic section of SQL statements.
getLBInfo($name=null)
Get properties passed down from the server info array of the load balancer.
buildConcat($stringList)
Build a concatenation list to feed into a SQL query.
getServerInfo()
A string describing the current software version, and possibly other details in a user-friendly way...
encodeBlob($b)
Some DBMSs have a special format for inserting into blob fields, they don't allow simple quoted strin...
getMasterPos()
Get the position of this master.
makeWhereFrom2d($data, $baseKey, $subKey)
Build a partial where clause from a 2-d array such as used for LinkBatch.
unlock($lockName, $method)
Release a lock.
fetchObject($res)
Fetch the next row from the given result object, in object form.
query($sql, $fname=__METHOD__, $tempIgnore=false)
Run an SQL query and return the result.
getDBname()
Get the current DB name.
Helper class to handle automatically marking connections as reusable (via RAII pattern) as well handl...
upsert($table, array $rows, array $uniqueIndexes, array $set, $fname=__METHOD__)
INSERT ON DUPLICATE KEY UPDATE wrapper, upserts an array into a table.
getSoftwareLink()
Returns a wikitext link to the DB's website, e.g., return "[http://www.mysql.com/ MySQL]"; Should at ...
lock($lockName, $method, $timeout=5)
Acquire a named lock.
lastDoneWrites()
Returns the last time the connection may have been used for write queries.
onTransactionIdle(callable $callback)
Run a callback as soon as there is no transaction pending.
clearFlag($flag)
Clear a flag for this connection.
getInfinity()
Find out when 'infinity' is.
please add to it if you re going to add events to the MediaWiki code where normally authentication against an external auth plugin would be creating a local account $user
getSlavePos()
Get the replication position of this slave.
lastQuery()
Return the last query that went through IDatabase::query()
wasLockTimeout()
Determines if the last failure was due to a lock timeout STUB.
__destruct()
Clean up the connection when out of scope.
getServer()
Get the server hostname or IP address.
insertId()
Get the inserted value of an auto-increment row.
const TS_MW
MediaWiki concatenated string timestamp (YYYYMMDDHHMMSS)
Database abstraction object.
onTransactionResolution(callable $callback)
Run a callback as soon as the current transaction commits or rolls back.
dataSeek($res, $row)
Change the position of the cursor in a result object.
injection txt This is an overview of how MediaWiki makes use of dependency injection The design described here grew from the discussion of RFC T384 The term dependency this means that anything an object needs to operate should be injected from the the object itself should only know narrow no concrete implementation of the logic it relies on The requirement to inject everything typically results in an architecture that based on two main types of and essentially stateless service objects that use other service objects to operate on the value objects As of the beginning MediaWiki is only starting to use the DI approach Much of the code still relies on global state or direct resulting in a highly cyclical dependency which acts as the top level factory for services in MediaWiki which can be used to gain access to default instances of various services MediaWikiServices however also allows new services to be defined and default services to be redefined Services are defined or redefined by providing a callback the instantiator that will return a new instance of the service When it will create an instance of MediaWikiServices and populate it with the services defined in the files listed by thereby bootstrapping the DI framework Per $wgServiceWiringFiles lists includes ServiceWiring php
timestampOrNull($ts=null)
Convert a timestamp in one of the formats accepted by wfTimestamp() to the format used for inserting ...
insertSelect($destTable, $srcTable, $varMap, $conds, $fname=__METHOD__, $insertOptions=[], $selectOptions=[])
INSERT SELECT wrapper.
if(!defined( 'MEDIAWIKI')) $fname
This file is not a valid entry point, perform no further processing unless MEDIAWIKI is defined...
decodeBlob($b)
Some DBMSs return a special placeholder object representing blob fields in result objects...
selectFieldValues($table, $var, $cond= '', $fname=__METHOD__, $options=[])
A SELECT wrapper which returns a list of single field values from result rows.
getScopedLockAndFlush($lockKey, $fname, $timeout)
Acquire a named lock, flush any transaction, and return an RAII style unlocker object.
selectField($table, $var, $cond= '', $fname=__METHOD__, $options=[])
A SELECT wrapper which returns a single field from a single result row.
strreplace($orig, $old, $new)
Returns a comand for str_replace function in SQL query.
replace($table, $uniqueIndexes, $rows, $fname=__METHOD__)
REPLACE query wrapper.
getType()
Get the type of the DBMS, as it appears in $wgDBtype.
dbSchema($schema=null)
Get/set the db schema.
conditional($cond, $trueVal, $falseVal)
Returns an SQL expression for a simple conditional.
selectRow($table, $vars, $conds, $fname=__METHOD__, $options=[], $join_conds=[])
Single row SELECT wrapper.
fetchRow($res)
Fetch the next row from the given result object, in associative array form.
trxTimestamp()
Get the UNIX timestamp of the time that the transaction was established.
reportQueryError($error, $errno, $sql, $fname, $tempIgnore=false)
Report a query error.
unionSupportsOrderAndLimit()
Returns true if current database backend supports ORDER BY or LIMIT for separate subqueries within th...
fieldExists($table, $field, $fname=__METHOD__)
Determines whether a field exists in a table.
estimateRowCount($table, $vars= '*', $conds= '', $fname=__METHOD__, $options=[])
Estimate the number of rows in dataset.
insert($table, $a, $fname=__METHOD__, $options=[])
INSERT wrapper, inserts an array into a table.
setFlag($flag)
Set a flag for this connection.
numFields($res)
Get the number of fields in a result object.
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.
numRows($res)
Get the number of rows in a result object.
implicitGroupby()
Returns true if this database does an implicit sort when doing GROUP BY.
rollback($fname=__METHOD__, $flush= '')
Rollback a transaction previously started using begin().
ping()
Ping the server and try to reconnect if it there is no connection.
getProperty($name)
General read-only accessor.
getSessionLagStatus()
Get the slave lag when the current transaction started or a general lag estimate if not transaction i...
anyChar()
Returns a token for buildLike() that denotes a '_' to be used in a LIKE query.
indexExists($table, $index, $fname=__METHOD__)
Determines whether an index exists Usually throws a DBQueryError on failure If errors are explicitly ...
static configuration should be added through ResourceLoaderGetConfigVars instead & $vars
encodeExpiry($expiry)
Encode an expiry time into the DBMS dependent format.
selectDB($db)
Change the current database.
isOpen()
Is a connection to the database open?
Basic database interface for live and lazy-loaded DB handles.
wasDeadlock()
Determines if the last failure was due to a deadlock STUB.
implicitOrderby()
Returns true if this database does an implicit order by when the column has an index For example: SEL...
update($table, $values, $conds, $fname=__METHOD__, $options=[])
UPDATE wrapper.
Allows to change the fields on the form that will be generated $name