includes/ServiceWiring.php

   1 <?php
   2 /**
   3  * Default wiring for MediaWiki services.
   4  *
   5  * This program is free software; you can redistribute it and/or modify
   6  * it under the terms of the GNU General Public License as published by
   7  * the Free Software Foundation; either version 2 of the License, or
   8  * (at your option) any later version.
   9  *
  10  * This program is distributed in the hope that it will be useful,
  11  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  12  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
  13  * GNU General Public License for more details.
  14  *
  15  * You should have received a copy of the GNU General Public License along
  16  * with this program; if not, write to the Free Software Foundation, Inc.,
  17  * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
  18  * http://www.gnu.org/copyleft/gpl.html
  19  *
  20  * @file
  21  *
  22  * This file is loaded by MediaWiki\MediaWikiServices::getInstance() during the
  23  * bootstrapping of the dependency injection framework.
  24  *
  25  * This file returns an array that associates service name with instantiator functions
  26  * that create the default instances for the services used by MediaWiki core.
  27  * For every service that MediaWiki core requires, an instantiator must be defined in
  28  * this file.
  29  *
  30  * @note As of version 1.27, MediaWiki is only beginning to use dependency injection.
  31  * The services defined here do not yet fully represent all services used by core,
  32  * much of the code still relies on global state for this accessing services.
  33  *
  34  * @since 1.27
  35  *
  36  * @see docs/injection.txt for an overview of using dependency injection in the
  37  *      MediaWiki code base.
  38  */
  39
  40 use Liuggio\StatsdClient\Factory\StatsdDataFactoryInterface;
  41 use MediaWiki\Auth\AuthManager;
  42 use MediaWiki\Block\BlockManager;
  43 use MediaWiki\Block\BlockRestrictionStore;
  44 use MediaWiki\Config\ConfigRepository;
  45 use MediaWiki\Config\ServiceOptions;
  46 use MediaWiki\Http\HttpRequestFactory;
  47 use MediaWiki\Interwiki\ClassicInterwikiLookup;
  48 use MediaWiki\Interwiki\InterwikiLookup;
  49 use MediaWiki\Linker\LinkRenderer;
  50 use MediaWiki\Linker\LinkRendererFactory;
  51 use MediaWiki\Logger\LoggerFactory;
  52 use MediaWiki\MediaWikiServices;
  53 use MediaWiki\Page\MovePageFactory;
  54 use MediaWiki\Permissions\PermissionManager;
  55 use MediaWiki\Preferences\PreferencesFactory;
  56 use MediaWiki\Preferences\DefaultPreferencesFactory;
  57 use MediaWiki\Revision\MainSlotRoleHandler;
  58 use MediaWiki\Revision\RevisionFactory;
  59 use MediaWiki\Revision\RevisionLookup;
  60 use MediaWiki\Revision\SlotRoleRegistry;
  61 use MediaWiki\Revision\RevisionRenderer;
  62 use MediaWiki\Revision\RevisionStore;
  63 use MediaWiki\Revision\RevisionStoreFactory;
  64 use MediaWiki\Shell\CommandFactory;
  65 use MediaWiki\Special\SpecialPageFactory;
  66 use MediaWiki\Storage\BlobStore;
  67 use MediaWiki\Storage\BlobStoreFactory;
  68 use MediaWiki\Storage\NameTableStoreFactory;
  69 use MediaWiki\Storage\SqlBlobStore;
  70 use MediaWiki\Storage\PageEditStash;
  71
  72 return [
  73         'ActorMigration' => function ( MediaWikiServices $services ) : ActorMigration {
  74                 return new ActorMigration(
  75                         $services->getMainConfig()->get( 'ActorTableSchemaMigrationStage' )
  76                 );
  77         },
  78
  79         'BlobStore' => function ( MediaWikiServices $services ) : BlobStore {
  80                 return $services->getService( '_SqlBlobStore' );
  81         },
  82
  83         'BlobStoreFactory' => function ( MediaWikiServices $services ) : BlobStoreFactory {
  84                 return new BlobStoreFactory(
  85                         $services->getDBLoadBalancerFactory(),
  86                         $services->getExternalStoreAccess(),
  87                         $services->getMainWANObjectCache(),
  88                         new ServiceOptions( BlobStoreFactory::$constructorOptions,
  89                                 $services->getMainConfig() ),
  90                         $services->getContentLanguage()
  91                 );
  92         },
  93
  94         'BlockManager' => function ( MediaWikiServices $services ) : BlockManager {
  95                 $context = RequestContext::getMain();
  96                 return new BlockManager(
  97                         new ServiceOptions(
  98                                 BlockManager::$constructorOptions, $services->getMainConfig()
  99                         ),
 100                         $context->getUser(),
 101                         $context->getRequest(),
 102                         $services->getPermissionManager()
 103                 );
 104         },
 105
 106         'BlockRestrictionStore' => function ( MediaWikiServices $services ) : BlockRestrictionStore {
 107                 return new BlockRestrictionStore(
 108                         $services->getDBLoadBalancer()
 109                 );
 110         },
 111
 112         'CommentStore' => function ( MediaWikiServices $services ) : CommentStore {
 113                 return new CommentStore(
 114                         $services->getContentLanguage(),
 115                         MIGRATION_NEW
 116                 );
 117         },
 118
 119         'ConfigFactory' => function ( MediaWikiServices $services ) : ConfigFactory {
 120                 // Use the bootstrap config to initialize the ConfigFactory.
 121                 $registry = $services->getBootstrapConfig()->get( 'ConfigRegistry' );
 122                 $factory = new ConfigFactory();
 123
 124                 foreach ( $registry as $name => $callback ) {
 125                         $factory->register( $name, $callback );
 126                 }
 127                 return $factory;
 128         },
 129
 130         'ConfigRepository' => function ( MediaWikiServices $services ) : ConfigRepository {
 131                 return new ConfigRepository( $services->getConfigFactory() );
 132         },
 133
 134         'ConfiguredReadOnlyMode' => function ( MediaWikiServices $services ) : ConfiguredReadOnlyMode {
 135                 $config = $services->getMainConfig();
 136                 return new ConfiguredReadOnlyMode(
 137                         $config->get( 'ReadOnly' ),
 138                         $config->get( 'ReadOnlyFile' )
 139                 );
 140         },
 141
 142         'ContentLanguage' => function ( MediaWikiServices $services ) : Language {
 143                 return Language::factory( $services->getMainConfig()->get( 'LanguageCode' ) );
 144         },
 145
 146         'CryptHKDF' => function ( MediaWikiServices $services ) : CryptHKDF {
 147                 $config = $services->getMainConfig();
 148
 149                 $secret = $config->get( 'HKDFSecret' ) ?: $config->get( 'SecretKey' );
 150                 if ( !$secret ) {
 151                         throw new RuntimeException( "Cannot use MWCryptHKDF without a secret." );
 152                 }
 153
 154                 // In HKDF, the context can be known to the attacker, but this will
 155                 // keep simultaneous runs from producing the same output.
 156                 $context = [ microtime(), getmypid(), gethostname() ];
 157
 158                 // Setup salt cache. Use APC, or fallback to the main cache if it isn't setup
 159                 $cache = $services->getLocalServerObjectCache();
 160                 if ( $cache instanceof EmptyBagOStuff ) {
 161                         $cache = ObjectCache::getLocalClusterInstance();
 162                 }
 163
 164                 return new CryptHKDF( $secret, $config->get( 'HKDFAlgorithm' ), $cache, $context );
 165         },
 166
 167         'DateFormatterFactory' => function () : DateFormatterFactory {
 168                 return new DateFormatterFactory;
 169         },
 170
 171         'DBLoadBalancer' => function ( MediaWikiServices $services ) : Wikimedia\Rdbms\ILoadBalancer {
 172                 // just return the default LB from the DBLoadBalancerFactory service
 173                 return $services->getDBLoadBalancerFactory()->getMainLB();
 174         },
 175
 176         'DBLoadBalancerFactory' =>
 177         function ( MediaWikiServices $services ) : Wikimedia\Rdbms\LBFactory {
 178                 $mainConfig = $services->getMainConfig();
 179
 180                 $lbConf = MWLBFactory::applyDefaultConfig(
 181                         $mainConfig->get( 'LBFactoryConf' ),
 182                         new ServiceOptions( MWLBFactory::$applyDefaultConfigOptions, $mainConfig ),
 183                         $services->getConfiguredReadOnlyMode(),
 184                         $services->getLocalServerObjectCache(),
 185                         $services->getMainObjectStash(),
 186                         $services->getMainWANObjectCache()
 187                 );
 188                 $class = MWLBFactory::getLBFactoryClass( $lbConf );
 189
 190                 $instance = new $class( $lbConf );
 191                 MWLBFactory::setSchemaAliases( $instance, $mainConfig->get( 'DBtype' ) );
 192
 193                 return $instance;
 194         },
 195
 196         'EventRelayerGroup' => function ( MediaWikiServices $services ) : EventRelayerGroup {
 197                 return new EventRelayerGroup( $services->getMainConfig()->get( 'EventRelayerConfig' ) );
 198         },
 199
 200         'ExternalStoreAccess' => function ( MediaWikiServices $services ) : ExternalStoreAccess {
 201                 return new ExternalStoreAccess(
 202                         $services->getExternalStoreFactory(),
 203                         LoggerFactory::getInstance( 'ExternalStore' )
 204                 );
 205         },
 206
 207         'ExternalStoreFactory' => function ( MediaWikiServices $services ) : ExternalStoreFactory {
 208                 $config = $services->getMainConfig();
 209                 $writeStores = $config->get( 'DefaultExternalStore' );
 210
 211                 return new ExternalStoreFactory(
 212                         $config->get( 'ExternalStores' ),
 213                         ( $writeStores !== false ) ? (array)$writeStores : [],
 214                         $services->getDBLoadBalancer()->getLocalDomainID(),
 215                         LoggerFactory::getInstance( 'ExternalStore' )
 216                 );
 217         },
 218
 219         'GenderCache' => function ( MediaWikiServices $services ) : GenderCache {
 220                 $nsInfo = $services->getNamespaceInfo();
 221                 // Database layer may be disabled, so processing without database connection
 222                 $dbLoadBalancer = $services->isServiceDisabled( 'DBLoadBalancer' )
 223                         ? null
 224                         : $services->getDBLoadBalancer();
 225                 return new GenderCache( $nsInfo, $dbLoadBalancer );
 226         },
 227
 228         'HttpRequestFactory' =>
 229         function ( MediaWikiServices $services ) : HttpRequestFactory {
 230                 return new HttpRequestFactory();
 231         },
 232
 233         'InterwikiLookup' => function ( MediaWikiServices $services ) : InterwikiLookup {
 234                 $config = $services->getMainConfig();
 235                 return new ClassicInterwikiLookup(
 236                         $services->getContentLanguage(),
 237                         $services->getMainWANObjectCache(),
 238                         $config->get( 'InterwikiExpiry' ),
 239                         $config->get( 'InterwikiCache' ),
 240                         $config->get( 'InterwikiScopes' ),
 241                         $config->get( 'InterwikiFallbackSite' )
 242                 );
 243         },
 244
 245         'LinkCache' => function ( MediaWikiServices $services ) : LinkCache {
 246                 return new LinkCache(
 247                         $services->getTitleFormatter(),
 248                         $services->getMainWANObjectCache(),
 249                         $services->getNamespaceInfo()
 250                 );
 251         },
 252
 253         'LinkRenderer' => function ( MediaWikiServices $services ) : LinkRenderer {
 254                 if ( defined( 'MW_NO_SESSION' ) ) {
 255                         return $services->getLinkRendererFactory()->create();
 256                 } else {
 257                         return $services->getLinkRendererFactory()->createForUser(
 258                                 RequestContext::getMain()->getUser()
 259                         );
 260                 }
 261         },
 262
 263         'LinkRendererFactory' => function ( MediaWikiServices $services ) : LinkRendererFactory {
 264                 return new LinkRendererFactory(
 265                         $services->getTitleFormatter(),
 266                         $services->getLinkCache(),
 267                         $services->getNamespaceInfo()
 268                 );
 269         },
 270
 271         'LocalServerObjectCache' => function ( MediaWikiServices $services ) : BagOStuff {
 272                 $config = $services->getMainConfig();
 273                 $cacheId = \ObjectCache::detectLocalServerCache();
 274
 275                 return \ObjectCache::newFromParams( $config->get( 'ObjectCaches' )[$cacheId] );
 276         },
 277
 278         'MagicWordFactory' => function ( MediaWikiServices $services ) : MagicWordFactory {
 279                 return new MagicWordFactory( $services->getContentLanguage() );
 280         },
 281
 282         'MainConfig' => function ( MediaWikiServices $services ) : Config {
 283                 // Use the 'main' config from the ConfigFactory service.
 284                 return $services->getConfigFactory()->makeConfig( 'main' );
 285         },
 286
 287         'MainObjectStash' => function ( MediaWikiServices $services ) : BagOStuff {
 288                 $mainConfig = $services->getMainConfig();
 289
 290                 $id = $mainConfig->get( 'MainStash' );
 291                 if ( !isset( $mainConfig->get( 'ObjectCaches' )[$id] ) ) {
 292                         throw new UnexpectedValueException(
 293                                 "Cache type \"$id\" is not present in \$wgObjectCaches." );
 294                 }
 295
 296                 return \ObjectCache::newFromParams( $mainConfig->get( 'ObjectCaches' )[$id] );
 297         },
 298
 299         'MainWANObjectCache' => function ( MediaWikiServices $services ) : WANObjectCache {
 300                 $mainConfig = $services->getMainConfig();
 301
 302                 $id = $mainConfig->get( 'MainWANCache' );
 303                 if ( !isset( $mainConfig->get( 'WANObjectCaches' )[$id] ) ) {
 304                         throw new UnexpectedValueException(
 305                                 "WAN cache type \"$id\" is not present in \$wgWANObjectCaches." );
 306                 }
 307
 308                 $params = $mainConfig->get( 'WANObjectCaches' )[$id];
 309                 $objectCacheId = $params['cacheId'];
 310                 if ( !isset( $mainConfig->get( 'ObjectCaches' )[$objectCacheId] ) ) {
 311                         throw new UnexpectedValueException(
 312                                 "Cache type \"$objectCacheId\" is not present in \$wgObjectCaches." );
 313                 }
 314                 $params['store'] = $mainConfig->get( 'ObjectCaches' )[$objectCacheId];
 315
 316                 return \ObjectCache::newWANCacheFromParams( $params );
 317         },
 318
 319         'MediaHandlerFactory' => function ( MediaWikiServices $services ) : MediaHandlerFactory {
 320                 return new MediaHandlerFactory(
 321                         $services->getMainConfig()->get( 'MediaHandlers' )
 322                 );
 323         },
 324
 325         'MessageCache' => function ( MediaWikiServices $services ) : MessageCache {
 326                 $mainConfig = $services->getMainConfig();
 327                 return new MessageCache(
 328                         $services->getMainWANObjectCache(),
 329                         ObjectCache::getInstance( $mainConfig->get( 'MessageCacheType' ) ),
 330                         $mainConfig->get( 'UseLocalMessageCache' )
 331                                 ? $services->getLocalServerObjectCache()
 332                                 : new EmptyBagOStuff(),
 333                         $mainConfig->get( 'UseDatabaseMessages' ),
 334                         $mainConfig->get( 'MsgCacheExpiry' ),
 335                         $services->getContentLanguage()
 336                 );
 337         },
 338
 339         'MimeAnalyzer' => function ( MediaWikiServices $services ) : MimeAnalyzer {
 340                 $logger = LoggerFactory::getInstance( 'Mime' );
 341                 $mainConfig = $services->getMainConfig();
 342                 $params = [
 343                         'typeFile' => $mainConfig->get( 'MimeTypeFile' ),
 344                         'infoFile' => $mainConfig->get( 'MimeInfoFile' ),
 345                         'xmlTypes' => $mainConfig->get( 'XMLMimeTypes' ),
 346                         'guessCallback' =>
 347                                 function ( $mimeAnalyzer, &$head, &$tail, $file, &$mime ) use ( $logger ) {
 348                                         // Also test DjVu
 349                                         $deja = new DjVuImage( $file );
 350                                         if ( $deja->isValid() ) {
 351                                                 $logger->info( "Detected $file as image/vnd.djvu\n" );
 352                                                 $mime = 'image/vnd.djvu';
 353
 354                                                 return;
 355                                         }
 356                                         // Some strings by reference for performance - assuming well-behaved hooks
 357                                         Hooks::run(
 358                                                 'MimeMagicGuessFromContent',
 359                                                 [ $mimeAnalyzer, &$head, &$tail, $file, &$mime ]
 360                                         );
 361                                 },
 362                         'extCallback' => function ( $mimeAnalyzer, $ext, &$mime ) {
 363                                 // Media handling extensions can improve the MIME detected
 364                                 Hooks::run( 'MimeMagicImproveFromExtension', [ $mimeAnalyzer, $ext, &$mime ] );
 365                         },
 366                         'initCallback' => function ( $mimeAnalyzer ) {
 367                                 // Allow media handling extensions adding MIME-types and MIME-info
 368                                 Hooks::run( 'MimeMagicInit', [ $mimeAnalyzer ] );
 369                         },
 370                         'logger' => $logger
 371                 ];
 372
 373                 if ( $params['infoFile'] === 'includes/mime.info' ) {
 374                         $params['infoFile'] = __DIR__ . "/libs/mime/mime.info";
 375                 }
 376
 377                 if ( $params['typeFile'] === 'includes/mime.types' ) {
 378                         $params['typeFile'] = __DIR__ . "/libs/mime/mime.types";
 379                 }
 380
 381                 $detectorCmd = $mainConfig->get( 'MimeDetectorCommand' );
 382                 if ( $detectorCmd ) {
 383                         $factory = $services->getShellCommandFactory();
 384                         $params['detectCallback'] = function ( $file ) use ( $detectorCmd, $factory ) {
 385                                 $result = $factory->create()
 386                                         // $wgMimeDetectorCommand can contain commands with parameters
 387                                         ->unsafeParams( $detectorCmd )
 388                                         ->params( $file )
 389                                         ->execute();
 390                                 return $result->getStdout();
 391                         };
 392                 }
 393
 394                 return new MimeAnalyzer( $params );
 395         },
 396
 397         'MovePageFactory' => function ( MediaWikiServices $services ) : MovePageFactory {
 398                 return new MovePageFactory(
 399                         new ServiceOptions( MovePageFactory::$constructorOptions, $services->getMainConfig() ),
 400                         $services->getDBLoadBalancer(),
 401                         $services->getNamespaceInfo(),
 402                         $services->getWatchedItemStore(),
 403                         $services->getPermissionManager(),
 404                         $services->getRepoGroup()
 405                 );
 406         },
 407
 408         'NamespaceInfo' => function ( MediaWikiServices $services ) : NamespaceInfo {
 409                 return new NamespaceInfo( new ServiceOptions( NamespaceInfo::$constructorOptions,
 410                         $services->getMainConfig() ) );
 411         },
 412
 413         'NameTableStoreFactory' => function ( MediaWikiServices $services ) : NameTableStoreFactory {
 414                 return new NameTableStoreFactory(
 415                         $services->getDBLoadBalancerFactory(),
 416                         $services->getMainWANObjectCache(),
 417                         LoggerFactory::getInstance( 'NameTableSqlStore' )
 418                 );
 419         },
 420
 421         'OldRevisionImporter' => function ( MediaWikiServices $services ) : OldRevisionImporter {
 422                 return new ImportableOldRevisionImporter(
 423                         true,
 424                         LoggerFactory::getInstance( 'OldRevisionImporter' ),
 425                         $services->getDBLoadBalancer()
 426                 );
 427         },
 428
 429         'PageEditStash' => function ( MediaWikiServices $services ) : PageEditStash {
 430                 $config = $services->getMainConfig();
 431
 432                 return new PageEditStash(
 433                         ObjectCache::getLocalClusterInstance(),
 434                         $services->getDBLoadBalancer(),
 435                         LoggerFactory::getInstance( 'StashEdit' ),
 436                         $services->getStatsdDataFactory(),
 437                         defined( 'MEDIAWIKI_JOB_RUNNER' ) || $config->get( 'CommandLineMode' )
 438                                 ? PageEditStash::INITIATOR_JOB_OR_CLI
 439                                 : PageEditStash::INITIATOR_USER
 440                 );
 441         },
 442
 443         'Parser' => function ( MediaWikiServices $services ) : Parser {
 444                 return $services->getParserFactory()->create();
 445         },
 446
 447         'ParserCache' => function ( MediaWikiServices $services ) : ParserCache {
 448                 $config = $services->getMainConfig();
 449                 $cache = ObjectCache::getInstance( $config->get( 'ParserCacheType' ) );
 450                 wfDebugLog( 'caches', 'parser: ' . get_class( $cache ) );
 451
 452                 return new ParserCache(
 453                         $cache,
 454                         $config->get( 'CacheEpoch' )
 455                 );
 456         },
 457
 458         'ParserFactory' => function ( MediaWikiServices $services ) : ParserFactory {
 459                 $options = new ServiceOptions( Parser::$constructorOptions,
 460                         // 'class' and 'preprocessorClass'
 461                         $services->getMainConfig()->get( 'ParserConf' ),
 462                         // Make sure to have defaults in case someone overrode ParserConf with something silly
 463                         [ 'class' => Parser::class,
 464                                 'preprocessorClass' => Parser::getDefaultPreprocessorClass() ],
 465                         // Plus a buch of actual config options
 466                         $services->getMainConfig()
 467                 );
 468
 469                 return new ParserFactory(
 470                         $options,
 471                         $services->getMagicWordFactory(),
 472                         $services->getContentLanguage(),
 473                         wfUrlProtocols(),
 474                         $services->getSpecialPageFactory(),
 475                         $services->getLinkRendererFactory(),
 476                         $services->getNamespaceInfo(),
 477                         LoggerFactory::getInstance( 'Parser' )
 478                 );
 479         },
 480
 481         'PasswordFactory' => function ( MediaWikiServices $services ) : PasswordFactory {
 482                 $config = $services->getMainConfig();
 483                 return new PasswordFactory(
 484                         $config->get( 'PasswordConfig' ),
 485                         $config->get( 'PasswordDefault' )
 486                 );
 487         },
 488
 489         'PerDbNameStatsdDataFactory' =>
 490         function ( MediaWikiServices $services ) : StatsdDataFactoryInterface {
 491                 $config = $services->getMainConfig();
 492                 $wiki = $config->get( 'DBname' );
 493                 return new PrefixingStatsdDataFactoryProxy(
 494                         $services->getStatsdDataFactory(),
 495                         $wiki
 496                 );
 497         },
 498
 499         'PermissionManager' => function ( MediaWikiServices $services ) : PermissionManager {
 500                 $config = $services->getMainConfig();
 501                 return new PermissionManager(
 502                         $services->getSpecialPageFactory(),
 503                         $services->getRevisionLookup(),
 504                         $config->get( 'WhitelistRead' ),
 505                         $config->get( 'WhitelistReadRegexp' ),
 506                         $config->get( 'EmailConfirmToEdit' ),
 507                         $config->get( 'BlockDisablesLogin' ),
 508                         $config->get( 'GroupPermissions' ),
 509                         $config->get( 'RevokePermissions' ),
 510                         $config->get( 'AvailableRights' ),
 511                         $services->getNamespaceInfo()
 512                 );
 513         },
 514
 515         'PreferencesFactory' => function ( MediaWikiServices $services ) : PreferencesFactory {
 516                 $factory = new DefaultPreferencesFactory(
 517                         new ServiceOptions(
 518                                 DefaultPreferencesFactory::$constructorOptions, $services->getMainConfig() ),
 519                         $services->getContentLanguage(),
 520                         AuthManager::singleton(),
 521                         $services->getLinkRendererFactory()->create(),
 522                         $services->getNamespaceInfo()
 523                 );
 524                 $factory->setLogger( LoggerFactory::getInstance( 'preferences' ) );
 525
 526                 return $factory;
 527         },
 528
 529         'ProxyLookup' => function ( MediaWikiServices $services ) : ProxyLookup {
 530                 $mainConfig = $services->getMainConfig();
 531                 return new ProxyLookup(
 532                         $mainConfig->get( 'CdnServers' ),
 533                         $mainConfig->get( 'CdnServersNoPurge' )
 534                 );
 535         },
 536
 537         'ReadOnlyMode' => function ( MediaWikiServices $services ) : ReadOnlyMode {
 538                 return new ReadOnlyMode(
 539                         $services->getConfiguredReadOnlyMode(),
 540                         $services->getDBLoadBalancer()
 541                 );
 542         },
 543
 544         'RepoGroup' => function ( MediaWikiServices $services ) : RepoGroup {
 545                 $config = $services->getMainConfig();
 546                 return new RepoGroup(
 547                         $config->get( 'LocalFileRepo' ),
 548                         $config->get( 'ForeignFileRepos' ),
 549                         $services->getMainWANObjectCache()
 550                 );
 551         },
 552
 553         'ResourceLoader' => function ( MediaWikiServices $services ) : ResourceLoader {
 554                 // @todo This should not take a Config object, but it's not so easy to remove because it
 555                 // exposes it in a getter, which is actually used.
 556                 global $IP;
 557                 $config = $services->getMainConfig();
 558
 559                 $rl = new ResourceLoader(
 560                         $config,
 561                         LoggerFactory::getInstance( 'resourceloader' )
 562                 );
 563
 564                 $rl->addSource( $config->get( 'ResourceLoaderSources' ) );
 565
 566                 // Core modules, then extension/skin modules
 567                 $rl->register( include "$IP/resources/Resources.php" );
 568                 $rl->register( $config->get( 'ResourceModules' ) );
 569                 Hooks::run( 'ResourceLoaderRegisterModules', [ &$rl ] );
 570
 571                 if ( $config->get( 'EnableJavaScriptTest' ) === true ) {
 572                         $rl->registerTestModules();
 573                 }
 574
 575                 return $rl;
 576         },
 577
 578         'RevisionFactory' => function ( MediaWikiServices $services ) : RevisionFactory {
 579                 return $services->getRevisionStore();
 580         },
 581
 582         'RevisionLookup' => function ( MediaWikiServices $services ) : RevisionLookup {
 583                 return $services->getRevisionStore();
 584         },
 585
 586         'RevisionRenderer' => function ( MediaWikiServices $services ) : RevisionRenderer {
 587                 $renderer = new RevisionRenderer(
 588                         $services->getDBLoadBalancer(),
 589                         $services->getSlotRoleRegistry()
 590                 );
 591
 592                 $renderer->setLogger( LoggerFactory::getInstance( 'SaveParse' ) );
 593                 return $renderer;
 594         },
 595
 596         'RevisionStore' => function ( MediaWikiServices $services ) : RevisionStore {
 597                 return $services->getRevisionStoreFactory()->getRevisionStore();
 598         },
 599
 600         'RevisionStoreFactory' => function ( MediaWikiServices $services ) : RevisionStoreFactory {
 601                 $config = $services->getMainConfig();
 602                 $store = new RevisionStoreFactory(
 603                         $services->getDBLoadBalancerFactory(),
 604                         $services->getBlobStoreFactory(),
 605                         $services->getNameTableStoreFactory(),
 606                         $services->getSlotRoleRegistry(),
 607                         $services->getMainWANObjectCache(),
 608                         $services->getCommentStore(),
 609                         $services->getActorMigration(),
 610                         $config->get( 'MultiContentRevisionSchemaMigrationStage' ),
 611                         LoggerFactory::getProvider(),
 612                         $config->get( 'ContentHandlerUseDB' )
 613                 );
 614
 615                 return $store;
 616         },
 617
 618         'SearchEngineConfig' => function ( MediaWikiServices $services ) : SearchEngineConfig {
 619                 // @todo This should not take a Config object, but it's not so easy to remove because it
 620                 // exposes it in a getter, which is actually used.
 621                 return new SearchEngineConfig( $services->getMainConfig(),
 622                         $services->getContentLanguage() );
 623         },
 624
 625         'SearchEngineFactory' => function ( MediaWikiServices $services ) : SearchEngineFactory {
 626                 return new SearchEngineFactory( $services->getSearchEngineConfig() );
 627         },
 628
 629         'ShellCommandFactory' => function ( MediaWikiServices $services ) : CommandFactory {
 630                 $config = $services->getMainConfig();
 631
 632                 $limits = [
 633                         'time' => $config->get( 'MaxShellTime' ),
 634                         'walltime' => $config->get( 'MaxShellWallClockTime' ),
 635                         'memory' => $config->get( 'MaxShellMemory' ),
 636                         'filesize' => $config->get( 'MaxShellFileSize' ),
 637                 ];
 638                 $cgroup = $config->get( 'ShellCgroup' );
 639                 $restrictionMethod = $config->get( 'ShellRestrictionMethod' );
 640
 641                 $factory = new CommandFactory( $limits, $cgroup, $restrictionMethod );
 642                 $factory->setLogger( LoggerFactory::getInstance( 'exec' ) );
 643                 $factory->logStderr();
 644
 645                 return $factory;
 646         },
 647
 648         'SiteLookup' => function ( MediaWikiServices $services ) : SiteLookup {
 649                 // Use SiteStore as the SiteLookup as well. This was originally separated
 650                 // to allow for a cacheable read-only interface (using FileBasedSiteLookup),
 651                 // but this was never used. SiteStore has caching (see below).
 652                 return $services->getSiteStore();
 653         },
 654
 655         'SiteStore' => function ( MediaWikiServices $services ) : SiteStore {
 656                 $rawSiteStore = new DBSiteStore( $services->getDBLoadBalancer() );
 657
 658                 $cache = $services->getLocalServerObjectCache();
 659                 if ( $cache instanceof EmptyBagOStuff ) {
 660                         $cache = ObjectCache::getLocalClusterInstance();
 661                 }
 662
 663                 return new CachingSiteStore( $rawSiteStore, $cache );
 664         },
 665
 666         'SkinFactory' => function ( MediaWikiServices $services ) : SkinFactory {
 667                 $factory = new SkinFactory();
 668
 669                 $names = $services->getMainConfig()->get( 'ValidSkinNames' );
 670
 671                 foreach ( $names as $name => $skin ) {
 672                         $factory->register( $name, $skin, function () use ( $name, $skin ) {
 673                                 $class = "Skin$skin";
 674                                 return new $class( $name );
 675                         } );
 676                 }
 677                 // Register a hidden "fallback" skin
 678                 $factory->register( 'fallback', 'Fallback', function () {
 679                         return new SkinFallback;
 680                 } );
 681                 // Register a hidden skin for api output
 682                 $factory->register( 'apioutput', 'ApiOutput', function () {
 683                         return new SkinApi;
 684                 } );
 685
 686                 return $factory;
 687         },
 688
 689         'SlotRoleRegistry' => function ( MediaWikiServices $services ) : SlotRoleRegistry {
 690                 $config = $services->getMainConfig();
 691
 692                 $registry = new SlotRoleRegistry(
 693                         $services->getNameTableStoreFactory()->getSlotRoles()
 694                 );
 695
 696                 $registry->defineRole( 'main', function () use ( $config ) {
 697                         return new MainSlotRoleHandler(
 698                                 $config->get( 'NamespaceContentModels' )
 699                         );
 700                 } );
 701
 702                 return $registry;
 703         },
 704
 705         'SpecialPageFactory' => function ( MediaWikiServices $services ) : SpecialPageFactory {
 706                 return new SpecialPageFactory(
 707                         new ServiceOptions(
 708                                 SpecialPageFactory::$constructorOptions, $services->getMainConfig() ),
 709                         $services->getContentLanguage()
 710                 );
 711         },
 712
 713         'StatsdDataFactory' => function ( MediaWikiServices $services ) : IBufferingStatsdDataFactory {
 714                 return new BufferingStatsdDataFactory(
 715                         rtrim( $services->getMainConfig()->get( 'StatsdMetricPrefix' ), '.' )
 716                 );
 717         },
 718
 719         'TitleFormatter' => function ( MediaWikiServices $services ) : TitleFormatter {
 720                 return $services->getService( '_MediaWikiTitleCodec' );
 721         },
 722
 723         'TitleParser' => function ( MediaWikiServices $services ) : TitleParser {
 724                 return $services->getService( '_MediaWikiTitleCodec' );
 725         },
 726
 727         'UploadRevisionImporter' => function ( MediaWikiServices $services ) : UploadRevisionImporter {
 728                 return new ImportableUploadRevisionImporter(
 729                         $services->getMainConfig()->get( 'EnableUploads' ),
 730                         LoggerFactory::getInstance( 'UploadRevisionImporter' )
 731                 );
 732         },
 733
 734         'VirtualRESTServiceClient' =>
 735         function ( MediaWikiServices $services ) : VirtualRESTServiceClient {
 736                 $config = $services->getMainConfig()->get( 'VirtualRestConfig' );
 737
 738                 $vrsClient = new VirtualRESTServiceClient( new MultiHttpClient( [] ) );
 739                 foreach ( $config['paths'] as $prefix => $serviceConfig ) {
 740                         $class = $serviceConfig['class'];
 741                         // Merge in the global defaults
 742                         $constructArg = $serviceConfig['options'] ?? [];
 743                         $constructArg += $config['global'];
 744                         // Make the VRS service available at the mount point
 745                         $vrsClient->mount( $prefix, [ 'class' => $class, 'config' => $constructArg ] );
 746                 }
 747
 748                 return $vrsClient;
 749         },
 750
 751         'WatchedItemQueryService' =>
 752         function ( MediaWikiServices $services ) : WatchedItemQueryService {
 753                 return new WatchedItemQueryService(
 754                         $services->getDBLoadBalancer(),
 755                         $services->getCommentStore(),
 756                         $services->getActorMigration(),
 757                         $services->getWatchedItemStore()
 758                 );
 759         },
 760
 761         'WatchedItemStore' => function ( MediaWikiServices $services ) : WatchedItemStore {
 762                 $store = new WatchedItemStore(
 763                         $services->getDBLoadBalancerFactory(),
 764                         JobQueueGroup::singleton(),
 765                         $services->getMainObjectStash(),
 766                         new HashBagOStuff( [ 'maxKeys' => 100 ] ),
 767                         $services->getReadOnlyMode(),
 768                         $services->getMainConfig()->get( 'UpdateRowsPerQuery' ),
 769                         $services->getNamespaceInfo(),
 770                         $services->getRevisionLookup()
 771                 );
 772                 $store->setStatsdDataFactory( $services->getStatsdDataFactory() );
 773
 774                 if ( $services->getMainConfig()->get( 'ReadOnlyWatchedItemStore' ) ) {
 775                         $store = new NoWriteWatchedItemStore( $store );
 776                 }
 777
 778                 return $store;
 779         },
 780
 781         'WikiRevisionOldRevisionImporterNoUpdates' =>
 782         function ( MediaWikiServices $services ) : ImportableOldRevisionImporter {
 783                 return new ImportableOldRevisionImporter(
 784                         false,
 785                         LoggerFactory::getInstance( 'OldRevisionImporter' ),
 786                         $services->getDBLoadBalancer()
 787                 );
 788         },
 789
 790         '_MediaWikiTitleCodec' => function ( MediaWikiServices $services ) : MediaWikiTitleCodec {
 791                 return new MediaWikiTitleCodec(
 792                         $services->getContentLanguage(),
 793                         $services->getGenderCache(),
 794                         $services->getMainConfig()->get( 'LocalInterwikis' ),
 795                         $services->getInterwikiLookup(),
 796                         $services->getNamespaceInfo()
 797                 );
 798         },
 799
 800         '_SqlBlobStore' => function ( MediaWikiServices $services ) : SqlBlobStore {
 801                 return $services->getBlobStoreFactory()->newSqlBlobStore();
 802         },
 803
 804         ///////////////////////////////////////////////////////////////////////////
 805         // NOTE: When adding a service here, don't forget to add a getter function
 806         // in the MediaWikiServices class. The convenience getter should just call
 807         // $this->getService( 'FooBarService' ).
 808         ///////////////////////////////////////////////////////////////////////////
 809
 810 ];