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
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
|
<?php
/**
* Extra settings useful for MediaWiki development.
*
* To enable built-in debug and development settings, add the
* following to your LocalSettings.php file.
*
* require "$IP/includes/DevelopmentSettings.php";
*
* @file
*/
use Wikimedia\FileBackend\FSFile\TempFSFile;
/**
* Ad-hoc debugging
*
* To keep your Git copy clean and easier to work with, it is recommended
* to copy this to your LocalSettings.php and enable them as-needed.
* These are not enabled by default as they make the wiki considerably
* slower and/or significantly alter how things work or look.
*
* See https://www.mediawiki.org/wiki/How_to_debug
*/
// $wgDebugDumpSql = true;
// $wgDebugRawPage = true;
// $wgDebugToolbar = true;
/**
* Debugging for PHP
*/
// Enable logging of all errors
error_reporting( -1 );
// Enable showing of errors, but avoid breaking non-HTML responses
if ( MW_ENTRY_POINT === 'index' ) {
ini_set( 'display_errors', '1' );
}
/**
* Debugging for MediaWiki
*/
global $wgDevelopmentWarnings, $wgShowExceptionDetails, $wgShowHostnames,
$wgDebugLogFile,
$wgDBerrorLog, $wgDebugLogGroups;
// Use of wfWarn() should cause tests to fail
$wgDevelopmentWarnings = true;
// Enable showing of errors
$wgShowExceptionDetails = true;
$wgShowHostnames = true;
// Enable log files
$logDir = getenv( 'MW_LOG_DIR' );
if ( $logDir ) {
if ( !file_exists( $logDir ) ) {
mkdir( $logDir );
}
$logFileNames = [
'debug-cli' => 'mw-debug-cli',
'debug-web' => 'mw-debug-web',
'db' => 'mw-dberror',
'ratelimit' => 'mw-ratelimit',
'error' => 'mw-error',
];
// For PHPUnit tests run in parallel via ComposerLaunchParallel,
// there will be an environment variable containing the group ID
// of the batch of tests being run in a process. Use this to group
// those logs together.
$splitGroupLogId = getenv( 'MW_PHPUNIT_SPLIT_GROUP_ID' );
foreach ( $logFileNames as $key => $logFileName ) {
if ( $splitGroupLogId ) {
$logFileNames[$key] = "$logDir/$logFileName.split-group-$splitGroupLogId.log";
} else {
$logFileNames[$key] = "$logDir/$logFileName.log";
}
}
if ( MW_ENTRY_POINT === 'cli' ) {
$wgDebugLogFile = $logFileNames['debug-cli'];
} else {
$wgDebugLogFile = $logFileNames['debug-web'];
}
$wgDBerrorLog = $logFileNames['db'];
$wgDebugLogGroups['ratelimit'] = $logFileNames['ratelimit'];
$wgDebugLogGroups['error'] = $logFileNames['error'];
$wgDebugLogGroups['exception'] = $logFileNames['error'];
}
unset( $logDir );
/**
* Make testing possible (or easier)
*/
global $wgRateLimits, $wgEnableJavaScriptTest, $wgRestAPIAdditionalRouteFiles,
$wgPasswordAttemptThrottle, $wgForceDeferredUpdatesPreSend,
$wgParsoidSettings, $wgMaxArticleSize;
// Set almost infinite rate limits. This allows integration tests to run unthrottled
// in CI and for devs locally (T225796), but doesn't turn a large chunk of production
// code completely off during testing (T284804)
foreach ( $wgRateLimits as $right => &$limit ) {
foreach ( $limit as $group => &$groupLimit ) {
$groupLimit[0] = PHP_INT_MAX;
}
}
// Enable Special:JavaScriptTest and allow `npm run qunit` to work
// https://www.mediawiki.org/wiki/Manual:JavaScript_unit_testing
$wgEnableJavaScriptTest = true;
// Enable development/experimental endpoints
$wgRestAPIAdditionalRouteFiles[] = 'includes/Rest/coreDevelopmentRoutes.json';
$wgRestAPIAdditionalRouteFiles[] = 'includes/Rest/content.v1.json';
$wgRestAPIAdditionalRouteFiles[] = 'includes/Rest/specs.v0.json';
// Greatly raise the limits on short/long term login attempts,
// so that automated tests run in parallel don't error.
$wgPasswordAttemptThrottle = [
[ 'count' => 1000, 'seconds' => 300 ],
[ 'count' => 100000, 'seconds' => 60 * 60 * 48 ],
];
// Run deferred updates before sending a response to the client.
// This ensures that in end-to-end tests, a GET request will see the
// effect of all previous POST requests (T230211).
// Caveat: this does not wait for jobs to be executed, and it does
// not wait for database replication to complete.
$wgForceDeferredUpdatesPreSend = true;
// Set size limits for parsing small enough so we can test them,
// but not so small that they interfere with other tests.
$wgMaxArticleSize = 20; // in Kilobyte
$wgParsoidSettings['wt2htmlLimits']['wikitextSize'] = 20 * 1024; // $wgMaxArticleSize, in byte
$wgParsoidSettings['html2wtLimits']['htmlSize'] = 100 * 1024; // in characters!
// Enable Vue dev mode by default, so that Vue devtools are functional.
$wgVueDevelopmentMode = true;
// Disable rate limiting of temp account creation and temp account name
// acquisition, to facilitate local development and testing
$wgTempAccountCreationThrottle = [];
$wgTempAccountNameAcquisitionThrottle = [];
/**
* Experimental changes that may later become the default.
* (Must reference a Phabricator ticket)
*/
global $wgSQLMode, $wgDBStrictWarnings, $wgLocalisationCacheConf, $wgCiteBookReferencing,
$wgCacheDirectory, $wgEnableUploads, $wgUsePigLatinVariant,
$wgVisualEditorEnableWikitext, $wgDefaultUserOptions, $wgAutoCreateTempUser;
// Enable MariaDB/MySQL strict mode (T108255)
$wgSQLMode = 'STRICT_ALL_TABLES,ONLY_FULL_GROUP_BY';
$wgDBStrictWarnings = true;
// Localisation Cache to StaticArray (T218207)
$wgLocalisationCacheConf['store'] = 'array';
// Experimental Book Referencing feature (T236255)
$wgCiteBookReferencing = true;
// The default value is false, but for development it is useful to set this to the system temp
// directory by default (T218207)
$wgCacheDirectory = TempFSFile::getUsableTempDirectory() .
DIRECTORY_SEPARATOR .
rawurlencode( MediaWiki\WikiMap\WikiMap::getCurrentWikiId() );
// Enable uploads for FileImporter browser tests (T190829)
$wgEnableUploads = true;
// Enable en-x-piglatin variant conversion for testing
$wgUsePigLatinVariant = true;
// Enable x-xss language code for testing correct message escaping
$wgUseXssLanguage = true;
// Enable the new wikitext mode for browser testing (T270240)
$wgVisualEditorEnableWikitext = true;
// Currently the default, but repeated here for safety since it would break many source editor tests.
$wgDefaultUserOptions['visualeditor-newwikitext'] = 0;
// Enable creation of temp user accounts on edit (T355880, T359043)
$wgAutoCreateTempUser['enabled'] = true;
// Make sure Mocha tests can create language links by defining an interwiki
// prefix that matches a known language code.
$wgHooks['InterwikiLoadPrefix'][] = static function ( $prefix, &$iwData ) {
if ( $prefix === 'en-x-piglatin' ) {
$iwData['iw_url'] = 'https://piggy.wikipedia.org/wiki/$1';
return false;
}
return true;
};
|
