1b218b2b54
The benefit of this setting was largely lost due to wfDebug() having been replaced with calls to Logger->debug() for much of our code. This is motivated by making ResourcLoader debug=2 able to make its concurrent load.php requests more quickly during local dev. This effectively reverts T49960. I was wrong there, thinking that this variable has no reason for being. The vast majority of the time, these aren't of interest on subresource requests. It's trivial to enable when wanted, and any non-debug level messages still come through either way, including PHP runtime errors, exceptions, warnings, etc. This seems to make load.php about 50% faster for local development when using mediawiki-docker. I used `ab` to perform a load.php request 300 times. The mean was 320-360ms before this patch (with and without DebugRawPage=false), and around 120-140ms with patch (with DebugRawPage=false, default). Bug: T85805 Bug: T225730 Change-Id: I061419adebf43e83cd0103bdb9b7a3296a2a1122
133 lines
4.1 KiB
PHP
133 lines
4.1 KiB
PHP
<?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
|
|
*/
|
|
|
|
/**
|
|
* 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.
|
|
* This 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 showing of errors
|
|
error_reporting( -1 );
|
|
// @phan-suppress-next-line PhanTypeMismatchArgumentInternal Scalar okay with php8.1
|
|
ini_set( 'display_errors', 1 );
|
|
|
|
/**
|
|
* Debugging for MediaWiki
|
|
*/
|
|
|
|
global $wgDevelopmentWarnings, $wgShowExceptionDetails, $wgShowHostnames,
|
|
$wgCommandLineMode, $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 ( $wgCommandLineMode ) {
|
|
$wgDebugLogFile = "$logDir/mw-debug-cli.log";
|
|
} else {
|
|
$wgDebugLogFile = "$logDir/mw-debug-www.log";
|
|
}
|
|
$wgDBerrorLog = "$logDir/mw-dberror.log";
|
|
$wgDebugLogGroups['ratelimit'] = "$logDir/mw-ratelimit.log";
|
|
$wgDebugLogGroups['error'] = "$logDir/mw-error.log";
|
|
$wgDebugLogGroups['exception'] = "$logDir/mw-error.log";
|
|
}
|
|
unset( $logDir );
|
|
|
|
/**
|
|
* Make testing possible (or easier)
|
|
*/
|
|
|
|
global $wgRateLimits, $wgEnableJavaScriptTest, $wgRestAPIAdditionalRouteFiles,
|
|
$wgDeferredUpdateStrategy;
|
|
|
|
// 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' ];
|
|
|
|
// 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;
|
|
|
|
/**
|
|
* Experimental changes that may later become the default.
|
|
* (Must reference a Phabricator ticket)
|
|
*/
|
|
|
|
global $wgSQLMode, $wgLocalisationCacheConf,
|
|
$wgCacheDirectory, $wgEnableUploads, $wgCiteBookReferencing;
|
|
|
|
// Enable MariaDB/MySQL strict mode (T108255)
|
|
$wgSQLMode = 'STRICT_ALL_TABLES,ONLY_FULL_GROUP_BY';
|
|
|
|
// 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( WikiMap::getCurrentWikiId() );
|
|
|
|
// Enable uploads for FileImporter browser tests (T190829)
|
|
$wgEnableUploads = 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;
|