RELEASE-NOTES-1.37

   1 = MediaWiki 1.37 =
   2
   3 == MediaWiki 1.37.0-PRERELEASE ==
   4
   5 THIS IS NOT A RELEASE YET
   6
   7 MediaWiki 1.37 is an alpha-quality development branch, and is not recommended
   8 for use in production.
   9
  10 == Upgrading notes for 1.37 ==
  11 Don't forget to always back up your database before upgrading!
  12
  13 See the file UPGRADE for more detailed per-version upgrade instructions from the
  14 oldest supported upgrading version, MediaWiki 1.27.
  15
  16 Some specific notes for MediaWiki 1.37 upgrades are below:
  17 * …
  18
  19 For notes on 1.36.x and older releases, see HISTORY.
  20
  21 === Configuration changes for system administrators in 1.37 ===
  22 * …
  23
  24 ==== New configuration ====
  25 * $wgBrowserFormatDetection - This setting allows the enabling or disabling
  26 of automatic detection of possible phone numbers in a webpage in Safari on iOS.
  27 * …
  28
  29 ==== Changed configuration ====
  30 * $wgContentHandlerTextFallback - This setting, which defines how to
  31   react if a plain text version of a non-text Content object is
  32   requested using ContentHandler::getContentText(), is deprecated.
  33 * $wgActions was reworked to support injecting dependencies into
  34   Action subclasses. Previously, $wgActions was an array where the
  35   keys were the names of actions, and the values had the following
  36   impacts (for a given key 'Foo')
  37   - `true`: use the class 'FooAction' unless for a specific page
  38       WikiPage::getActionOverrides() wants to override that action
  39   - a string: use the class with that name, and do not allow overriding
  40       on a per-page basis
  41   - `false`: the action is disabled
  42   - a callable: use the Action instance returned by invoking that
  43       callback, and do not allow overriding on a per-page basis
  44   - an object: use that specific Action instance, and do not allow
  45       overriding on a per-page basis.
  46   As part of T253078, values can now be arrays that are not callables,
  47   which are treated as ObjectFactory specs, allowing for services to
  48   be injected. Additionally, the distinction between values that allow
  49   per-page overrides and those that do not was removed - all actions
  50   can now be overridden on a per-page basis using
  51   WikiPage::getActionOverrides().
  52 * $wgShellboxUrl is deprecated, use $wgShellboxUrls as a mapping of
  53   service => URL instead.
  54 * $wgIncludejQueryMigrate Default value for this configuration has changed
  55   from true to false. This may break gadgets that depended on methods removed
  56   in jQuery 3. See T280944 for more information.
  57 * …
  58
  59 ==== Removed configuration ====
  60 * $wgLegacyJavaScriptGlobals, deprecated in 1.36.
  61 * $wgShowDBErrorBacktrace, deprecated and non-functional since 1.32.
  62 * $wgShowSQLErrors, deprecated and non-functional since 1.32.
  63 * $wgLangObjCacheSize - The LanguageFactory service now always retains
  64   at most 10 objects in its LRU-cache.
  65
  66 === New user-facing features in 1.37 ===
  67 * (T161934) MediaWiki now supports JPEG2000 files, to a limited extent.
  68 * Media files uploaded server side using the importImages.php maintenance
  69   script now have the "mw-server-side-upload" change tag.
  70 * …
  71
  72 === New developer features in 1.37 ===
  73 * …
  74
  75 === External library changes in 1.37 ===
  76 * …
  77
  78 ==== New external libraries ====
  79 * Added whatwg-fetch 3.6.2.
  80 * Added wikimedia/normalized-exception 1.0.1.
  81 * …
  82
  83 ===== New development-only external libraries =====
  84 * …
  85
  86 ==== Changed external libraries ====
  87 * Updated OOjs from v5.0.0 to v6.0.0
  88 * Updated OOUI from v0.41.3 to v0.42.0
  89 * Updated WVUI from v0.1.0 to v0.3.0
  90 * Updated cssjanus/cssjanus from v1.3.0 to v2.0.0.
  91 * Updated psr/container from v1.0.0 to v1.1.1.
  92 * Updated wikimedia/minify from v2.2.2 to v2.2.4.
  93 * Updated wikimedia/object-factory from v3.0.0 to v3.0.2.
  94 * Updated wikimedia/parsoid from v0.13.0-a20 to v0.14.0-a1.
  95 * Updated wikimedia/relpath from v2.1.1 to v3.0.0.
  96 * Updated wikimedia/remex-html from v2.3.1 to v2.3.2.
  97 * Updated wikimedia/shellbox from v1.0.4 to v2.0.0.
  98 * Updated wikimedia/wait-condition-loop from v2.0.1 to v2.0.2.
  99 * …
 100
 101 ===== Changed development-only external libraries =====
 102 * Updated qunit from 2.10.0 to 2.16.0.
 103 * …
 104
 105 ==== Removed external libraries ====
 106 * The pimple/pimple development-only library has been removed.
 107 * …
 108
 109 === Bug fixes in 1.37 ===
 110 * …
 111
 112 === Action API changes in 1.37 ===
 113 * …
 114
 115 === Action API internal changes in 1.37 ===
 116 * …
 117
 118 === Languages updated in 1.37 ===
 119 MediaWiki supports over 350 languages. Many localisations are updated regularly.
 120 Below only new and removed languages are listed, as well as changes to languages
 121 because of Phabricator reports.
 122
 123 * (T280435) LRM and RLM characters were removed from names of languages with
 124   parentheses in Names.php
 125 * (T283422) Add namespace name translations and change the autonym of
 126   the Kinyarwanda language to "Ikinyarwanda".
 127 * (T283423) Change the autonym of the Lombard language from "lumbaart"
 128   to "lombard".
 129 * (T279619) Added language support for Dagbani (dag).
 130 * (T282085) Added language support for Malay in Arabic (Jawi) script (ms-arab).
 131 * (T283053) Added language support for Ojibwe (ojb).
 132 * (T283480) Added language support for Wallisian (wls, Fakaʻuvea).
 133 * (T284002) Added language support for Paiwan (pwn).
 134 * (T284044) Added language support for Carpathian Romani (rmc).
 135 * (T286460) Added language support for Gun (guw, Gungbe).
 136 * (T287345) Added language support for Baoulé (bci).
 137
 138 === Breaking changes in 1.37 ===
 139 * The Revision class, hard deprecated in 1.35, was removed entirely. As
 140   part of this, the following hooks that included a Revision object
 141   were removed:
 142   - ArticleRevisionUndeleted - use RevisionUndeleted
 143   - ArticleRollbackComplete - use RollbackComplete
 144   - DiffRevisionTools - use DiffTools
 145   - DiffViewHeader - use DifferenceEngineViewHeader
 146   - HistoryRevisionTools - use HistoryTools
 147   - NewRevisionFromEditComplete - use RevisionFromEditComplete
 148   - PageContentInsertComplete - use PageSaveComplete
 149   - PageContentSaveComplete - use PageSaveComplete
 150   - ParserFetchTemplate - use BeforeParserFetchTemplateRevisionRecord
 151   - RevisionInsertComplete - use RevisionRecordInserted
 152   - TitleMoveComplete - use PageMoveComplete
 153   - TitleMoveCompleting - use PageMoveCompleting
 154   - UndeleteShowRevision - no replacement
 155   - UserRetrieveNewTalks - no replacement
 156   and the following methods and variables have been removed
 157   - Article::$mRevision
 158   - Article::getRevisionFetched()
 159   - ContribsPager::tryToCreateValidRevision()
 160   - EditPage::$mBaseRevision
 161   - EditPage::getBaseRevision()
 162   - LinksUpdate::getRevision()
 163   - LinksUpdate::setRevision()
 164   - PageArchive::getArchivedRevision()
 165   - PageArchive::getPreviousRevision()
 166   - PageArchive::getRevision()
 167   - Parser::$mRevisionObject
 168   - Parser::fetchCurrentRevisionOfTitle()
 169   - Parser::getRevisionObject()
 170   - Parser::statelessFetchRevision()
 171   - ParserOptions::getCurrentRevisionCallback()
 172   - ParserOptions::setCurrentRevisionCallback()
 173   - Title::countAuthorsBetween()
 174   - Title::getFirstRevision()
 175   - User::getNewMessageLinks()
 176   - User::getNewMessageRevisionId()
 177   - User::setNewtalk()
 178   - WikiPage::getOldestRevision()
 179   - WikiPage::getRevision()
 180   - WikiPage::getUndoContent()
 181   - WikiPage::updateIfNewerOn()
 182   and the following methods no longer accept Revision objects as parameters:
 183   - CategoryMembershipChange::__construct()
 184   - ContentHandler::getUndoContent()
 185   - DerivedPageDataUpdater::prepareUpdate()
 186   - DifferenceEngine::getRevisionHeader()
 187   - Linker::buildRollbackLink()
 188   - Linker::generateRollback()
 189   - Linker::getRevDeleteLink()
 190   - Linker::getRollbackEditCount()
 191   - Linker::revComment()
 192   - Linker::revUserLink()
 193   - Linker::revUserTools()
 194   - WikiPage::doDeleteUpdates()
 195   - WikiPage::doEditUpdates()
 196   - WikiPage::hasDifferencesOutsideMainSlot()
 197   - WikiPage::onArticleEdit()
 198   - WikiPage::prepareContentForEdit()
 199   - WikiPage::updateRevisionOn()
 200   The following methods return arrays that formerly included a 'revision'
 201   key that would emit deprecation warnings when accessed and return a
 202   Revision object. The Revision object has been removed from the arrays,
 203   and the 'revision-record' key should be used to get the relevant
 204   RevisionRecord instead:
 205   - PageUpdater::doCreate()
 206   - PageUpdater::doModify()
 207   - Parser::statelessFetchTemplate()
 208   - WikiPage::doEditContent()
 209   The ParserOptions `templateCallback` option is a callback that is called
 210   in Parser::fetchTemplateAndTitle() and should return an array - the
 211   'revision' key to that array used to be a Revision object and was used if
 212   no 'revision-record' was returned - it is now ignored.
 213 * Previously, the classes RevisionTestModifyableContent and
 214   RevisionTestModifyableContentHandler were loaded for use in tests, but
 215   were only used within the tests for the since-removed Revision class. This
 216   content and content handler class were removed without deprecation.
 217 * WANObjectCache::HOLDOFF_NONE, deprecated since 1.35, was removed.
 218   Use HOLDOFF_TTL_NONE instead.
 219 * ResourceLoader::makeVersionQuery without $modules parameter, deprecated
 220   since 1.34, is no longer supported.
 221 * LocalFile::recordUpload2(), deprecated since 1.35, was removed.
 222 * The following methods and fields in the Language class, deprecated since
 223   1.35, have been removed:
 224    - classFromCode()
 225    - clearCaches()
 226    - convertTitle()
 227    - findVariantLink()
 228    - mConverter
 229    - updateConversionTable()
 230 * The following methods in the Parser class have been removed after having
 231   been deprecated in 1.35:
 232    - fetchTemplate()
 233    - Title()
 234 * (T273354) When an edit is prevented by an 'EditFilterMergedContent' hook
 235   handler without changing the status, the edit form will now be displayed.
 236 * User::clearNotification() which had been deprecated in 1.35 has been removed.
 237   Use WatchlistManager::clearTitleUserNotification() instead.
 238 * User::getNewtalk() which had been deprecated in 1.35 has been removed. Use
 239   TalkPageNotificationManager::userHasNewMessages() instead.
 240 * Autopromote class, deprecated since 1.35, was removed. Use
 241   UserGroupManager instead.
 242 * The following classes, hard-deprecated since 1.36, have been removed:
 243   CachedAction, SpecialCachedPage, CacheHelper, ICacheHelper.
 244 * The hooks BeforeHttpsRedirect, CanIPUseHTTPS and UserRequiresHTTPS, deprecated
 245   in 1.35, were removed.
 246 * The TitleArrayFromResult hook, deprecated in 1.36, was removed.
 247 * The deprecated "es6-promise" alias ResourceLoader module has been removed. Use
 248   "es6-polyfills" directly intead.
 249 * The deprecated "mediawiki.legacy.protect" ResourceLoader module, deprecated
 250   since 1.36, has been removed. Use "mediawiki.action.protect" instead.
 251 * AuthenticationProvider interface doesn't extend LoggerAwareInterface.
 252   So AuthenticationProvider can't be typehinted as LoggerAwareInterface.
 253 * User::getGrantName(), hard deprecated since 1.36, has been removed.
 254   Use MWGrants::grantName instead.
 255 * SessionProvider class doesn't extend LoggerAwareInterface.
 256   So SessionProvider can't be typehinted as LoggerAwareInterface.
 257 * The following ApiBase methods, deprecated since 1.35, have been removed:
 258   - ApiBase::explodeMultiValue
 259   - ApiBase::parseMultiValue
 260   - ApiBase::validateLimit
 261   - ApiBase::validateTimestamp
 262 * User::idCacheByName public static field was removed without deprecation.
 263   instead of using it, get a UserIdentity by name from UserIdentityLookup.
 264 * IDatabase::upsert() and IDatabase::replace() only accept a single unique key.
 265   Previously, a warning was issued if there were multiple unique keys provided.
 266 * The MediaWiki:Autoblock_whitelist block exemption control was moved in 1.36 to
 267   MediaWiki:Block-autoblock-exemptionlist. The backward-compatibility of reading
 268   the old MediaWiki:Autoblock_whitelist page has now been dropped.
 269 * The following overridable methods in File hierarchy has changed signatures:
 270   - File::deleteFile - now accepts UserIdentity instead of User
 271   - File::getDescription - now accepts Authority instead of User
 272   - File::userCan - now accepts Authority instead of User
 273   - LocalFile::deleteOldFile - now accepts UserIdentity instead of User
 274 * The following global methods, each deprecated since 1.36, have been removed:
 275   - wfAppendToArrayIfNotDefault
 276   - wfAcceptToPrefs
 277   - wfConfiguredReadOnlyReason
 278   - wfDebugMem
 279   - wfGetPrecompiledData
 280   - wfNegotiateType
 281 * The following deprecated methods of Title class have been removed:
 282   - nameOf, deprecated in 1.36
 283   - getPreviousRevisionID, deprecated in 1.34
 284   - getNextRevisionID, deprecated in 1.34
 285   - getEarliestRevTime, deprecated in 1.35
 286 * UploadBase::stashFile, deprecated since 1.28, was removed.
 287 * wfGetRusage(), deprecated since 1.35, has been removed.
 288 * The following CLI options were removed from tests/phpunit.php:
 289   - use-filebackend
 290   - use-jobqueue
 291   - use-bagostuff
 292   The following options (inherited from Maintenance) were also removed:
 293   - conf
 294   - dbuser
 295   - dbpass
 296   - dbdefaultgroup
 297   - globals
 298   - memory-limit
 299   - profiler
 300   - server
 301   The following options were changed to environment variables:
 302   - wiki => PHPUNIT_WIKI
 303   - use-normal-tables => PHPUNIT_USE_NORMAL_TABLES
 304   - use-filebackend => PHPUNIT_USE_FILEBACKEND
 305   - use-bagostuff => PHPUNIT_USE_BAGOSTUFF
 306   - use-jobqueue => PHPUNIT_USE_JOBQUEUE
 307   This is so that we can use the default PHPUnit entry point (T90875).
 308 * The PHPUNIT_REUSE_DB / --reuse-db option was removed from the phpunit.php
 309   runner. It had been broken for at least three years already. The original use
 310   case was speeding up tests on Oracle, but Oracle support was dropped several
 311   releases ago.
 312 * EntryPoint::getTextFormatters() was made private without a deprecation period;
 313   it had no known external callers.
 314 * DatabaseBlock::chooseBlock, deprecated since 1.35, was removed.
 315 * SpecialPageFactory::getRestrictedPages, deprecated since 1.36, was removed.
 316 * SpecialBlock::validateTarget, deprecated since 1.36, was removed.
 317 * The PatchFileLocation trait was removed without deprecation.
 318 * ActorMigrationBase::getExistingActorId and ::getNewActorId, hard deprecated
 319   since 1.36, were removed.
 320 * Hook handlers implementing MediaWikiServicesHook are prohibited from having
 321   services injected. This is because by definition, this hook runs before the
 322   service container is fully initialized.
 323 * The protected property LocalFile::$metadata was removed without deprecation.
 324 * WatchedItem::getUser, hard deprecated since 1.36, has been removed.
 325 * AuthManager::singleton, hard deprecated since 1.36, has been removed.
 326 * The AugmentPageProps class was removed without deprecation. It had no known
 327   uses.
 328 * Html::infobox, deprecated since 1.36, was removed.
 329 * ParserOptions::__construct() now requires that the first parameter is a
 330   UserIdentity object - passing `null` used to fallback to the global
 331   $wgUser but was deprecated since 1.36.
 332 * ParserOptions::newCanonical() no longer supports the first parameter being
 333   null (or omitted entirely), which would fallback to the global $wgUser but
 334   was deprecated since 1.35.
 335 * The SkinTemplatePreventOtherActiveTabs hook, deprecated in 1.35, was removed
 336   entirely.
 337 * The SkinTemplateTabAction hook, deprecated in 1.35, was removed entirely.
 338 * The SkinTemplateBuildNavUrlsNav_urlsAfterPermalink hook, deprecated in 1.35,
 339   was removed entirely.
 340 * The SkinTemplateToolboxEndHook, deprecated in 1.35, was removed entirely.
 341 * The following methods of RevisionStore class, formerly hard deprecated,
 342   were removed:
 343   - ::newMutableRevisionFromArray,
 344   - ::loadRevisionFromPageId,
 345   - ::loadRevisionFromTitle,
 346   - ::loadRevisionFromTimestamp,
 347   - ::listRevisionSizes
 348 * LogEntry::getPerformer, deprecated since 1.36, was removed along with methods
 349   in subclasses: DatabaseLogEntry, ManualLogEntry, RCDatabaseLogEntry.
 350 * Skin::getRelevantUser now returns an instance of UserIdentity, not necessarily
 351   a User object. There is no known usages in MediaWiki ecosystem that were not
 352   satisfied with UserIdentity.
 353 * Direct construction of MergeHistory class, deprecated since 1.35, is no longer
 354   supported. Use MergeHistoryFactory instead. MergeHistory::checkPermissions,
 355   deprecated since 1.36, was removed.
 356 * Skin::generateDebugHTML(), deprecated since 1.35, was removed. Call
 357   MWDebug::getHTMLDebugLog() directly.
 358 * The ApiTestCase class no longer interacts with the global $wgUser.
 359   Previously, the global variable was set at the start of each test, and in
 360   ApiTestCase::doApiRequest() if a performer was specified $wgUser was
 361   updated to match, and if no performer was specified $wgUser was used
 362   instead. Now, $wgUser is not updated, and if no performer is specified
 363   the reusable TestUser object for the sysop is relied on. Extensions
 364   or skins that rely on the global $wgUser variable (which has been
 365   deprecated since 1.35) should instead retrieve the acting user from the
 366   relevant context source.
 367 * SkinTemplate::makeArticleUrlDetails, deprecated since 1.35, was removed.
 368 * Skin::makeNSUrl, deprecated since 1.35, was removed.
 369 * Skin::getRevisionId(), deprecated since 1.34, was removed. Use
 370   OutputPage::getRevisionId() instead.
 371 * Skin::isRevisionCurrent(), deprecated since 1.34, was removed. Use
 372   OutputPage::isRevisionCurrent() instead.
 373 * AbstractBlock::parseTarget(), deprecated since 1.36, was removed.
 374 * ArticleEditUpdates hook, deprecated since 1.35, was removed.
 375 * @stable to extend class CentralIdLookup has following changes:
 376   - Protected ::checkAudience method now returns Authority instead of User.
 377   - A number of it's @stable to override methods now accept Authority instead
 378     of User as $audience parameter.
 379   - A number of methods now accept UserIdentity instead of User parameter.
 380   - ::localUserFromCentralId method now returns UserIdentity and not necessarily
 381     a User object.
 382   All extensions that extend this class or use this method were updated to be
 383   ready to the new behavior.
 384 * WatchedItemStoreInterface::enqueueWatchlistExpiryJob, deprecated since 1.36,
 385   was removed.
 386 * ResultWrapper is now abstract. It cannot be directly constructed (T286694).
 387 * The SecondaryDataUpdates hook, deprecated in 1.32, was removed entirely.
 388 * Content::getDeletionUpdates(), was removed. Use
 389   ContentHandler::getDeletionUpdates() instead.
 390 * Content::getSecondaryDataUpdates(), was removed. Use
 391   ContentHandler::getSecondaryDataUpdates() instead.
 392 * wfDiff(), deprecated since 1.25, has been removed.
 393 * Language::$mLangObjCache, deprecated since 1.35, was removed.
 394 * Language::$transformData, deprecated since 1.35, was removed.
 395 * Language::transformUsingPairFile() was marked @internal. Its deprecated
 396   parameters are no longer supported.
 397 * SpecialMute::getTarget(), unused outside of the SpecialMute class, was
 398   made private.
 399 * The Skin::setupSkinUserCss method deprecated in 1.32, was removed. Please use
 400   skin registration instead.
 401 * The ResourceLoaderSkinModule `legacy`, `content` and `content-thumbnails`
 402   features were deprecated. Skins should instead select from the features
 403   listed on [[mw:Manual:ResourceLoaderSkinModule]].
 404 * ParserCache::getKey and ::getEtag, deprecated since 1.36, were removed.
 405 * The BaseTemplateToolbox hook, deprecated since 1.35, was removed.
 406 * Previously a capitalize-all-nouns class was added to the body element of
 407   languages where nouns must be capitalized. This class is no longer added to
 408   the body tag and must be provided by skins.
 409 * The SkinTemplateOutputPageBeforeExec hook, deprecated since 1.35, was removed.
 410 * Article::getContentObject, deprecated since 1.32, was removed.
 411 * Article::delete(), Article::confirmDelete() and ImagePage::delete() were
 412   hard-deprecated. The logic responsible for building the form is being moved to
 413   DeleteAction, while the actual deletion logic will be moved to a separate
 414   service.
 415 * WikiImporter::debugRevisionHandler, unused and for debug only, was removed.
 416 * Content::preloadTransform was hard-deprecated since 1.37,
 417   use ContentTransformer::preloadTransform instead. Extensions defining
 418   a content model should override ContentHandler::preloadTransform.
 419 * Content::preSaveTransform was hard-deprecated since 1.37,
 420   use ContentTransformer::preSaveTransform instead. Extensions defining
 421   a content model should override ContentHandler::preSaveTransform.
 422 * …
 423
 424 === Deprecations in 1.37 ===
 425 * JobQueue::getWiki, deprecated in 1.33, now emits deprecation warnings.
 426 * In AbstractBlock, the getTargetAndType() and getTarget() methods are
 427   hard deprecated. Instead use getTargetName() and getTargetUserIdentity()
 428   together with getType().
 429 * Deprecated passing UserIdentity to
 430   WatchlistManager::clearAllUserNotifications() and
 431   WatchlistManager::clearTitleUserNotifications(). Pass Authority instead.
 432 * Deprecated passing LinkTarget to
 433   WatchlistManager::clearTitleUserNotifications() and
 434   WatchlistManager::getTitleNotificationTimestamp(). Pass PageIdentity instead.
 435 * Deprecated User::isWatched(), User::isTempWatched(), User::addWatch(), and
 436   User::removeWatch(). Use corresponding methods in WatchlistManager instead.
 437 * Deprecated WatchAction::doWatchOrUnwatch(). Use WatchlistManager::setWatch()
 438   instead.
 439 * Deprecated WatchAction::doWatch() and WatchAction::doUnwatch(). Use
 440   WatchlistManager::addWatch() or WatchlistManager::removeWatch(), instead.
 441 * WatchAction::getWatchToken is hard deprecated. Instead use
 442   CsrfTokenSet::getToken
 443 * Action::getHookContainer() has been marked as internal. Actions that require
 444   access to a hook container should have one injected instead.
 445 * The getTitle() and setTitle() methods in Parser have been deprecated.
 446   Use getPage() and setPage() instead.
 447 * Title::isWatchable() has been deprecated. Use WatchlistManager::isWatchable()
 448   instead.
 449 * Methods and classes related to the primary database, previously referred to as
 450   'master', have been deprecated, with the new ones replacing them as follows:
 451   - The DBMasterPos and MySQLMasterPos classes have been respectively renamed to
 452     DBPrimaryPos and MySQLPrimaryPos.
 453   - LocalRepo::getMasterDB() -> ::getPrimaryDB()
 454   - ForeignDBRepo::getMasterDB() -> ::getPrimaryDB()
 455   - JobQueueDB::getMasterDB() -> ::getPrimaryDB()
 456   - ForeignDBViaLBRepo::getMasterDB() -> ::getPrimaryDB()
 457   - DBFileJournal::getMasterDB() -> ::getPrimaryDB()
 458   - ILoadBalancer::getMasterPos() -> ::getPrimaryPos()
 459   - IDatabase::getMasterPos() -> ::getPrimaryPos()
 460   - ILoadBalancer::finalizeMasterChanges() -> ::finalizePrimaryChanges()
 461   - ILoadBalancer::approveMasterChanges() -> ::approvePrimaryChanges()
 462   - ILoadBalancer::beginMasterChanges() -> ::beginPrimaryChanges()
 463   - ILBFactory::beginMasterChanges() -> ::beginPrimaryChanges()
 464 * wfIncrStats(), deprecated in 1.36, now emits deprecation warnings.
 465 * wfCanIPUseHTTPS() is now deprecated, and always returns true.
 466 * The UserLoadFromDatabase hook has been deprecated. It had no known uses.
 467 * AbstractAuthenticationProvider ::setLogger(), ::setManager(), ::setConfig(),
 468   ::setHookContainer() were soft deprecated. Use ::init() to inject
 469   dependencies or override ::postInitSetup() to do any custom
 470   post-initialization configuration.
 471 * The following methods in ApiPageSet have been deprecated:
 472    - getTitles(), use getTargets() instead.
 473    - getGoodTitles(), use getGoodPages() instead.
 474    - getMissingTitles(), use getMissingPages() instead.
 475    - getGoodAndMissingTitles(), use getGoodAndMissingPages() instead.
 476    - getRedirectTitles(), use getRedirectTargets() instead.
 477    - getSpecialTitles(), use getSpecialPages() instead.
 478 * The following functions from the User class, deprecated in 1.35, now emit
 479   deprecation warnings:
 480    - getOptions
 481    - isIP
 482    - isUsableName
 483    - isCreatableName
 484    - getCanonicalName
 485    - addAutopromoteOnceGroups
 486    - getEffectiveGroups
 487    - getAutomaticGroups
 488    - getFormerGroups
 489    - getIntOption
 490 * The following methods in User were deprecated:
 491   - ::idFromName - use UserIdentityLookup::getUserIdentityByName instead.
 492   - ::resetIdByNameCache - in tests, reset service container. No replacement
 493     needed in production code.
 494 * Use of ActorMigration for any table except revision, deprecated in 1.34, now
 495   emits deprecation warnings. Instead of getInsertValues(), use
 496   ActorNormalization::acquireActorId(). Instead of getWhere() and getJoin(),
 497   do your own join on the actor table.
 498 * DatabasePostgres::remappedTableName() and its dependent constructor parameter
 499   'keywordTableMap' are deprecated. Reserved identifiers that are used as table
 500   names should be quoted where necessary.
 501 * LinkCache::singleton(), deprecated since 1.28, now emits deprecation warnings.
 502 * MessageCache::singleton(), deprecated since 1.34, now emits deprecation
 503   warnings.
 504 * LockManagerGroup::singleton() and ::destroySingletons(), deprecated since
 505   1.34, now emit deprecation warnings.
 506 * HtmlFileCacheUpdate::newFromTitles() is now deprecated and emitting warnings.
 507   Use newFromPages() instead.
 508 * SessionProvider ::setLogger(), ::setManager(), ::setConfig(),
 509   ::setHookContainer() were soft deprecated. Use ::init() to inject
 510   dependencies or override ::postInitSetup() to do any custom
 511   post-initialization configuration.
 512 * User->isLoggedIn(), deprecated since 1.36, now emits deprecation warnings. Use
 513   the method it wraps, User->isRegistered(), instead.
 514 * FileBackendGroup::singleton() and ::destroySingletons(), deprecated since
 515   1.35, now emit deprecation warnings.
 516 * The first parameter of User::getBlock should now be an integer using the
 517   Authority::FOR_XXX constants. Providing a boolean is deprecated.
 518 * ApiBase::addBlockInfoToStatus() is deprecated for use by extensions. It is now
 519   marked as @internal and may be deleted in the future.
 520   It should not be necessary to call this method, Authority should be providing
 521   all relevant information via a PermissionStatus object.
 522 * JobQueueGroup::singleton was deprecated - use
 523   MediaWikiServices::getJobQueueGroup instead.
 524 * JobQueueGroup::destroySingletons was deprecated. JobQueueGroups are now
 525   automatically destroyed after tests.
 526 * SessionProvider ::setLogger(), ::setManager(), ::setConfig(),
 527   ::setHookContainer() were hard deprecated. Use ::init() to inject
 528   dependencies or override ::postInitSetup() to do any custom
 529   post-initialization configuration.
 530 * ContentHandler::getContentText() is now soft deprecated.
 531   Use Content::getText() instead.
 532 * MediaWiki\User\UserNamePrefixSearch::search() previously accepted as
 533   its first parameter either the string 'public' or a UserIdentity object,
 534   to filter results for. It now expects an Authority object instead of
 535   UserIdentity, and providing just a UserIdentity is hard deprecated.
 536 * wfLocalFile(), deprecated since 1.34, now emits deprecation warnings.
 537 * wfFindFile(), deprecated since 1.34, now emits deprecation warnings.
 538 * User::getRights(), deprecated since 1.34, now emits deprecation warnings.
 539 * User::changeableGroups and ::changeableByGroup were hard deprecated, use
 540   corresponding methods in UserGroupManager instead.
 541 * User::incEditCount() was deprecated in favor of the new method
 542   UserEditTracker::incrementUserEditCount().
 543 * RepoGroup::singleton(), ::destroySingleton() and ::setSingleton(),
 544   deprecated since 1.34, now emit deprecation warnings.
 545 * AbstractAuthenticationProvider ::setLogger(), ::setManager(), ::setConfig(),
 546   ::setHookContainer() were hard deprecated. Use ::init() to inject
 547   dependencies or override ::postInitSetup() to do any custom
 548   post-initialization configuration.
 549 * RecentChange::getPerformer(), hard-deprecated since 1.37,
 550   use getPerformerIdentity() instead.
 551 * ContentHandler::cleanupHandlersCache(), deprecated since 1.35, now emits
 552   deprecation warnings.
 553 * File::getUser method was hard deprecated, along with overrides in LocalFile
 554   and ForeignApiFile in favor of ::getUploader.
 555 * SpecialBlock::checkUnblockSelf(), deprecated in 1.36, now emits deprecation
 556   warnings.
 557 * (T284179) The mediawiki.viewport ResourceLoader module is deprecated. You can
 558   now just use MutationObserver or InterSectionObserver directly, which are
 559   widely available in all supported JavaScript browsers.
 560 * The following constructor options of DatabaseBlock class,
 561   hard deprecated since 1.37:
 562   - 'byText' property with blocker's name,
 563     use 'by' property with UserIdentity value instead.
 564   - 'by' property with blocker's ID,
 565     use 'by' property with UserIdentity value instead.
 566 * The BeforeResetNotificationTimestamp hook was deprecated.
 567 * ArchivedFile::getUser, ::getRawUser, ::getRawUserText were deprecated in
 568   favor of ::getUploader. ::getRawDescription was deprecated in favor of
 569   ::getDescription with RAW audience parameter.
 570 * When calling LocalFile::newFromRow() or LocalFile::loadFromRow(), passing
 571   extra fields not requested by ::getQueryInfo() is hard deprecated. This is
 572   to warn callers that deprefixing and automatic assignment of such fields will
 573   not be done in a future version.
 574 * JobSpecification::getTitle was deprecated without providing a replacement.
 575   It wasn't used and job given the purpose of JobSpecification class it's
 576   not needed.
 577 * The protected method File::getImageSize() is deprecated.
 578 * MediaHandler::getImageSize(), ::getMetadata() and ::isMetadataValid were
 579   deprecated and should no longer be overridden. Instead, subclasses should
 580   override getSizeAndMetadata().
 581 * Deprecated File::getMetadata(). Instead use ::getMetadataArray(),
 582   ::getMetadataItem() and ::getMetadataItems().
 583 * Message::title was deprecated, use Message::page instead.
 584 * BaseTemplate::getAfterPortlet, BaseTemplate::renderAfterPortlet and the
 585   BaseTemplateAfterPortlet hook, which were deprecated in 1.35,
 586   now emit deprecation warnings.
 587 * LocalFile::getHistory hook is deprecated.
 588 * Calling WikiPage::prepareContentForEdit() without a UserIdentity is now
 589   deprecated.
 590 * User::getEditTokenObject, ::getEditToken, ::matchEditToken were deprecated.
 591   Use CsrfTokenRepository, which is available via IContextSource, instead.
 592   ::matchEditTokenNoSuffix was deprecated without replacement.
 593   It was introduced to be able to provide custom error message if the token
 594   was submitted, but ending slashes were stripped by some ASCII mangling proxy.
 595   Use matchToken instead, such proxies are much less common now and there's
 596   not much benefit in customising the error message.
 597 * ContentHandler::getForTitle(), deprecated since 1.35, now emits
 598   deprecation warnings.
 599 * User::listOptionKinds(), deprecated since 1.35, now emits deprecation
 600   warnings.
 601 * WikiPage::doEditContent(), deprecated since 1.32, now emits deprecation
 602   warnings.
 603 * CentralIdLookup::factory and ::factoryNonLocal were deprecated, obtain an
 604   instance from MediaWikiServices instead.
 605 * BotPassword::invalidateAllPasswordsForCentralId() was deprecated.
 606 * BotPassword::removeAllPasswordsForCentralId() was deprecated.
 607 * The Title class members: $mTextform, $mUrlform, $mDbkeyform, $mNamespace,
 608   $mInterwiki, and $mFragment have been deprecated to not be used directly.
 609   Instead, their corresponding accessor methods should be used.
 610 * IDatabase::fetchObject(), ::fetchRow(), ::numRows(), ::numFields(),
 611   ::fieldName(), ::freeResult() and ::dataSeek() are deprecated. Use the
 612   corresponding methods in IResultWrapper instead.
 613 * ResultWrapper::unwrap(), DatabaseMysqlBase::fieldType() and
 614   DatabasePostgres::fieldType() are hard-deprecated.
 615 * Subclasses implementing Database::doQuery() should return either boolean or
 616   an IResultWrapper. To do otherwise is hard-deprecated.
 617 * User::getOptionKinds() and ::resetOptions(), both deprecated since 1.35,
 618   now emit deprecation warnings.
 619 * wfGetLB(), deprecated since 1.27, now emits deprecation warnings.
 620 * The following methods in MWNamespace, all deprecated since 1.34, now emit
 621   deprecation warnings:
 622   - isMovable()
 623   - isSubject()
 624   - getTalk()
 625   - getSubject()
 626   - getAssociated()
 627   - equals()
 628   - subjectEquals()
 629   - hasTalkNamespace()
 630   - wantSignatures()
 631   - isWatchable()
 632   - getSubjectNamespaces()
 633   - getTalkNamespaces()
 634   - isCapitalized()
 635   - hasGenderDistinction()
 636   - isNonincludable()
 637   - getNamespaceContentModel()
 638   - getRestrictionLevels()
 639   - getCategoryLinkType()
 640 * LogFormatter::styleRestricedElement() has been deprecated in favor of
 641   LogFormatter::styleRestrictedElement()
 642 * The following hooks were deprecated:
 643   - UserLoadOptions: use LoadUserOptions instead.
 644   - UserSaveOptions: use SaveUserOptions instead.
 645   - UserResetAllOptions: no replacement was provided, the hook is not used.
 646 * Title::isNamespaceProtected, deprecated in 1.34, is now hard-deprecated.
 647 * UserSelectQueryBuilder::userIds(), ::userNames(), and ::userNamePrefix()
 648   has been deprecated in favor of ::whereUserIds(), ::whereUserNames(),
 649   and ::whereUserNamePrefix()
 650 * Manually constructing a MovePage object, deprecated in 1.34,
 651   is now hard deprecated. Use MovePageFactory instead.
 652 * userCan hook has been deprecated. Use getUserPermissionsErrors or
 653   getUserPermissionsErrorsExpensive instead.
 654 * Parser::mUser public access, Parser::getUser and ParserOptions::getUser were
 655   hard deprecated.
 656 * The following methods in the Title class have been deprecated in favor of the
 657   corresponding methods in the new RestrictionStore service (with different
 658   names where indicated):
 659   - areCascadeProtectionSourcesLoaded()
 660   - areRestrictionsCascading()
 661   - areRestrictionsLoaded()
 662   - getAllRestrictions()
 663   - getCascadeProtectionSources()
 664   - getFilteredRestrictionTypes()
 665       -> listAllRestrictionTypes()
 666   - getRestrictionExpiry()
 667   - getRestrictionTypes()
 668       -> listApplicableRestrictionTypes()
 669   - getRestrictions()
 670   - isCascadeProtected()
 671   - isProtected()
 672   - isSemiProtected()
 673   - loadRestrictionsFromRows()
 674 * The following Title methods have been deprecated with no direct public
 675   replacement:
 676   - deleteTitleProtection()
 677   - getTitleProtection()
 678   - flushRestrictions()
 679   - loadRestrictions()
 680 * User::isAllowUsertalk was hard deprecated. Use User::getBlock and
 681   AbstractBlock::isUsertalkEditAllowed instead.
 682 * …
 683
 684 === Other changes in 1.37 ===
 685 * WatchlistManager::addWatch and WatchlistManager::addWatchIgnoringRights(),
 686   which replace User::addWatch(), now call the WatchArticle and
 687   WatchArticleComplete hooks.
 688 * WatchlistManager::removeWatch and
 689   WatchlistManager::removeWatchIgnoringRights(), which replace
 690   User::removeWatch(), now call the UnwatchArticle and UnwatchArticleComplete
 691   hooks.
 692 * The overridable postInitSetup() method was added to the
 693   AbstractAuthenticationProvider class. A provider can override postInitSetup()
 694   to do any custom post-initialization configuration.
 695 * The overridable postInitSetup() method was added to the SessionProvider
 696   class. A provider can override postInitSetup() to do any custom
 697   post-initialization configuration.
 698 * The protected getConfig() method was added to the SessionProvider class.
 699   Use SessionProvider::getConfig to get a config.
 700 * The DBAccessBase class is deprecated. Classes that used to extend it
 701   should get a load balancer (factory) injected in the constructor instead.
 702 * ActorNormalization::acquireActorId now requires IDatabase parameter.
 703   Not providing one emitted deprecation warnings since 1.36.
 704 * Anti-lock constants ALF_PRELOAD_LINK, ALF_NO_BLOCK_LOCK, ALF_NO_LINK_LOCK
 705   and ALF_PRELOAD_EXISTENCE have been removed. They're unused since 1.25.
 706 * CSS class 'mw-htmlform-field-autoinfuse' used by some forms has been
 707   renamed to 'mw-htmlform-autoinfuse'. (T278036)
 708 * User::newFromRow does not accept pre-loaded user preferences under
 709   $data['user_properties'] anymore. This optimization was not used.
 710 * …
 711
 712 == Compatibility ==
 713
 714 MediaWiki 1.37 requires PHP 7.3.19 or later and the following PHP extensions:
 715
 716 * ctype
 717 * dom
 718 * fileinfo
 719 * iconv
 720 * intl
 721 * json
 722 * mbstring
 723 * xml
 724
 725 MySQL/MariaDB is the recommended DBMS. PostgreSQL or SQLite can also be used,
 726 but support for them is somewhat less mature.
 727
 728 The supported versions are:
 729
 730 * MySQL 5.5.8 or later
 731 * PostgreSQL 9.4 or later
 732 * SQLite 3.8.0 or later
 733
 734 == Online documentation ==
 735 Documentation for both end-users and site administrators is available on
 736 MediaWiki.org, and is covered under the GNU Free Documentation License (except
 737 for pages that explicitly state that their contents are in the public domain):
 738
 739        https://www.mediawiki.org/wiki/Special:MyLanguage/Documentation
 740
 741 == Mailing list ==
 742 A mailing list is available for MediaWiki user support and discussion:
 743
 744        https://lists.wikimedia.org/mailman/listinfo/mediawiki-l
 745
 746 A low-traffic announcements-only list is also available:
 747
 748        https://lists.wikimedia.org/mailman/listinfo/mediawiki-announce
 749
 750 It's highly recommended that you sign up for one of these lists if you're
 751 going to run a public MediaWiki, so you can be notified of security fixes.
 752
 753 == IRC help ==
 754 There's usually someone online in #mediawiki on irc.libera.chat.