1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
|
<?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' );
}
}
|
