111 lines
3.9 KiB
PHP
111 lines
3.9 KiB
PHP
<?php
|
|
/**
|
|
* This program is free software; you can redistribute it and/or modify
|
|
* it under the terms of the GNU General Public License as published by
|
|
* the Free Software Foundation; either version 2 of the License, or
|
|
* (at your option) any later version.
|
|
*
|
|
* This program is distributed in the hope that it will be useful,
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
* GNU General Public License for more details.
|
|
*
|
|
* You should have received a copy of the GNU General Public License along
|
|
* with this program; if not, write to the Free Software Foundation, Inc.,
|
|
* 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
|
|
* http://www.gnu.org/copyleft/gpl.html
|
|
*
|
|
* @file
|
|
*/
|
|
namespace Wikimedia\Rdbms;
|
|
|
|
use RuntimeException;
|
|
|
|
/**
|
|
* Placeholder LoadBalancer that throws an error upon attempts to access connections
|
|
*
|
|
* This is useful when running code with no config file present, e.g. during installation.
|
|
*
|
|
* @since 1.40
|
|
* @ingroup Database
|
|
*/
|
|
class LoadBalancerDisabled extends LoadBalancer {
|
|
|
|
public function __construct( $params = [] ) {
|
|
parent::__construct( [
|
|
'servers' => [ [
|
|
'type' => 'disabled',
|
|
'host' => '(disabled)',
|
|
'dbname' => null,
|
|
'load' => 1,
|
|
] ],
|
|
'trxProfiler' => $params['trxProfiler'] ?? null,
|
|
'srvCache' => $params['srvCache'] ?? null,
|
|
'wanCache' => $params['wanCache'] ?? null,
|
|
'localDomain' => $params['localDomain'] ?? '(disabled)',
|
|
'readOnlyReason' => $params['readOnlyReason'] ?? false,
|
|
'clusterName' => $params['clusterName'] ?? null,
|
|
] );
|
|
}
|
|
|
|
/**
|
|
* @param int $i
|
|
* @param DatabaseDomain $domain
|
|
* @param array $lbInfo
|
|
*
|
|
* @return never
|
|
*/
|
|
protected function reallyOpenConnection( $i, DatabaseDomain $domain, array $lbInfo ) {
|
|
throw new RuntimeException( 'Database backend disabled' );
|
|
}
|
|
|
|
/**
|
|
* @param int $i Specific (overrides $groups) or virtual (DB_PRIMARY/DB_REPLICA) server index
|
|
* @param string[]|string $groups Query group(s) in preference order; [] for the default group
|
|
* @param string|false $domain DB domain ID or false for the local domain
|
|
* @param int $flags Bitfield of CONN_* class constants
|
|
*
|
|
* @return never
|
|
*/
|
|
public function getConnection( $i, $groups = [], $domain = false, $flags = 0 ) {
|
|
throw new RuntimeException( 'Database backend disabled' );
|
|
}
|
|
|
|
/**
|
|
* @internal Only to be used by DBConnRef
|
|
* @param int $i Specific (overrides $groups) or virtual (DB_PRIMARY/DB_REPLICA) server index
|
|
* @param string[]|string $groups Query group(s) in preference order; [] for the default group
|
|
* @param string|false $domain DB domain ID or false for the local domain
|
|
* @param int $flags Bitfield of CONN_* class constants (e.g. CONN_TRX_AUTOCOMMIT)
|
|
* @return never
|
|
*/
|
|
public function getConnectionInternal( $i, $groups = [], $domain = false, $flags = 0 ): IDatabase {
|
|
throw new RuntimeException( 'Database backend disabled' );
|
|
}
|
|
|
|
/**
|
|
* @param int $i Specific (overrides $groups) or virtual (DB_PRIMARY/DB_REPLICA) server index
|
|
* @param string[]|string $groups Query group(s) in preference order; [] for the default group
|
|
* @param string|false $domain DB domain ID or false for the local domain
|
|
* @param int $flags Bitfield of CONN_* class constants
|
|
*
|
|
* @return never
|
|
*/
|
|
public function getConnectionRef( $i, $groups = [], $domain = false, $flags = 0 ): DBConnRef {
|
|
throw new RuntimeException( 'Database backend disabled' );
|
|
}
|
|
|
|
/**
|
|
* @param int $i Specific (overrides $groups) or virtual (DB_PRIMARY/DB_REPLICA) server index
|
|
* @param string[]|string $groups Query group(s) in preference order; [] for the default group
|
|
* @param string|false $domain DB domain ID or false for the local domain
|
|
* @param int $flags Bitfield of CONN_* class constants
|
|
*
|
|
* @return never
|
|
*/
|
|
public function getMaintenanceConnectionRef( $i, $groups = [], $domain = false, $flags = 0 ): DBConnRef {
|
|
throw new RuntimeException( 'Database backend disabled' );
|
|
}
|
|
|
|
}
|