3 == MediaWiki 1.37.0-PRERELEASE ==
5 THIS IS NOT A RELEASE YET
7 MediaWiki 1.37 is an alpha-quality development branch, and is not recommended
10 == Upgrading notes for 1.37 ==
11 Don't forget to always back up your database before upgrading!
13 See the file UPGRADE for more detailed per-version upgrade instructions from the
14 oldest supported upgrading version, MediaWiki 1.27.
16 Some specific notes for MediaWiki 1.37 upgrades are below:
19 For notes on 1.36.x and older releases, see HISTORY.
21 === Configuration changes for system administrators in 1.37 ===
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.
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 where 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
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.
56 ==== Removed configuration ====
57 * $wgLegacyJavaScriptGlobals, deprecated in 1.36.
58 * $wgShowDBErrorBacktrace, deprecated and non-functional since 1.32.
59 * $wgShowSQLErrors, deprecated and non-functional since 1.32.
60 * $wgLangObjCacheSize - The LanguageFactory service now always retains
61 at most 10 objects in its LRU-cache.
62 * (T274695) $wgAjaxEditStash, deprecated in 1.36.
65 === New user-facing features in 1.37 ===
66 * (T161934) MediaWiki now supports JPEG2000 files, to a limited extent.
67 * Media files uploaded server side using the importImages.php maintenance
68 script now have the "mw-server-side-upload" change tag.
71 === New developer features in 1.37 ===
74 === External library changes in 1.37 ===
77 ==== New external libraries ====
78 * Added whatwg-fetch 3.6.2.
79 * Added wikimedia/normalized-exception 1.0.1.
82 ===== New development-only external libraries =====
85 ==== Changed external libraries ====
86 * Updated OOjs from v5.0.0 to v6.0.0
87 * Updated WVUI from v0.1.0 to v0.2.0
88 * Updated psr/container from v1.0.0 to v1.1.1.
89 * Updated wikimedia/minify from v2.2.2 to v2.2.4.
90 * Updated wikimedia/object-factory from v3.0.0 to v3.0.2.
91 * Updated wikimedia/parsoid from v0.13.0-a20 to v0.14.0-a1.
94 ===== Changed development-only external libraries =====
95 * Updated qunit from 2.10.0 to 2.16.0.
98 ==== Removed external libraries ====
99 * The pimple/pimple development-only library has been removed.
102 === Bug fixes in 1.37 ===
105 === Action API changes in 1.37 ===
108 === Action API internal changes in 1.37 ===
111 === Languages updated in 1.37 ===
112 MediaWiki supports over 350 languages. Many localisations are updated regularly.
113 Below only new and removed languages are listed, as well as changes to languages
114 because of Phabricator reports.
116 * (T280435) LRM and RLM characters were removed from names of languages with
117 parentheses in Names.php
118 * (T283422) Add namespace name translations and change the autonym of
119 the Kinyarwanda language to "Ikinyarwanda".
120 * (T283423) Change the autonym of the Lombard language from "lumbaart"
122 * (T279619) Added language support for Dagbani (dag).
123 * (T282085) Added language support for Malay in Arabic (Jawi) script (ms-arab).
124 * (T283053) Added language support for Ojibwe (ojb).
125 * (T283480) Added language support for Wallisian (wls, Fakaʻuvea).
126 * (T284002) Added language support for Paiwan (pwn).
127 * (T284044) Added language support for Carpathian Romani (rmc).
128 * (T286460) Added language support for Gun (guw, Gungbe).
129 * (T287345) Added language support for Baoulé (bci).
131 === Breaking changes in 1.37 ===
132 * The Revision class, hard deprecated in 1.35, was removed entirely. As
133 part of this, the following hooks that included a Revision object
135 - ArticleRevisionUndeleted - use RevisionUndeleted
136 - ArticleRollbackComplete - use RollbackComplete
137 - DiffRevisionTools - use DiffTools
138 - DiffViewHeader - use DifferenceEngineViewHeader
139 - HistoryRevisionTools - use HistoryTools
140 - NewRevisionFromEditComplete - use RevisionFromEditComplete
141 - PageContentInsertComplete - use PageSaveComplete
142 - PageContentSaveComplete - use PageSaveComplete
143 - ParserFetchTemplate - use BeforeParserFetchTemplateRevisionRecord
144 - RevisionInsertComplete - use RevisionRecordInserted
145 - TitleMoveComplete - use PageMoveComplete
146 - TitleMoveCompleting - use PageMoveCompleting
147 - UndeleteShowRevision - no replacement
148 - UserRetrieveNewTalks - no replacement
149 and the following methods and variables have been removed
150 - Article::$mRevision
151 - Article::getRevisionFetched()
152 - ContribsPager::tryToCreateValidRevision()
153 - EditPage::$mBaseRevision
154 - EditPage::getBaseRevision()
155 - LinksUpdate::getRevision()
156 - LinksUpdate::setRevision()
157 - PageArchive::getArchivedRevision()
158 - PageArchive::getPreviousRevision()
159 - PageArchive::getRevision()
160 - Parser::$mRevisionObject
161 - Parser::fetchCurrentRevisionOfTitle()
162 - Parser::getRevisionObject()
163 - Parser::statelessFetchRevision()
164 - ParserOptions::getCurrentRevisionCallback()
165 - ParserOptions::setCurrentRevisionCallback()
166 - Title::countAuthorsBetween()
167 - Title::getFirstRevision()
168 - User::getNewMessageLinks()
169 - User::getNewMessageRevisionId()
171 - WikiPage::getOldestRevision()
172 - WikiPage::getRevision()
173 - WikiPage::getUndoContent()
174 - WikiPage::updateIfNewerOn()
175 and the following methods no longer accept Revision objects as parameters:
176 - CategoryMembershipChange::__construct()
177 - ContentHandler::getUndoContent()
178 - DerivedPageDataUpdater::prepareUpdate()
179 - DifferenceEngine::getRevisionHeader()
180 - Linker::buildRollbackLink()
181 - Linker::generateRollback()
182 - Linker::getRevDeleteLink()
183 - Linker::getRollbackEditCount()
184 - Linker::revComment()
185 - Linker::revUserLink()
186 - Linker::revUserTools()
187 - WikiPage::doDeleteUpdates()
188 - WikiPage::doEditUpdates()
189 - WikiPage::hasDifferencesOutsideMainSlot()
190 - WikiPage::onArticleEdit()
191 - WikiPage::prepareContentForEdit()
192 - WikiPage::updateRevisionOn()
193 The following methods return arrays that formerly included a 'revision'
194 key that would emit deprecation warnings when accessed and return a
195 Revision object. The Revision object has been removed from the arrays,
196 and the 'revision-record' key should be used to get the relevant
197 RevisionRecord instead:
198 - PageUpdater::doCreate()
199 - PageUpdater::doModify()
200 - Parser::statelessFetchTemplate()
201 - WikiPage::doEditContent()
202 The ParserOptions `templateCallback` option is a callback that is called
203 in Parser::fetchTemplateAndTitle() and should return an array - the
204 'revision' key to that array used to be a Revision object and was used if
205 no 'revision-record' was returned - it is now ignored.
206 * Previously, the classes RevisionTestModifyableContent and
207 RevisionTestModifyableContentHandler were loaded for use in tests, but
208 were only used within the tests for the since-removed Revision class. This
209 content and content handler class were removed without deprecation.
210 * WANObjectCache::HOLDOFF_NONE, deprecated since 1.35, was removed.
211 Use HOLDOFF_TTL_NONE instead.
212 * LocalFile::recordUpload2(), deprecated since 1.35, was removed.
213 * The following methods and fields in the Language class, deprecated since
214 1.35, have been removed:
220 - updateConversionTable()
221 * The following methods in the Parser class have been removed after having
222 been deprecated in 1.35:
225 * (T273354) When an edit is prevented by an 'EditFilterMergedContent' hook
226 handler without changing the status, the edit form will now be displayed.
227 * User::clearNotification() which had been deprecated in 1.35 has been removed.
228 Use WatchlistManager::clearTitleUserNotification() instead.
229 * User::getNewtalk() which had been deprecated in 1.35 has been removed. Use
230 TalkPageNotificationManager::userHasNewMessages() instead.
231 * Autopromote class, deprecated since 1.35, was removed. Use
232 UserGroupManager instead.
233 * The following classes, hard-deprecated since 1.36, have been removed:
234 CachedAction, SpecialCachedPage, CacheHelper, ICacheHelper.
235 * The hooks BeforeHttpsRedirect, CanIPUseHTTPS and UserRequiresHTTPS, deprecated
236 in 1.35, were removed.
237 * The TitleArrayFromResult hook, deprecated in 1.36, was removed.
238 * The deprecated "es6-promise" alias ResourceLoader module has been removed. Use
239 "es6-polyfills" directly intead.
240 * The deprecated "mediawiki.legacy.protect" ResourceLoader module, deprecated
241 since 1.36, has been removed. Use "mediawiki.action.protect" instead.
242 * AuthenticationProvider interface doesn't extend LoggerAwareInterface.
243 So AuthenticationProvider can't be typehinted as LoggerAwareInterface.
244 * User::getGrantName(), hard deprecated since 1.36, has been removed.
245 Use MWGrants::grantName instead.
246 * SessionProvider class doesn't extend LoggerAwareInterface.
247 So SessionProvider can't be typehinted as LoggerAwareInterface.
248 * The following ApiBase methods, deprecated since 1.35, have been removed:
249 - ApiBase::explodeMultiValue
250 - ApiBase::parseMultiValue
251 - ApiBase::validateLimit
252 - ApiBase::validateTimestamp
253 * User::idCacheByName public static field was removed without deprecation.
254 instead of using it, get a UserIdentity by name from UserIdentityLookup.
255 * IDatabase::upsert() and IDatabase::replace() only accept a single unique key.
256 Previously, a warning was issued if there were multiple unique keys provided.
257 * The MediaWiki:Autoblock_whitelist block exemption control was moved in 1.36 to
258 MediaWiki:Block-autoblock-exemptionlist. The backward-compatibility of reading
259 the old MediaWiki:Autoblock_whitelist page has now been dropped.
260 * The following overridable methods in File hierarchy has changed signatures:
261 - File::deleteFile - now accepts UserIdentity instead of User
262 - File::getDescription - now accepts Authority instead of User
263 - File::userCan - now accepts Authority instead of User
264 - LocalFile::deleteOldFile - now accepts UserIdentity instead of User
265 * The following global methods, each deprecated since 1.36, have been removed:
266 - wfAppendToArrayIfNotDefault
268 - wfConfiguredReadOnlyReason
270 - wfGetPrecompiledData
272 * The following deprecated methods of Title class have been removed:
273 - nameOf, deprecated in 1.36
274 - getPreviousRevisionID, deprecated in 1.34
275 - getNextRevisionID, deprecated in 1.34
276 - getEarliestRevTime, deprecated in 1.35
277 * UploadBase::stashFile, deprecated since 1.28, was removed.
278 * wfGetRusage(), deprecated since 1.35, has been removed.
279 * The following CLI options were removed from tests/phpunit.php:
283 The following options (inherited from Maintenance) were also removed:
292 The following options were changed to environment variables:
293 - wiki => PHPUNIT_WIKI
294 - use-normal-tables => PHPUNIT_USE_NORMAL_TABLES
295 - use-filebackend => PHPUNIT_USE_FILEBACKEND
296 - use-bagostuff => PHPUNIT_USE_BAGOSTUFF
297 - use-jobqueue => PHPUNIT_USE_JOBQUEUE
298 This is so that we can use the default PHPUnit entry point (T90875).
299 * The PHPUNIT_REUSE_DB / --reuse-db option was removed from the phpunit.php
300 runner. It had been broken for at least three years already. The original use
301 case was speeding up tests on Oracle, but Oracle support was dropped several
303 * EntryPoint::getTextFormatters() was made private without a deprecation period;
304 it had no known external callers.
305 * DatabaseBlock::chooseBlock, deprecated since 1.35, was removed.
306 * SpecialPageFactory::getRestrictedPages, deprecated since 1.36, was removed.
307 * SpecialBlock::validateTarget, deprecated since 1.36, was removed.
308 * The PatchFileLocation trait was removed without deprecation.
309 * ActorMigrationBase::getExistingActorId and ::getNewActorId, hard deprecated
310 since 1.36, were removed.
311 * Hook handlers implementing MediaWikiServicesHook are prohibited from having
312 services injected. This is because by definition, this hook runs before the
313 service container is fully initialized.
314 * The protected property LocalFile::$metadata was removed without deprecation.
315 * WatchedItem::getUser, hard deprecated since 1.36, has been removed.
316 * AuthManager::singleton, hard deprecated since 1.36, has been removed.
317 * The AugmentPageProps class was removed without deprecation. It had no known
319 * Html::infobox, deprecated since 1.36, was removed.
320 * ParserOptions::__construct() now requires that the first parameter is a
321 UserIdentity object - passing `null` used to fallback to the global
322 $wgUser but was deprecated since 1.36.
323 * ParserOptions::newCanonical() no longer supports the first parameter being
324 null (or omitted entirely), which would fallback to the global $wgUser but
325 was deprecated since 1.35.
326 * The SkinTemplatePreventOtherActiveTabs hook, deprecated in 1.35, was removed
328 * The SkinTemplateTabAction hook, deprecated in 1.35, was removed entirely.
329 * The SkinTemplateBuildNavUrlsNav_urlsAfterPermalink hook, deprecated in 1.35,
330 was removed entirely.
331 * The following methods of RevisionStore class, formerly hard deprecated,
333 - ::newMutableRevisionFromArray,
334 - ::loadRevisionFromPageId,
335 - ::loadRevisionFromTitle,
336 - ::loadRevisionFromTimestamp,
337 - ::listRevisionSizes
338 * LogEntry::getPerformer, deprecated since 1.36, was removed along with methods
339 in subclasses: DatabaseLogEntry, ManualLogEntry, RCDatabaseLogEntry.
340 * Skin::getRelevantUser now returns an instance of UserIdentity, not necessarily
341 a User object. There is no known usages in MediaWiki ecosystem that were not
342 satisfied with UserIdentity.
343 * Direct construction of MergeHistory class, deprecated since 1.35, is no longer
344 supported. Use MergeHistoryFactory instead. MergeHistory::checkPermissions,
345 deprecated since 1.36, was removed.
346 * Skin::generateDebugHTML(), deprecated since 1.35, was removed. Call
347 MWDebug::getHTMLDebugLog() directly.
348 * The ApiTestCase class no longer interacts with the global $wgUser.
349 Previously, the global variable was set at the start of each test, and in
350 ApiTestCase::doApiRequest() if a performer was specified $wgUser was
351 updated to match, and if no performer was specified $wgUser was used
352 instead. Now, $wgUser is not updated, and if no performer is specified
353 the reusable TestUser object for the sysop is relied on. Extensions
354 or skins that rely on the global $wgUser variable (which has been
355 deprecated since 1.35) should instead retrieve the acting user from the
356 relevant context source.
357 * SkinTemplate::makeArticleUrlDetails, deprecated since 1.35, was removed.
358 * Skin::makeNSUrl, deprecated since 1.35, was removed.
359 * Skin::getRevisionId(), deprecated since 1.34, was removed. Use
360 OutputPage::getRevisionId() instead.
361 * Skin::isRevisionCurrent(), deprecated since 1.34, was removed. Use
362 OutputPage::isRevisionCurrent() instead.
363 * AbstractBlock::parseTarget(), deprecated since 1.36, was removed.
364 * ArticleEditUpdates hook, deprecated since 1.35, was removed.
365 * @stable to extend class CentralIdLookup has following changes:
366 - Protected ::checkAudience method now returns Authority instead of User.
367 - A number of it's @stable to override methods now accept Authority instead
368 of User as $audience parameter.
369 - A number of methods now accept UserIdentity instead of User parameter.
370 - ::localUserFromCentralId method now returns UserIdentity and not necessarily
372 All extensions that extend this class or use this method were updated to be
373 ready to the new behavior.
374 * WatchedItemStoreInterface::enqueueWatchlistExpiryJob, deprecated since 1.36,
376 * ResultWrapper is now abstract. It cannot be directly constructed (T286694).
377 * The SecondaryDataUpdates hook, deprecated in 1.32, was removed entirely.
378 * Content::getDeletionUpdates(), was removed. Use
379 ContentHandler::getDeletionUpdates() instead.
380 * Content::getSecondaryDataUpdates(), was removed. Use
381 ContentHandler::getSecondaryDataUpdates() instead.
382 * wfDiff(), deprecated since 1.25, has been removed.
383 * Language::$mLangObjCache, deprecated since 1.35, was removed.
384 * SpecialMute::getTarget(), unused outside of the SpecialMute class, was
386 * The Skin::setupSkinUserCss method deprecated in 1.32, was removed. Please use
387 skin registration instead.
388 * ParserCache::getKey and ::getEtag, deprecated since 1.36, were removed.
389 * The BaseTemplateToolbox hook, deprecated since 1.35, was removed.
390 * Previously a capitalize-all-nouns class was added to the body element of
391 languages where nouns must be capitalized. This class is no longer added to
392 the body tag and must be provided by skins.
393 * The SkinTemplateOutputPageBeforeExec hook, deprecated since 1.35, was removed.
396 === Deprecations in 1.37 ===
397 * JobQueue::getWiki, deprecated in 1.33, now emits deprecation warnings.
398 * In AbstractBlock, the getTargetAndType() and getTarget() methods are
399 hard deprecated. Instead use getTargetName() and getTargetUserIdentity()
400 together with getType().
401 * Deprecated passing UserIdentity to
402 WatchlistManager::clearAllUserNotifications() and
403 WatchlistManager::clearTitleUserNotifications(). Pass Authority instead.
404 * Deprecated passing LinkTarget to
405 WatchlistManager::clearTitleUserNotifications() and
406 WatchlistManager::getTitleNotificationTimestamp(). Pass PageIdentity instead.
407 * Deprecated User::isWatched(), User::isTempWatched(), User::addWatch(), and
408 User::removeWatch(). Use corresponding methods in WatchlistManager instead.
409 * Deprecated WatchAction::doWatchOrUnwatch(). Use WatchlistManager::setWatch()
411 * Deprecated WatchAction::doWatch() and WatchAction::doUnwatch(). Use
412 WatchlistManager::addWatch() or WatchlistManager::removeWatch(), instead.
413 * WatchAction::getWatchToken is hard deprecated. Instead use
414 CsrfTokenSet::getToken
415 * Action::getHookContainer() has been marked as internal. Actions that require
416 access to a hook container should have one injected instead.
417 * The getTitle() and setTitle() methods in Parser have been deprecated.
418 Use getPage() and setPage() instead.
419 * Title::isWatchable() has been deprecated. Use WatchlistManager::isWatchable()
421 * The 'getMasterDB()' methods for LocalRepo (and so ForeignDBRepo), JobQueueDB,
422 ForeignDBViaLBRepo, and DBFileJournal have been deprecated in favour of a new
423 method, getPrimaryDB().
424 * DBMasterPos and MySQLMasterPos have been respectively renamed to DBPrimaryPos
425 and MySQLPrimaryPos. The former names are left as deprecated, temporary class
427 * ILoadBalancer::getMasterPos() and IDatabase::getMasterPos() have been renamed
428 to getPrimaryPos(). The old name is still available, but soft-deprecated.
429 * wfIncrStats(), deprecated in 1.36, now emits deprecation warnings.
430 * wfCanIPUseHTTPS() is now deprecated, and always returns true.
431 * The UserLoadFromDatabase hook has been deprecated. It had no known uses.
432 * AbstractAuthenticationProvider ::setLogger(), ::setManager(), ::setConfig(),
433 ::setHookContainer() were soft deprecated. Use ::init() to inject
434 dependencies or override ::postInitSetup() to do any custom
435 post-initialization configuration.
436 * The following methods in ApiPageSet have been deprecated:
437 - getTitles(), use getTargets() instead.
438 - getGoodTitles(), use getGoodPages() instead.
439 - getMissingTitles(), use getMissingPages() instead.
440 - getGoodAndMissingTitles(), use getGoodAndMissingPages() instead.
441 - getRedirectTitles(), use getRedirectTargets() instead.
442 - getSpecialTitles(), use getSpecialPages() instead.
443 * The following functions from the User class, deprecated in 1.35, now emit
444 deprecation warnings:
450 - addAutopromoteOnceGroups
454 * The following methods in User were deprecated:
455 - ::idFromName - use UserIdentityLookup::getUserIdentityByName instead.
456 - ::resetIdByNameCache - in tests, reset service container. No replacement
457 needed in production code.
458 * Use of ActorMigration for any table except revision, deprecated in 1.34, now
459 emits deprecation warnings. Instead of getInsertValues(), use
460 ActorNormalization::acquireActorId(). Instead of getWhere() and getJoin(),
461 do your own join on the actor table.
462 * DatabasePostgres::remappedTableName() and its dependent constructor parameter
463 'keywordTableMap' are deprecated. Reserved identifiers that are used as table
464 names should be quoted where necessary.
465 * LinkCache::singleton(), deprecated since 1.28, now emits deprecation warnings.
466 * MessageCache::singleton(), deprecated since 1.34, now emits deprecation
468 * LockManagerGroup::singleton() and ::destroySingletons(), deprecated since
469 1.34, now emit deprecation warnings.
470 * HtmlFileCacheUpdate::newFromTitles() is now deprecated and emitting warnings.
471 Use newFromPages() instead.
472 * SessionProvider ::setLogger(), ::setManager(), ::setConfig(),
473 ::setHookContainer() were soft deprecated. Use ::init() to inject
474 dependencies or override ::postInitSetup() to do any custom
475 post-initialization configuration.
476 * User->isLoggedIn(), deprecated since 1.36, now emits deprecation warnings. Use
477 the method it wraps, User->isRegistered(), instead.
478 * FileBackendGroup::singleton() and ::destroySingletons(), deprecated since
479 1.35, now emit deprecation warnings.
480 * The first parameter of User::getBlock should now be an integer using the
481 Authority::FOR_XXX constants. Providing a boolean is deprecated.
482 * ApiBase::addBlockInfoToStatus() is deprecated for use by extensions. It is now
483 marked as @internal and may be deleted in the future.
484 It should not be necessary to call this method, Authority should be providing
485 all relevant information via a PermissionStatus object.
486 * JobQueueGroup::singleton was deprecated - use
487 MediaWikiServices::getJobQueueGroup instead.
488 * JobQueueGroup::destroySingletons was deprecated. JobQueueGroups are now
489 automatically destroyed after tests.
490 * SessionProvider ::setLogger(), ::setManager(), ::setConfig(),
491 ::setHookContainer() were hard deprecated. Use ::init() to inject
492 dependencies or override ::postInitSetup() to do any custom
493 post-initialization configuration.
494 * ContentHandler::getContentText() is now soft deprecated.
495 Use Content::getText() instead.
496 * MediaWiki\User\UserNamePrefixSearch::search() previously accepted as
497 its first parameter either the string 'public' or a UserIdentity object,
498 to filter results for. It now expects an Authority object instead of
499 UserIdentity, and providing just a UserIdentity is hard deprecated.
500 * wfLocalFile(), deprecated since 1.34, now emits deprecation warnings.
501 * wfFindFile(), deprecated since 1.34, now emits deprecation warnings.
502 * User::getRights(), deprecated since 1.34, now emits deprecation warnings.
503 * User::changeableGroups and ::changeableByGroup were hard deprecated, use
504 corresponding methods in UserGroupManager instead.
505 * User::incEditCount() was deprecated in favor of the new method
506 UserEditTracker::incrementUserEditCount().
507 * RepoGroup::singleton(), ::destroySingleton() and ::setSingleton(),
508 deprecated since 1.34, now emit deprecation warnings.
509 * AbstractAuthenticationProvider ::setLogger(), ::setManager(), ::setConfig(),
510 ::setHookContainer() were hard deprecated. Use ::init() to inject
511 dependencies or override ::postInitSetup() to do any custom
512 post-initialization configuration.
513 * RecentChange::getPerformer(), hard-deprecated since 1.37,
514 use getPerformerIdentity() instead.
515 * ContentHandler::cleanupHandlersCache(), deprecated since 1.35, now emits
516 deprecation warnings.
517 * File::getUser method was hard deprecated, along with overrides in LocalFile
518 and ForeignApiFile in favor of ::getUploader.
519 * SpecialBlock::checkUnblockSelf(), deprecated in 1.36, now emits deprecation
521 * (T284179) The mediawiki.viewport ResourceLoader module is deprecated. You can
522 now just use MutationObserver or InterSectionObserver directly, which are
523 widely available in all supported JavaScript browsers.
524 * The following constructor options of DatabaseBlock class,
525 hard deprecated since 1.37:
526 - 'byText' property with blocker's name,
527 use 'by' property with UserIdentity value instead.
528 - 'by' property with blocker's ID,
529 use 'by' property with UserIdentity value instead.
530 * The BeforeResetNotificationTimestamp hook was deprecated.
531 * ArchivedFile::getUser, ::getRawUser, ::getRawUserText were deprecated in
532 favor of ::getUploader. ::getRawDescription was deprecated in favor of
533 ::getDescription with RAW audience parameter.
534 * When calling LocalFile::newFromRow() or LocalFile::loadFromRow(), passing
535 extra fields not requested by ::getQueryInfo() is hard deprecated. This is
536 to warn callers that deprefixing and automatic assignment of such fields will
537 not be done in a future version.
538 * JobSpecification::getTitle was deprecated without providing a replacement.
539 It wasn't used and job given the purpose of JobSpecification class it's
541 * The protected method File::getImageSize() is deprecated.
542 * MediaHandler::getImageSize(), ::getMetadata() and ::isMetadataValid were
543 deprecated and should no longer be overridden. Instead, subclasses should
544 override getSizeAndMetadata().
545 * Deprecated File::getMetadata(). Instead use ::getMetadataArray(),
546 ::getMetadataItem() and ::getMetadataItems().
547 * Message::title was deprecated, use Message::page instead.
548 * BaseTemplate::getAfterPortlet, BaseTemplate::renderAfterPortlet and the
549 BaseTemplateAfterPortlet hook, which were deprecated in 1.35,
550 now emit deprecation warnings.
551 * LocalFile::getHistory hook is deprecated.
552 * Calling WikiPage::prepareContentForEdit() without a UserIdentity is now
554 * User::getEditTokenObject, ::getEditToken, ::matchEditToken were deprecated.
555 Use CsrfTokenRepository, which is available via IContextSource, instead.
556 ::matchEditTokenNoSuffix was deprecated without replacement.
557 It was introduced to be able to provide custom error message if the token
558 was submitted, but ending slashes were stripped by some ASCII mangling proxy.
559 Use matchToken instead, such proxies are much less common now and there's
560 not much benefit in customising the error message.
561 * ContentHandler::getForTitle(), deprecated since 1.35, now emits
562 deprecation warnings.
563 * User::listOptionKinds(), deprecated since 1.35, now emits deprecation
565 * WikiPage::doEditContent(), deprecated since 1.32, now emits deprecation
567 * CentralIdLookup::factory and ::factoryNonLocal were deprecated, obtain an
568 instance from MediaWikiServices instead.
569 * BotPassword::invalidateAllPasswordsForCentralId() was deprecated.
570 * BotPassword::removeAllPasswordsForCentralId() was deprecated.
571 * The Title class members: $mTextform, $mUrlform, $mDbkeyform, $mNamespace,
572 $mInterwiki, and $mFragment have been deprecated to not be used directly.
573 Instead, their corresponding accessor methods should be used.
574 * IDatabase::fetchObject(), ::fetchRow(), ::numRows(), ::numFields(),
575 ::fieldName(), ::freeResult() and ::dataSeek() are deprecated. Use the
576 corresponding methods in IResultWrapper instead.
577 * ResultWrapper::unwrap(), DatabaseMysqlBase::fieldType() and
578 DatabasePostgres::fieldType() are hard-deprecated.
579 * Subclasses implementing Database::doQuery() should return either boolean or
580 an IResultWrapper. To do otherwise is hard-deprecated.
581 * User::getOptionKinds() and ::resetOptions(), both deprecated since 1.35,
582 now emit deprecation warnings.
583 * wfGetLB(), deprecated since 1.27, now emits deprecation warnings.
584 * The following methods in MWNamespace, all deprecated since 1.34, now emit
585 deprecation warnings:
596 - getSubjectNamespaces()
597 - getTalkNamespaces()
599 - hasGenderDistinction()
601 - getNamespaceContentModel()
602 - getRestrictionLevels()
603 - getCategoryLinkType()
604 * LogFormatter::styleRestricedElement() has been deprecated in favor of
605 LogFormatter::styleRestrictedElement()
606 * The following hooks were deprecated:
607 - UserLoadOptions: use LoadUserOptions instead.
608 - UserSaveOptions: use SaveUserOptions instead.
609 - UserResetAllOptions: no replacement was provided, the hook is not used.
610 * Title::isNamespaceProtected, deprecated in 1.34, is now hard-deprecated.
613 === Other changes in 1.37 ===
614 * WatchlistManager::addWatch and WatchlistManager::addWatchIgnoringRights(),
615 which replace User::addWatch(), now call the WatchArticle and
616 WatchArticleComplete hooks.
617 * WatchlistManager::removeWatch and
618 WatchlistManager::removeWatchIgnoringRights(), which replace
619 User::removeWatch(), now call the UnwatchArticle and UnwatchArticleComplete
621 * The overridable postInitSetup() method was added to the
622 AbstractAuthenticationProvider class. A provider can override postInitSetup()
623 to do any custom post-initialization configuration.
624 * The overridable postInitSetup() method was added to the SessionProvider
625 class. A provider can override postInitSetup() to do any custom
626 post-initialization configuration.
627 * The protected getConfig() method was added to the SessionProvider class.
628 Use SessionProvider::getConfig to get a config.
629 * The DBAccessBase class is deprecated. Classes that used to extend it
630 should get a load balancer (factory) injected in the constructor instead.
631 * ActorNormalization::acquireActorId now requires IDatabase parameter.
632 Not providing one emitted deprecation warnings since 1.36.
633 * Anti-lock constants ALF_PRELOAD_LINK, ALF_NO_BLOCK_LOCK, ALF_NO_LINK_LOCK
634 and ALF_PRELOAD_EXISTENCE have been removed. They're unused since 1.25.
635 * CSS class 'mw-htmlform-field-autoinfuse' used by some forms has been
636 renamed to 'mw-htmlform-autoinfuse'. (T278036)
637 * User::newFromRow does not accept pre-loaded user preferences under
638 $data['user_properties'] anymore. This optimization was not used.
643 MediaWiki 1.37 requires PHP 7.3.19 or later and the following PHP extensions:
654 MySQL/MariaDB is the recommended DBMS. PostgreSQL or SQLite can also be used,
655 but support for them is somewhat less mature.
657 The supported versions are:
659 * MySQL 5.5.8 or later
660 * PostgreSQL 9.4 or later
661 * SQLite 3.8.0 or later
663 == Online documentation ==
664 Documentation for both end-users and site administrators is available on
665 MediaWiki.org, and is covered under the GNU Free Documentation License (except
666 for pages that explicitly state that their contents are in the public domain):
668 https://www.mediawiki.org/wiki/Special:MyLanguage/Documentation
671 A mailing list is available for MediaWiki user support and discussion:
673 https://lists.wikimedia.org/mailman/listinfo/mediawiki-l
675 A low-traffic announcements-only list is also available:
677 https://lists.wikimedia.org/mailman/listinfo/mediawiki-announce
679 It's highly recommended that you sign up for one of these lists if you're
680 going to run a public MediaWiki, so you can be notified of security fixes.
683 There's usually someone online in #mediawiki on irc.libera.chat.