Manual:$wgDBservers

Details
Database load balancer.

This is a two-dimensional array, an array of server info structures.

Fields are:
 * host: Host name (see ) . For MySQL, it can contain a port or socket path after a colon.
 * dbname: Default database name (see )
 * user: DB user (see )
 * password: DB password (see )
 * type: "mysql" or "pgsql" (see )
 * load: ratio of DB_REPLICA load, must be >=0, the sum of all loads must be >0
 * groupLoads: array of load ratios, the key is the query group name.  A query may belong to several groups, the most specific group defined here is used.
 * flags: bit field:
 * DBO_DEFAULT -- turns on DBO_TRX only if  != true (recommended)
 * DBO_DEBUG -- equivalent of 
 * DBO_TRX -- automatically start transactions (see )
 * DBO_IGNORE -- ignore errors (not useful in LocalSettings.php)
 * DBO_NOBUFFER -- turn off buffering (not useful in LocalSettings.php)
 * DBO_SSL -- use a secure connection
 * DBO_COMPRESS -- compress communication
 * DBO_PERSISTENT -- enable [<tvar|url>https://secure.php.net/features.persistent-connections</> persistent connections]

Leave at false to use the single-server variables listed above.

The master must be the first entry in the array.

Example:

This would configure one master and two replicas, each replica getting an equal amount of read access load.


 * max lag: (optional) Maximum replication lag before a replica will be taken out of rotation
 * max threads: (<tvar|removed></> optional) Maximum number of running threads

These and any other user-defined properties will be assigned to the mLBInfo member variable of the Database object.

MySQL specific options

 * lagDetectionMethod : Set to one of (Seconds_Behind_Master,pt-heartbeat). pt-heartbeat assumes the table is at heartbeat.heartbeat and uses UTC timestamps in the heartbeat.ts column. (https://www.percona.com/doc/percona-toolkit/2.2/pt-heartbeat.html)
 * lagDetectionOptions : If using pt-heartbeat, this can be set to an array map to change the default behavior. Normally, the heartbeat row with the server ID of this server's master will be used. Set the "conds" field to override the query conditions, e.g. ['shard' => 's1'].
 * useGTIDs : Use GTID methods like MASTER_GTID_WAIT when possible.
 * KeyPath : Path to the SSL key file.
 * CertPath : Path to the SSL certificate file.
 * CAFile: Path to a single certificate authority PEM file.
 * CAPath : Path to certificate authority PEM directory.
 * Ciphers : Array list of allowable ciphers.

MSSQL specific options

 * port : Port to connect to the server.
 * UseWindowsAuth : Use Integrated Windows Authentication for authentication to the database instead of username/password.

PostgreSQL specific options

 * port : Port to connect to the server.
 * keywordTableMap : Map of reserved table names to alternative table names to use

SQLite specific options

 * dbFilePath : Path to the database file.
 * dbDirectory : Path to the directory containing the database file. Only needed if dbFilePath is not specified, and requires dbname.
 * dbname : Name of the database (without the .sqlite extension). Only needed if dbFilePath is not specified, and requires dbDirectory.
 * trxMode : Transaction mode. One of DEFERRED, IMMEDIATE or EXCLUSIVE.

Early versions
Versions of MediaWiki prior to 1.4.0 used a single-dimensional array, listing the server names, e.g. array("larousse", "pliny"), which was used in conjunction with <tvar|DBloads></>.

From 1.4.0 onwards, $wgDBloads is deprecated and the above method must be used.

The groupLoads field was added in 1.4.3.

max lag and max threads (and the use of other user-defined properties) was added in 1.6.0

Warnings
If you switch to this, ensure you either keep $wgDBname set, or ensure <tvar|CookiePrefix></> and <tvar|CachePrefix></> are set explicitly.