268 public function open( $server, $user, $password, $dbName );
433 public function query( $sql,
$fname = __METHOD__, $tempIgnore =
false );
873 public function bitAnd( $fieldLeft, $fieldRight );
880 public function bitOr( $fieldLeft, $fieldRight );
907 $delim, $table, $field, $conds =
'', $join_conds = []
1065 public function deleteJoin( $delTable, $joinTable, $delVar, $joinVar, $conds,
1079 public function delete( $table, $conds,
$fname = __METHOD__ );
1109 $insertOptions = [], $selectOptions = []
1511 public function lock( $lockName, $method, $timeout = 5 );
1525 public function unlock( $lockName, $method );
const TS_MW
MediaWiki concatenated string timestamp (YYYYMMDDHHMMSS)
if(!defined( 'MEDIAWIKI')) $fname
This file is not a valid entry point, perform no further processing unless MEDIAWIKI is defined.
the array() calling protocol came about after MediaWiki 1.4rc1.
static configuration should be added through ResourceLoaderGetConfigVars instead & $vars
this hook is for auditing only RecentChangesLinked and Watchlist RecentChangesLinked and Watchlist e g Watchlist & $tables
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
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
An object representing a master or slave position in a replicated setup.
Basic database interface for live and lazy-loaded DB handles.
timestamp( $ts=0)
Convert a timestamp in one of the formats accepted by wfTimestamp() to the format used for inserting ...
fetchObject( $res)
Fetch the next row from the given result object, in object form.
getLBInfo( $name=null)
Get properties passed down from the server info array of the load balancer.
decodeBlob( $b)
Some DBMSs return a special placeholder object representing blob fields in result objects.
makeList( $a, $mode=LIST_COMMA)
Makes an encoded list of strings from an array.
reportQueryError( $error, $errno, $sql, $fname, $tempIgnore=false)
Report a query error.
upsert( $table, array $rows, array $uniqueIndexes, array $set, $fname=__METHOD__)
INSERT ON DUPLICATE KEY UPDATE wrapper, upserts an array into a table.
insertSelect( $destTable, $srcTable, $varMap, $conds, $fname=__METHOD__, $insertOptions=[], $selectOptions=[])
INSERT SELECT wrapper.
lastErrno()
Get the last error number.
buildConcat( $stringList)
Build a concatenation list to feed into a SQL query.
maxListLen()
Return the maximum number of items allowed in a list, or 0 for unlimited.
dataSeek( $res, $row)
Change the position of the cursor in a result object.
getServerInfo()
A string describing the current software version, and possibly other details in a user-friendly way.
freeResult( $res)
Free a result object returned by query() or select().
decodeExpiry( $expiry, $format=TS_MW)
Decode an expiry time into a DBMS independent format.
close()
Closes a database connection.
timestampOrNull( $ts=null)
Convert a timestamp in one of the formats accepted by wfTimestamp() to the format used for inserting ...
addQuotes( $s)
Adds quotes and backslashes.
doAtomicSection( $fname, $callback)
Run a callback to do an atomic set of updates for this database.
wasErrorReissuable()
Determines if the last query error was something that should be dealt with by pinging the connection ...
unionQueries( $sqls, $all)
Construct a UNION query This is used for providing overload point for other DB abstractions not compa...
pendingWriteQueryDuration()
Get the time spend running write queries for this transaction.
getDBname()
Get the current DB name.
getServerUptime()
Determines how long the server has been up STUB.
listTables( $prefix=null, $fname=__METHOD__)
List all tables on the database.
fieldName( $res, $n)
Get a field name in a result object.
wasDeadlock()
Determines if the last failure was due to a deadlock STUB.
insertId()
Get the inserted value of an auto-increment row.
selectSQLText( $table, $vars, $conds='', $fname=__METHOD__, $options=[], $join_conds=[])
The equivalent of IDatabase::select() except that the constructed SQL is returned,...
insert( $table, $a, $fname=__METHOD__, $options=[])
INSERT wrapper, inserts an array into a table.
selectRowCount( $tables, $vars=' *', $conds='', $fname=__METHOD__, $options=[], $join_conds=[])
Get the number of rows in dataset.
begin( $fname=__METHOD__)
Begin a transaction.
lockIsFree( $lockName, $method)
Check to see if a named lock is available (non-blocking)
setBigSelects( $value=true)
Allow or deny "big selects" for this session only.
doneWrites()
Returns true if the connection may have been used for write queries.
setFlag( $flag)
Set a flag for this connection.
bitAnd( $fieldLeft, $fieldRight)
deleteJoin( $delTable, $joinTable, $delVar, $joinVar, $conds, $fname=__METHOD__)
DELETE where the condition is a join.
makeWhereFrom2d( $data, $baseKey, $subKey)
Build a partial where clause from a 2-d array such as used for LinkBatch.
encodeExpiry( $expiry)
Encode an expiry time into the DBMS dependent format.
namedLocksEnqueue()
Check to see if a named lock used by lock() use blocking queues.
startAtomic( $fname=__METHOD__)
Begin an atomic section of statements.
open( $server, $user, $password, $dbName)
Open a connection to the database.
lastError()
Get a description of the last error.
numFields( $res)
Get the number of fields in a result object.
unlock( $lockName, $method)
Release a lock.
getSoftwareLink()
Returns a wikitext link to the DB's website, e.g., return "[http://www.mysql.com/ MySQL]"; Should at ...
reportConnectionError( $error='Unknown error')
lastQuery()
Return the last query that went through IDatabase::query()
pendingWriteCallers()
Get the list of method names that did write queries for this transaction.
bufferResults( $buffer=null)
Turns buffering of SQL result sets on (true) or off (false).
onTransactionPreCommitOrIdle( $callback)
Run an anonymous function before the current transaction commits or now if there is none.
getInfinity()
Find out when 'infinity' is.
dbSchema( $schema=null)
Get/set the db schema.
unionSupportsOrderAndLimit()
Returns true if current database backend supports ORDER BY or LIMIT for separate subqueries within th...
lock( $lockName, $method, $timeout=5)
Acquire a named lock.
writesOrCallbacksPending()
Returns true if there is a transaction open with possible write queries or transaction pre-commit/idl...
fieldInfo( $table, $field)
mysql_fetch_field() wrapper Returns false if the field doesn't exist
nextSequenceValue( $seqName)
Returns an appropriately quoted sequence value for inserting a new row.
getServer()
Get the server hostname or IP address.
wasReadOnlyError()
Determines if the last failure was due to the database being read-only.
buildGroupConcatField( $delim, $table, $field, $conds='', $join_conds=[])
Build a GROUP_CONCAT or equivalent statement for a query.
selectDB( $db)
Change the current database.
buildLike()
LIKE statement wrapper, receives a variable-length argument list with parts of pattern to match conta...
implicitOrderby()
Returns true if this database does an implicit order by when the column has an index For example: SEL...
strreplace( $orig, $old, $new)
Returns a comand for str_replace function in SQL query.
update( $table, $values, $conds, $fname=__METHOD__, $options=[])
UPDATE wrapper.
lastDoneWrites()
Returns the last time the connection may have been used for write queries.
trxTimestamp()
Get the UNIX timestamp of the time that the transaction was established.
estimateRowCount( $table, $vars=' *', $conds='', $fname=__METHOD__, $options=[])
Estimate the number of rows in dataset.
selectField( $table, $var, $cond='', $fname=__METHOD__, $options=[])
A SELECT wrapper which returns a single field from a single result row.
tablePrefix( $prefix=null)
Get/set the table prefix.
conditional( $cond, $trueVal, $falseVal)
Returns an SQL expression for a simple conditional.
anyString()
Returns a token for buildLike() that denotes a '' to be used in a LIKE query.
bitOr( $fieldLeft, $fieldRight)
getMasterPos()
Get the position of this master.
setSchemaVars( $vars)
Set variables to be used in sourceFile/sourceStream, in preference to the ones in $GLOBALS.
select( $table, $vars, $conds='', $fname=__METHOD__, $options=[], $join_conds=[])
Execute a SELECT query constructed using the various parameters provided.
wasLockTimeout()
Determines if the last failure was due to a lock timeout STUB.
fetchRow( $res)
Fetch the next row from the given result object, in associative array form.
setSessionOptions(array $options)
Override database's default behavior.
getFlag( $flag)
Returns a boolean whether the flag $flag is set for this connection.
ping()
Ping the server and try to reconnect if it there is no connection.
getSlavePos()
Get the replication position of this slave.
setLBInfo( $name, $value=null)
Set the LB info array, or a member of it.
selectFieldValues( $table, $var, $cond='', $fname=__METHOD__, $options=[])
A SELECT wrapper which returns a list of single field values from result rows.
getProperty( $name)
General read-only accessor.
clearFlag( $flag)
Clear a flag for this connection.
rollback( $fname=__METHOD__, $flush='')
Rollback a transaction previously started using begin().
onTransactionIdle( $callback)
Run an anonymous function as soon as there is no transaction pending.
endAtomic( $fname=__METHOD__)
Ends an atomic section of SQL statements.
replace( $table, $uniqueIndexes, $rows, $fname=__METHOD__)
REPLACE query wrapper.
encodeBlob( $b)
Some DBMSs have a special format for inserting into blob fields, they don't allow simple quoted strin...
selectRow( $table, $vars, $conds, $fname=__METHOD__, $options=[], $join_conds=[])
Single row SELECT wrapper.
indexExists( $table, $index, $fname=__METHOD__)
Determines whether an index exists Usually throws a DBQueryError on failure If errors are explicitly ...
affectedRows()
Get the number of rows affected by the last write query.
numRows( $res)
Get the number of rows in a result object.
getType()
Get the type of the DBMS, as it appears in $wgDBtype.
implicitGroupby()
Returns true if this database does an implicit sort when doing GROUP BY.
query( $sql, $fname=__METHOD__, $tempIgnore=false)
Run an SQL query and return the result.
indexUnique( $table, $index)
Determines if a given index is unique.
anyChar()
Returns a token for buildLike() that denotes a '_' to be used in a LIKE query.
commit( $fname=__METHOD__, $flush='')
Commits a transaction previously started using begin().
trxLevel()
Gets the current transaction level.
getSessionLagStatus()
Get the slave lag when the current transaction started or a general lag estimate if not transaction i...
tableExists( $table, $fname=__METHOD__)
Query whether a given table exists.
masterPosWait(DBMasterPos $pos, $timeout)
Wait for the slave to catch up to a given master position.
isOpen()
Is a connection to the database open?
fieldExists( $table, $field, $fname=__METHOD__)
Determines whether a field exists in a table.
getServerVersion()
A string describing the current software version, like from mysql_get_server_info().
getScopedLockAndFlush( $lockKey, $fname, $timeout)
Acquire a named lock, flush any transaction, and return an RAII style unlocker object.