Localisation updates from https://translatewiki.net.
[mediawiki.git] / RELEASE-NOTES-1.41
blob7257db286d03b5cffd0eab23867e89632074586a
1 = MediaWiki 1.41 =
3 PHP 8.0 workboard: https://phabricator.wikimedia.org/tag/php_8.0_support/
4 PHP 8.1 workboard: https://phabricator.wikimedia.org/tag/php_8.1_support/
5 PHP 8.2 workboard: https://phabricator.wikimedia.org/tag/php_8.2_support/
6 PHP 8.3 workboard: https://phabricator.wikimedia.org/tag/php_8.3_support/
8 == MediaWiki 1.41.3 ==
10 THIS IS NOT A RELEASE YET
12 === Changes since MediaWiki 1.41.2 ===
13 * Localisation updates.
15 == MediaWiki 1.41.2 ==
17 This is a maintenance release of the MediaWiki 1.41 branch.
19 === Changes since MediaWiki 1.41.1 ===
20 * Localisation updates.
21 * maintenance/generateSitemap.php: Partially revert 676fcf4.
22 * tests: Skip failing tests on php8.2 (and make pass).
23 * (T326480) ApiResult: Make array ordering consistent across PHP versions.
24 * (T352789, T287972) build: Raise TestingAccessWrapper from 2.0.0 to 3.0.0.
25 * (T326478) tests: Create new classes to hold dynamic properties in auth tests.
26 * (T353180) WANObjectCacheTest::testPreemptiveRefresh: Skip flaky test for PHP
27   8.2+.
28 * tests: Remove es6 option from StartUpModuleTest.
29 * (T326478) tests: Avoid dynamic properties in AuthenticationProvider Test.
30 * tests: Skip failing tests on php8.3 (and make pass).
31 * (T326466) Introduce and use DynamicPropertyTestHelper.
32 * (T326478) tests: Avoid dynamic properties in auth tests.
33 * (T352910) tests: Use TestingAccessWrapper::newFromClass in session tests.
34 * (T326478) tests: Avoid dynamic properties in SessionManagerTest.
35 * ArticleTest: Skip testGetOrSetOnNewProperty() if PHP >= 8.2.
36 * tests: Remove dead code from WikiPageDbTest::assertPreparedEditNotEquals.
37 * (T326479, T361985) StatusValue: Allow passing arbitrary data to augment
38   result.
39 * (T357760) Use i18n strings for truncated subpage message in SpecialMovePage.
40 * debug: Update PsySH 0.11.1 -> 0.12.3.
41 * (T361991) Fix slash-delimited regex from CLI on maintenence/grep.php.
42 * (T352695) tests: Only set $dbSetup if setupTestDB() ends without throwing.
43 * (T362272) api: Replace null $httpCode by 0 in ApiBase::dieWithErrorOrDebug.
44 * (T362740) api: Pass wikiId to UserIdentity instance for action=userrights.
45 * (T343994) SpecialPages: Document which class getDescription is returning a
46   string from.
47 * (T150647, T216682) Make EncryptedPassword work with Argon2Password.
48 * (T364270) Fix long param names overlapping docs in API help pages.
49 * wrapOldPasswords: Improve progress output and decrease batch size.
50 * (T361367) ApiFeedWatchlist: Fix handling of array parameters.
51 * (T366130) EncryptedPassword: Store default parameters as strings.
52 * Name the PagerTools array entries to allow hooks to unset them.
53 * Do not mark HttpRequestFactory as @internal.
55 == MediaWiki 1.41.1 ==
57 This is a security and maintenance release of the MediaWiki 1.41 branch.
59 === Changes since MediaWiki 1.41.0 ===
60 * Localisation updates.
61 * CategoryViewer: Fix "count(): Argument #1 ($value) must be of type
62   Countable|array, null given".
63 * (T353929) ActiveUsersPager: Count actions only once.
64 * composer: Use @php instead of php.
65 * (T334992) Headings in the license pickers should not be selected.
66 * (T326065) Indent JsonContent using tabs.
67 * Correct deprecation version of mediawiki.ui resource loader module.
68 * Resources.php: Replace short urls with full urls.
69 * (T354541) authmanager: Improve AuthenticationRequest docs.
70 * Tweak docs for UseLegacyMediaStyles.
71 * (T353870) Parse custom edit intro as content to enable language conversion.
72 * (T330428) ForeignResourceManager: Add trailing newline in validateLicense.
73 * ForeignResourceManager: Make it clearer what is being skipped for
74   documentation-only.
75 * (T355017) Add missing space in Special:RecentChangesLinked.
76 * (T355003) composer.json Add ext-bcmath and ext-gmp to suggests.
77 * PHPVersionCheck: Update text to match currently supported upstream PHP
78   versions (8.1+).
79 * (T354045) API: mark HTML output as non-cacheable.
80 * (T355530) filerepo: Fix img_major_mime for files with a non-standard
81   extensions.
82 * (T355530) MimeAnalyzer: Add @since to isValidMajorMimeType.
83 * (T352554) ZhConverter: Fix language variant fallback chain.
84 * (T347541) Add 'maxlength' and 'minlength' support to HTMLTextAreaField.
85 * (T357668) Parser::getExternalLinkAttribs: Don't set rel attribute to null.
86 * LockManagerGroupIntegrationTest: Remove test depending on DBLockManager.
87 * (T357808) LinkRendererTest: Add missing import for LinkTarget.
88 * (T353305) ApiResetPassword: Allow both user and email parameters to be passed
89   for reset.
90 * (T358949) updateCollation: Explicitly cast $scale to int.
91 * (T359055) api: Improve linking of language codes lists in top level i18n
92   messages.
93 * (T359294) Make sure MovePage::isValidFileMove matches UploadBase::getTitle.
94 * (T230245) Respect $maxConcurrency when queuing async FileOps.
95 * (T352554) Follow-up "ZhConverter: Fix language variant fallback chain".
96 * (T359139) Restore ability to disable footer links with "-".
97 * Fix use of array keys in SessionManager::getVaryHeaders().
98 * (T292237, T317451) build: Restore Doxygen output for MediaWiki release tags.
99 * (T324903) HistoryPager: Add #[AllowDynamicProperties].
100 * (T360850) Update Apache config syntax in .htaccess files.
101 * Update wikimedia/parsoid to 0.18.2.
102 * docs: Remove use of $IP from mwdocgen.php.
103 * (T317451) build: Restore Doxygen output for MediaWiki release tags (take 3).
104 * docs: Set stable permalink on markdown files.
105 * (T360608) WebRequest: detectServer appends default ports that should be
106   omitted.
107 * (T357019) allow maintenance/deleteBatch.php to accept page ID.
108 * (T355538, CVE-2024-34507) SECURITY: XSS in edit summary parser.
109 * (T357760, CVE-2024-34506) SECURITY: Denial of service vector via GET request
110   to Special:MovePage on pages with thousands of subpages.
112 == MediaWiki 1.41.0 ==
114 === Changes since MediaWiki 1.41.0-rc.0 ===
115 * Localisation updates.
116 * Update wikimedia/parsoid to 0.18.0.
117 * (T351758) DEVELOPERS.md: reword WSL instructions to include best practices.
118 * (T350615) PoolCounterConnectionManager: Add support for ipv6.
119 * (T321234) Make MagicWordArray not fail on old revs with broken UTF-8.
120 * thumb: Fix "PHP Deprecated: strlen(): Passing null to parameter".
121 * (T344971) Maintenance: Fix RebuildTextIndex.
122 * (T327007) htmlform: Correct validation for file input field.
124 == MediaWiki 1.41.0-rc.0 ==
126 == Upgrading notes for 1.41 ==
127 Don't forget to always back up your database before upgrading!
129 See the file UPGRADE for more detailed per-version upgrade instructions from the
130 oldest supported upgrading version, MediaWiki 1.35.
132 Some specific notes for MediaWiki 1.41 upgrades are below:
133 * (T178356) MediaWiki now requires browsers to support ES6 for them to receive
134   JavaScript, up from ES5. In practice, this primarily means that users of
135   Internet Explorer 11 (EOL in 2022) will no longer get JavaScript tools.
137 For notes on 1.40.x and older releases, see HISTORY.
139 === Configuration changes for system administrators in 1.41 ===
140 * $wgGroupPermissions: The 'purge' permission is now considered an
141   implicit right that can be rate limited, but not revoked. This has
142   effectively already been the case for a long time, see T291316.
144 ==== New configuration ====
145 * $wgPrivilegedGroups – Users belonging in some of the listed groups will be
146   audited more aggressively.
147 * $wgPageLinksSchemaMigrationStage – This temporary flag lets you control the
148   migration stage for converting the pagelinks database table into normal form.
149 * $wgExternalLinksDomainGaps – Can be used by large wikis to optimize certain
150   external link queries.
151 * $wgResourceLoaderEnableSourceMapLinks - Add a SourceMap header to
152   ResourceLoader responses for JavaScript modules (T47514).
153 * $wgVirtualDomainsMapping - Mapping of virtual domains to other dbs. It's
154   useful to get connection to the external cluster.
156 ==== Changed configuration ====
157 * $wgAuthManagerAutoConfig – When using this setting to modify the
158   authentication system in MediaWiki, the classes
159   TemporaryPasswordPrimaryAuthenticationProvider,
160   LocalPasswordPrimaryAuthenticationProvider and
161   EmailNotificationSecondaryAuthenticationProvider now require
162   DBLoadBalancerFactory, not DBLoadBalancer, as a service.
163 * $wgUseFileCache is no longer used for ResourceLoader module caching.
164 * $wgLBFactoryConf['secret'] has been replaced by $wgChronologyProtectorSecret.
166 ==== Removed configuration ====
167 * $wgCommentTempTableSchemaMigrationStage – This temporary flag did let you
168   control the migration stage for the temporary comment database table, from
169   revision.
170 * $wgExternalLinksSchemaMigrationStage – This temporary flag did let you
171   control the migration stage for the externallinks database table.
172 * $wgParserOutputHooks - This array interacted with
173   ParserOutput::addOutputHook(), which has been deprecated since 1.38 and was
174   removed in this release.
176 === New user-facing features in 1.41 ===
177 * Special:RandomPage can now take multiple namespaces in its URL, split by ','.
178 * The aria-level HTML attribute is now allowed in wikitext by the Sanitizer.
180 === New features for sysadmins in 1.41 ===
181 * $wgDBssl can now enabled in the installer when the database type is
182   Postgres or MariaDB/MySQL (T335828).
183 * MWHttpRequest will forward 'tracestate' and/or 'traceparent' headers when
184   those are present in the original request and $wgAllowExternalReqID is set
185   to true.
186 * MultiHttpClient will send X-Request-Id header and additionally will forward
187   'tracestate' and/or 'traceparent' headers when those are present in the
188   original request and $wgAllowExternalReqID is set to true.
190 === New developer features in 1.41 ===
191 * Added ForeignResourcesDir extension.json / skin.json attribute, which should
192   point to the directory holding your foreign-resources.yaml file. See
193   https://www.mediawiki.org/wiki/Foreign_resources for background.
194 * Added PrivilegedGroups attribute for extension.json / skin.json, which lets
195   you add any new user groups you define to wgPrivilegedGroups (see above).
196 * Added a .gitmessage commit template. To use it, run:
197   `git config commit.template .gitmessage`
198 * A new hook, TextSlotDiffRendererTablePrefixHook, has been added to allow
199   extensions to add content within #mw-content-text but after the
200   DifferenceEngineViewHeader or DifferenceEngineShowDiffPage hooks have been
201   run. The new hook is used to add elements within a horizontal display area,
202   where their order can be explicitly set. Examples of uses for this include
203   adding the VisualEditor diff-type switch, and the legend for inline diffs that
204   is displayed if Wikidiff2 is installed.
205 * validation callbacks for HTMLForm fields can now return Status objects.
206   HTMLForm::validate will convert good Status instances to true and Status
207   instances to a string containing a list with the errors.
208 * ?action=rollback, if successful, will fire core's postEdit JavaScript hook;
209   for now, we do *not* display a success message to the user via mw.notify(),
210   as the RollbackAction form's success page is already shown
211 * MultiHttpClient constructor will accept `headers` property which defines a
212   set of headers attached to every request performed by the client.
213 * New `Wikimedia/Http/TelemetryHeadersInterface` interface that provides a
214   telemetry information which could be attached to HTTP Requests
215 * Wikimedia/Http/TelemetryHeadersInterface can be passed to MultiHttpClient
216   via 'telemetry' option.
217 * UserRegistrationLookup adds support for multiple kinds of registration dates
218   Extensions providing support for wiki-farm can use this to provide a global
219   registration date (across all wikis), for example.
220 * When $wgUseXssLanguage is set to true (enabled by default in
221   DevelopmentSettings.php), ?uselang=x-xss can be used to easily test
222   whether all messages are being escaped correctly.
223 * Html::noticeBox accepts new optional parameters, 'heading' & 'iconClassName'.
224   'heading' allows to pass an string as title; 'iconClassName' overwrites the
225   default info icon.
227 === External library changes in 1.41 ===
229 ==== New external libraries ====
230 * Added pinia at v2.0.16.
231 * Added symfony/polyfill-php81 at v1.28.0.
232 * Added symfony/polyfill-php82 at v1.28.0.
233 * Added symfony/polyfill-php83 at v1.28.0.
235 ==== Changed external libraries ====
236 * Updated codex, codex-design-tokens and codex-icons
237   from v0.6.2 to v1.0.0.
238 * Updated guzzlehttp/guzzle from 7.5.0 to 7.5.3.
239 * Updated jQuery from v3.6.1 to v3.7.0.
240 * Updated justinrainbow/json-schema from 5.2.12 to v5.2.13.
241 * Updated Mustache from 3.0.1 to 4.2.0.
242 * Updated OOjs from 6.0.0 to 7.0.1.
243 * Updated OOUI from v0.46.3 to v0.48.1.
244 * Updated pear/mail from 1.5.0 to 1.5.1.
245 * Updated symfony/polyfill-php82 from v1.27.0 to v1.28.0.
246 * Updated symfony/yaml from v5.4.17 to v5.4.23.
247 * Updated wikimedia/bcp-47-code from 1.0.0 to 2.0.0.
248 * Updated wikimedia/common-passwords from 0.4.0 to 0.5.0.
249 * Updated wikimedia/composer-merge-plugin from 2.0.1 to 2.1.0.
250 * Updated wikimedia/html-formatter from 3.0.1 to 4.0.3.
251 * Updated wikimedia/ip-utils from 4.0.0 to 5.0.0.
252 * Updated wikimedia/less.php from 4.0.0 to 4.1.1.
253 * Updated wikimedia/minify from 2.3.0 to 2.5.1.
254 * Updated wikimedia/remex-html from 3.0.3 to 4.0.1.
255 * Updated wikimedia/timestamp from 4.1.0 to 4.1.1.
256 * Updated wikimedia/utfnormal from 3.0.2 to 4.0.0.
258 ===== Changed development-only external libraries =====
259 * Updated mediawiki/mediawiki-codesniffer from 41.0.0 to 42.0.0.
260 * Updated mediawiki/mediawiki-phan-config from 0.12.1 to 0.13.0.
262 ==== Removed external libraries ====
263 * jquery.hoverIntent was removed.
264 * codex-search was removed, it's part of codex now.
265 * wikimedia/ip-set was removed, it's part of wikimedia/ip-utils now.
266 * jquery.color was removed.
267 * jquery.fullscreen was removed.
268 * jquery.form was removed.
270 === Action API changes in 1.41 ===
271 * (T322944) `Authorization` was added to the default list of headers
272   allowed for cross-origin API requests ($wgAllowedCorsHeaders).
274 === Languages updated in 1.41 ===
275 MediaWiki supports over 350 languages. Many localisations are updated regularly.
276 Below only new and removed languages are listed, as well as changes to languages
277 because of Phabricator reports.
279 * (T345807) Added language support for Karekare (kai).
280 * (T333765) Removed language support for Akan (Ak).
281 * (T332113) Added language support for Northern Hindko (hno).
282 * (T333425) Added language support for Iraqi (Mesopotamian) Arabic (acm).
283 * (T336919) Added language support for Crimean Tatar (Romania) (crh-ro).
284 * (T338416) Added language support for Betawi (bew).
285 * (T341545) Added language support for West Coast Bajau (a.k.a. Sama; bdr).
286 * (T332118) Namespace translations for Angika (anp) were added
287 * (T341942) The autonym of the Buginese language is changed to the Latin-script
288   name "Basa Ugi", and the localization in the language code "bug" is now only
289   in the Latin script. It's possible to add localization in the Lontara script
290   in translatewiki under the code "bug-bugi".
291 * (T341943) Main Page name translation was changed from "Leppa Indoë"
292   to "Watangpola". If you manage a wiki in this language, make sure that
293   links to the main page are correctly updated. See
294   https://translatewiki.net/w/i.php?title=Support&oldid=11723654#Change_MediaWiki:Mainpage/bug
296 === Breaking changes in 1.41 ===
297 * Article::doDelete(), deprecated since 1.37, has been removed.
298 * CommentStore::getStore(), deprecated since 1.31, has been removed.
299 * Article::getRedirectHeaderHtml() no longer accepts an array as $target.
300   Passing an array was deprecated in 1.39.  (The method itself has also
301   been deprecated.)
302 * BagOStuff::addBusyCallback(), deprecated since 1.39, has been removed.
303 * IExpiringStore has been removed, use either ExpirationAwareness or
304   StorageAwareness constants instead.
305 * IDatabase::wasErrorReissuable(), deprecated since 1.40, has been removed.
306 * IDatabase::lastQuery and IReadableDatabase::lastQuery, deprecated in 1.40,
307   have been removed.
308 * Database::queryMulti(), unused, has been removed without deprecation.
309   The protected Database::doMultiStatementQuery method was removed, and the
310   protected Database::executeQuery method signature was changed to take
311   Query object as argument instead of a raw SQL string.
312 * Database::unionConditionPermutations(), unused, has been removed without
313   deprecation.
314 * SimpleSearchResultSetWidget and SimpleSearchResultWidget classes, deprecated
315   in 1.31, have been removed.
316 * Database::factory(), deprecated in 1.39, has been removed.
317 * Calling IDatabase::delete() or IDatabase::update() with empty conditions
318   has been deprecated since 1.35. This now throws an error.
319 * Maintenance::shutdown() has been moved over into the MaintenanceRunner class
320   without deprecation.
321 * The following DatabasePostgres methods were unused and have been removed:
322   - ::currentSequenceValue()
323   - ::triggerExists()
324   - ::ruleExists()
325 * The following IDatabase methods were unused and removed without deprecation:
326   - ::wasLockTimeout()
327   - ::wasConnectionLoss()
328 * Database::getTempTableWrites(), previously protected, is now private.
329 * DatabasePostgres class parameter "keywordTableMap", deprecated since 1.37,
330   has been removed.
331 * Database::doUpsert() and ::doReplace() have been removed without deprecation.
332   Subclasses should override ::upsert() or ::replace() respectively.
333 * SelectQueryBuilder::lockForUpdate(), deprecated in 1.40 and unused,
334   has been removed without hard deprecation.
335 * TransactionProfiler::setSilenced() deprecated in 1.40, has been removed.
336 * ILoadBalancer::closeConnection, unused, has been removed without deprecation.
337 * ILoadBalancer::waitFor, unused, has been removed without deprecation.
338 * ILBFactory::resolveDomainID and ::getChronologyProtectorTouched, unused,
339   have been removed without deprecation.
340 * The following methods have been moved from ILoadBalancer to
341   ILoadBalancerForOwner:
342   - ::redefineLocalDomain()
343   - ::hasPrimaryConnection()
344   - ::setIndexAliases()
345 * LBFactory::makeCookieValueFromCPIndex() and ::getCPInfoFromCookieValue()
346   has been moved to ChronologyProtector class without backward compatability
347   as they are not supposed to be used outside of core.
348 * MWHttpRequest::factory(), deprecated since 1.34, has been removed.
349 * The Http class, deprecated since 1.34, with the functions ::request(),
350   ::get(), ::post(), ::userAgent(), ::isValidURI(), ::getProxy(),
351   ::createMultiClient() have been removed.
352 * WikiPage::factory(), ::newFromID() and ::newFromRow, deprecated in 1.36,
353   have been removed.
354 * Maintenance::$mArgList, ::shouldExecute(), ::setAgentAndTriggers(),
355   ::adjustMemoryLimit(), ::globals(), and ::loadSettings() have been removed.
356 * The GenericArrayObject class, deprecated in 1.40,
357   has been removed.
358 * The $replace parameter has been removed from HookContainer::scopedRegister.
359   This parameter was unused outside core, and the functionality was intended
360   for testing.
361 * PrevNextNavigationRenderer class, deprecated in 1.39,
362   has been removed.
363 * class alias MediaWiki\User\WatchlistNotificationManager, deprecated in 1.36,
364   has been removed.
365 * MediaWikiServices::getWatchlistNotificationManager(), deprecated in 1.36,
366   has been removed.
367 * Interface MediaWiki\Hook\ParserTestTablesHook, deprecated in 1.36,
368   has been removed.
369 * The NewPagesLineEndingHook now takes NewPagesPager instead of
370   SpecialNewpages as first argument.
371 * The following methods in the Title class, deprecated since 1.37, have been
372   removed:
373   - ::areCascadeProtectionSourcesLoaded()
374   - ::areRestrictionsCascading()
375   - ::areRestrictionsLoaded()
376   - ::getAllRestrictions()
377   - ::getCascadeProtectionSources()
378   - ::getFilteredRestrictionTypes()
379   - ::getRestrictionExpiry()
380   - ::getRestrictionTypes()
381   - ::getRestrictions()
382   - ::isCascadeProtected()
383   - ::isProtected()
384   - ::isSemiProtected()
385   - ::loadRestrictionsFromRows()
386 * Global function wfShowingResults, deprecated in 1.40, has been removed.
387 * Global function wfClearOutputBuffers, deprecated in 1.36, has been removed.
388 * LinkBatch::__construct() now requires that all parameters be passed. The
389   fallback to MediaWikiServices emitted deprecation notices since 1.35.
390 * The methods IndexPager::getPagingLinks(), IndexPager::getLimitLinks() and
391   IndexPager::buildPrevNextNavigation(), deprecated in 1.39,
392   have been removed.
393 * Overriding the method IndexPager::makeLink(), deprecated in 1.39,
394   is no longer possible.
395 * MagicWordFactory::getCacheTime() is deprecated and returns -1.
396 * Various mediawiki.less mediawiki.ui variables, deprecated in 1.35, have been
397   removed. See also below that the remaining mediawiki.ui variables are now also
398   deprecated.
399 * Calling getId() on an AbstractBlock from the wrong wiki, deprecated since
400   1.38, now throws an exception.
401 * SQLite no longer supports raw MySQL queries.
402 * The following functions from the mediawiki.mixins Less import, deprecated
403   since 1.37, have been removed: .transition(), .transition-transform(),
404   .transform() and .transform-origin().
405 * Support was dropped for skins with paths relative to core which has been
406   sending deprecation notices since 1.37. The skin `templateDirectory` key
407   should now always be relative to the skin.
408 * The Skin public thisquery property was removed without deprecation. Only
409   one skin was known to use it and that has been patched accordingly.
410 * The jquery.tipsy module, deprecated since 1.28, has now been removed.
411 * NamespaceInfo::getRestrictionLevels(), deprecated in 1.34, has been removed.
412   Use PermissionManager::getNamespaceRestrictionLevels() instead.
413 * Proto-relative external links are now stored and indexed only as HTTPS
414   instead of two rows, one for HTTP and one for HTTPS.
415 * MediaWikiIntegrationTestCase::getTestUser(), ::getTestSysop(), and
416   ::getMutableTestUser() have been made protected and non-static.
417 * MediaWikiIntegrationTestCase::$supportedDBs has been changed to a private
418   constant.
419 * MediaWikiIntegrationTestCase::addCoreDBData() has been deprecated. The method
420   is now a no-op and is no longer called. Tests should create the fixtures
421   they need.
422 * Saving preferences for a temporary user now throws an error (e.g. via
423   UserOptionsManager::saveOptions)
424 * ApiQuery::getNamedDB() and ApiQueryBase::selectNamedDB(), deprecated in
425   1.39, have been removed.
426 * ChangeTags::addTagsAccompanyingChangeWithChecks() and
427   ChangeTags::undefineTag() unused everywhere, have been removed without
428   deprecation.
429 * Usage of MediaWiki::preOutputCommit() with the $postCommitWork arg has been
430   dropped. It's no longer used.
431 * SkinTemplateNavigation and SkinTemplateNavigation::SpecialPage hooks,
432   deprecated in 1.39, have been removed.
433 * The PersonalUrls hook, deprecated in 1.39, has been removed.
434 * OutputPage::getCSPNonce(), soft deprecated in 1.35, now emits deprecation
435   warnings.
436 * Support of the third parameter of LogEventsListGetExtraInputs hook,
437   deprecated since 1.32, has been removed.
438 * JobSpecification::getTitle(), deprecated in 1.37, has been removed.
439 * The module mw.ui.anchor has been removed. Projects that need it should
440   maintain a local copy or use the Codex link mixin. More information
441   at T235961.
442 * ParsoidCachePrewarmJob::newSpec() now requires a PageRecord as the second
443   parameter instead of a page ID.
444 * Public access to the DifferenceEngine properties mOldid, mNewid, mOldRev,
445   mNewRev, mOldPage, mNewPage, mOldContent, mNewContent, mRevisionsLoaded,
446   mTextLoaded and mCacheHit, deprecated in 1.32, was removed.
447 * SearchDatabase::db, deprecated since 1.38, has been removed.
448 * SearchDatabase::lb has been removed without deprecation, use ::dbProvider
449   instead.
450 * StreamFile::STREAM_HEADLESS and StreamFile::STREAM_ALLOW_OB, deprecated
451   in 1.34, have been removed.
452 * AbstractAuthenticationProvider::setLogger(), ::setManager(), ::setConfig()
453   and ::setHookContainer() have been removed and also from it's related
454   interface, AuthenticationProvider. The corresponding properties are set in
455   AbstractAuthenticationProvider::init(). For side effects, you can override
456   AbstractAuthenticationProvider::postInitSetup().
457 * Title::newFromTitleValue(), deprecated since 1.34, has been removed.
458 * Parser::OT_MSG, related to OT_MSG(3) MediaWiki constant, parameter for
459   starting external parse has been dropped. This was kept since 2008 for B/C
460   only and no longer used. Use instead Parser::OT_PREPROCESS as the
461   replacement.
462 * SpecialPageAction has been removed without deprecation. There were no known
463   uses outside of core.
464 * ConfigRepository::getValueOf() has been removed without deprecation. This
465   method was introduced and never used for a long time now.
466 * BacklinkCache::get(), ::getLinks(), ::getCascadeProtectedLinks() which
467   emitted deprecation warnings has no usage left. It has been removed.
468 * The following constants and methods in the Language class, hard deprecated
469   since 1.40, have been removed:
470   - ::ALL
471   - ::SUPPORTED
472   - ::MESSAGES_FALLBACKS
473   - ::STRICT_FALLBACKS
474   - ::factory()
475   - ::isSupportedLanguage()
476   - ::isWellFormedLanguageTag()
477   - ::isValidCode()
478   - ::isValidBuiltInCode()
479   - ::isKnownLanguageTag()
480   - ::getLocalisationCache()
481   - ::fetchLanguageNames()
482   - ::fetchLanguageName()
483   - ::getConverter()
484   - ::autoConvert()
485   - ::autoConvertToAllVariants()
486   - ::convert()
487   - ::convertNamespace()
488   - ::hasVariants()
489   - ::hasVariant()
490   - ::convertHtml()
491   - ::convertCategoryKey()
492   - ::getVariants()
493   - ::getPreferredVariant()
494   - ::getDefaultVariant()
495   - ::getURLVariant()
496   - ::getExtraHashOptions()
497   - ::getParentLanguage()
498   - ::getFileName()
499   - ::getMessagesFileName()
500   - ::getJsonMessagesFileName()
501   - ::getFallbackFor()
502   - ::getFallbacksFor()
503   - ::getFallbacksIncludingSiteLanguage()
504   - ::getMessagesFor()
505   - ::getMessageFor()
506   - ::getMessageKeysFor()
507   - ::getConvRuleTitle()
508 * The parameter noSeparators to Language::formatNum, deprecated since 1.36,
509   has been removed. Use Language::formatNumNoSeparators instead.
510 * The following methods in the ParserOutput class, deprecated since 1.38, have
511   been removed:
512   - ::addOutputHook()
513   - ::addTrackingCategory()
514   - ::addWarning()
515   - ::getCategoryLinks()
516   - ::getOutputHooks()
517   - ::getProperties()
518   - ::getProperty()
519   - ::hasDynamicContent()
520   - ::hideNewSection()
521   - ::preventClickjacking()
522   - ::setCategoryLinks()
523   - ::setProperty()
524   - ::unsetProperty()
525 * OutputPage::allowClickjacking() and ::preventClickjacking(), deprecated
526   since 1.38, have been removed.
527 * ResourceFileCache has been removed without deprecation. There were no known
528   uses outside of core.
529 * Many LocalisationCache constants, properties and methods that have no known
530   usage outside of the class have been made private without deprecation.
531 * User::idFromName(), deprecated in 1.37, has been removed. Instead, you should
532   use UserIdentityLookup::getUserIdentityByName().
533 * User::incEditCount(), deprecated in 1.37, has been removed. Instead, use
534   UserEditTracker::incrementUserEditCount().
535 * Article::getTimestamp(), deprecated in 1.35, has been removed. Use WikiPage's
536   or RevisionRecord's version of this method instead.
537 * ActionFactory::actionExists(), deprecated since 1.38, has been dropped.
538 * Action::exists(), deprecated since 1.38, has been dropped.
539 * ContentHandler::getForTitle(), deprecated since 1.35, has been dropped.
540 * LockManagerGroup::getDefault() and ::getAny(), deprecated since 1.35, have
541   been dropped.
542 * BaseTemplate::getToolbox(), deprecated since 1.35, has been dropped. To add
543   items to the toolbox, use the SidebarBeforeOutput hook. To get the toolbox,
544   subclasses can use $this->data['sidebar']['TOOLBOX'].
545 * IndexPager::getHookContainer(), deprecated since 1.40, has been removed. You
546   should instead inject a HookContainer into your code.
547 * Not specifying a manifest_version in your extension.json or skin.json file,
548   deprecated since 1.26 and emitting warnings since 1.29, is no longer supported
549   with a fallback; it will now have unspecified behaviour.
550 * RecentChange::getEngine(), deprecated since 1.29, has been removed. Use
551   RCFeed::factory() instead.
552 * EditPage::showEditForm() no longer respects the $formCallback parameter, which
553   was deprecated in 1.25. Use the EditPage::showEditForm:fields hook instead.
554 * The following properties in EditPage, deprecated in 1.38, were made private:
555   - $mArticle
556   - $mTitle
557   - $isNew
558   - $allowBlankArticle
559   - $selfRedirect
560   - $allowSelfRedirect
561   - $diff
562   - $undoAfter
563   - $edit
564   - $contentLength
565 * EditPage::addNewLineAtEnd(), deprecated since 1.38, was removed.
566 * AuthManager::checkAccountCreatePermissions(), deprecated in 1.39, has been
567   removed. Use authorizeCreateAccount() or probablyCanCreateAccount() instead.
568 * LinkCache::addGoodLinkObj(), deprecated in 1.37, has been removed. You should
569   use ::addGoodLinkObjFromRow().
570 * Constructing TextConflictHelper without a ContentHandlerFactory, deprecated
571   since 1.35, will now trigger a type error.
572 * JobQueue::getWiki(), deprecated in 1.33, has been removed.
573 * ManualLogEntry::setTags(), deprecated in 1.33, has been removed.
574 * WikiPage::getDeletionUpdates(), deprecated in 1.37, has been removed.
575 * ResourceLoader\Context::getConfig(), deprecated in 1.34, has been removed.
576 * When creating a SearchUpdate instance, passing a non-Content string or Boolean
577   as the $c parameter, deprecated since 1.34, will now trigger type errors.
578 * SkinTemplate::getNameSpaceKey(), deprecated in 1.35, has been dropped. Instead
579   you should use Title::getNamespaceKey().
580 * The AddNewAccount hook, deprecated since 1.27, will now trigger deprecation
581   warnings. You should use the LocalUserCreated hook instead.
582 * The PrefixSearchBackend hook, deprecated since 1.27, will now trigger
583   deprecation warnings. Override SearchEngine::completionSearchBackend instead.
584 * PrefixSearch::validateNamespaces(), completely unused everywhere, has been
585   removed without deprecation.
586 * BaseTemplate::getTrail() and ::printTrail(), deprecated since 1.39, have been
587   dropped.
588 * Passing a second query parameter to Title::getFullURL(), Title::getLocalURL(),
589   Title::getInternalURL(), or Title::getCanonicalURL(), each deprecated in 1.19,
590   is now not supported. Pass it as a key,value pair in the first parameter array
591   instead.
592 * Title::getBacklinkCache(), deprecated since 1.37, has been dropped. Instead,
593   use BacklinkCacheFactory::getBacklinkCache().
594 * Title::newFromIDs and TitleFactory::newFromIDs, deprecated in 1.38, have been
595   dropped; use a PageStore QueryBuilder instead.
596 * Title::getSelectFields(), deprecated since 1.36, has been dropped. You can use
597   PageStore::newSelectQueryBuilder() instead.
598 * Title::getTouched() will now trigger an error if you pass it an instance of
599   IDatabase rather than a READ_XXX constant. This legacy behaviour has been
600   deprecated since 1.38.
601 * User::getGroupPermissions(), getGroupsWithPermission() & groupHasPermission(),
602   all of which were deprecated since 1.34, have been removed. Instead, use the
603   GroupPermissionsLookup service.
604 * Similarly, PermissionManager::getGroupPermissions(), getGroupsWithPermission()
605   & groupHasPermission(), all of which were deprecated since 1.36, have also
606   been removed. Instead, use the GroupPermissionsLookup service.
607 * The following old, deprecated aliases for classes in the RDBMS layer, have now
608   been removed:
609    - DBConnRef (use Wikimedia\Rdbms\DBConnRef)
610    - Database (use Wikimedia\Rdbms\Database)
611    - DatabaseBase (use Wikimedia\Rdbms\Database)
612    - DatabaseMysqlBase (use Wikimedia\Rdbms\DatabaseMySQL)
613    - DatabaseMysqli (use Wikimedia\Rdbms\DatabaseMySQL)
614    - DatabasePostgres (use Wikimedia\Rdbms\DatabasePostgres)
615    - DatabaseSqlite (use Wikimedia\Rdbms\DatabaseSqlite)
616    - IDatabase (use Wikimedia\Rdbms\IDatabase)
617    - FakeResultWrapper (use Wikimedia\Rdbms\FakeResultWrapper)
618    - ResultWrapper (use Wikimedia\Rdbms\ResultWrapper)
619 * The following old, deprecated aliases for classes have now been removed:
620    - MediaWiki\Rest\Handler\HtmlInputTransformHelper
621    - MediaWiki\Rest\Handler\HtmlMessageOutputHelper
622    - MediaWiki\Rest\Handler\HtmlOutputRendererHelper
623    - MediaWiki\Rest\Handler\PageContentHelper
624    - MediaWiki\Rest\Handler\PageRestHelperFactory
625    - MediaWiki\Rest\Handler\ParsoidFormatHelper
626    - MediaWiki\Rest\Handler\RevisionContentHelper
627   (use the classes from namespace MediaWiki\Rest\Handler\Helper)
628    - SearchNearMatcher (use MediaWiki\Search\TitleMatcher)
629 * $CHANGEDORCREATED argument of 'enotif_body' message was removed.
630   It wasn't used in the default messages since 1.21.
631 * The AbstractBlock and DatabaseBlock public properties mExpiry, mHideName,
632   mTimestamp, mAuto and mParentBlockId, deprecated since 1.34, have been
633   removed.
634 * WikiPage::doDeleteUpdates() and ::getDeletionUpdates(), deprecated in 1.37,
635   have been removed.
636 * The User public properties mOptions, mBlock, mBlockedby and mHideName,
637   deprecated since 1.35, were removed.
638 * User::CHECK_USER_RIGHTS and User::IGNORE_USER_RIGHTS were removed. They were
639   flags passed to methods which were previously removed.
640 * All public properties of LinksUpdate, deprecated in 1.38, were removed.
641 * The class Wikimedia\Rdbms\MySQLMasterPos, deprecated in 1.37, has been
642   removed. Use Wikimedia\Rdbms\MySQLPrimaryPos instead.
643 * The class GetBlockErrorMessageKey, deprecated in 1.40, has been removed.
644 * The ability to set Parser::mTitle to null, deprecated in 1.34, was removed.
645 * The following MagicWord methods have been removed without deprecation. There
646   were no known uses.
647   - ::addToArray
648   - ::compareStringLength
649   - ::getVariableRegex
650   - ::getVariableStartToEndRegex
651   - ::getWasModified
652   - ::matchStart
653   - ::matchVariableStartToEnd
654   - ::pregRemoveAndRecord
655   - ::substituteCallback
656 * The following MagicWordArray methods have been removed or made private without
657   deprecation. There were no known uses outside of the class.
658   - ::addArray
659   - ::getRegex, already marked as @internal, now private
660   - ::getRegexStart, already marked as @internal, now private
661   - ::getVariableRegex, deprecated since 1.36
662   - ::getVariableStartToEndRegex, already marked as @internal, now private
663   - ::parseMatch, now private
664 * AbstractContent::getRedirectChain() and ::getUltimateRedirectTarget(), both
665   deprecated in 1.38, have been removed.
667 === Deprecations in 1.41 ===
668 * The MessageCache::get hook is deprecated for performance reasons. Use
669   MessageCacheFetchOverrides instead.
670 * EtcdConfig::setLogger() is deprecated as it was unused and could not be
671   used correctly. As a standalone class, its warnings now surface
672   unconditionally via the native PHP error log.
673 * The interface for hook ParserModifyImageHTML have been renamed from
674   ParserModifyImageHTML to ParserModifyImageHTMLHook,
675   the old name is deprecated.
676 * (T178356) The es6-polyfills module is deprecated and is now a no-op.
677 * SerializedValueContainer::newUnified() is unused and now emits deprecation
678   warnings.
679 * Profiler::setProfileID() and ::getAllowOutput() are now deprecated and also
680   emit deprecation warnings. For ::setProfileID(), override the related class
681   member directly in sub-class.
682 * (T166010) All PHP code in MediaWiki is slowly being moved to be in a class
683   namespace as appropriate, so that we can use PSR-4 auto-loading, which will
684   speed up general code loading of MediaWiki. The old global namespace class
685   names are being left behind as deprecated aliases.
687   In this release of MediaWiki, 1661 classes now have a namespace and 972 do
688   not yet (63% done, up from 54% in MediaWiki 1.40.0). The following have newly
689   been moved:
690   - MediaWiki\Config:
691     - Config
692     - ConfigException
693     - ConfigFactory
694     - EtcdConfig
695     - EtcdConfigParseError
696     - GlobalVarConfig
697     - HashConfig
698     - MultiConfig
699     - MutableConfig
700     - SiteConfiguration
701   - MediaWiki\EventRelayer:
702     - EventRelayer
703     - EventRelayerNull
704     - EventRelayerGroup
705   - MediaWiki\Installer:
706     - Pingback
707   - MediaWiki\Libs:
708     - Emptiable
709   - MediaWiki\Output:
710     - OutputPage
711     - OutputHandler
712     - StreamFile
713   - MediaWiki\Pager:
714     - ActiveUsersPager
715     - AllMessagesTablePager
716     - AlphabeticPager
717     - BlockListPager
718     - CategoryPager
719     - ContribsPager
720     - DeletedContribsPager
721     - HistoryPager
722     - ImageListPager
723     - IndexPager
724     - LogPager
725     - MergeHistoryPager
726     - NewFilesPager
727     - NewPagesPager
728     - Pager
729     - PagerTools
730     - ProtectedPagesPager
731     - ProtectedTitlesPager
732     - RangeChronologicalPager
733     - ReverseChronologicalPager
734     - TablePager
735     - UsersPager
736   - MediaWiki\Parser:
737     - Sanitizer
738   - MediaWiki\Request:
739     - ProxyLookup
740     - WebRequest
741   - MediaWiki\SiteStats:
742     - SiteStats
743     - SiteStatsInit
744   - MediaWiki\Specials:
745     - SpecialActiveUsers
746     - SpecialAllMessages
747     - SpecialAncientPages
748     - SpecialApiHelp
749     - SpecialApiSandbox
750     - SpecialAutoblockList
751     - SpecialBlankpage
752     - SpecialBlock
753     - SpecialBlockList
754     - SpecialBookSources
755     - SpecialBotPasswords
756     - SpecialBrokenRedirects
757     - SpecialCategories
758     - SpecialChangeContentModel
759     - SpecialChangeCredentials
760     - SpecialChangeEmail
761     - SpecialChangePassword
762     - SpecialComparePages
763     - SpecialConfirmEmail
764     - SpecialContribute
765     - SpecialContributions
766     - SpecialCreateAccount
767     - SpecialDeadendPages
768     - SpecialDeletePage
769     - SpecialDeletedContributions
770     - SpecialDiff
771     - SpecialDoubleRedirects
772     - SpecialEditPage
773     - SpecialEditTags
774     - SpecialEditWatchlist
775     - SpecialEmailInvalidate
776     - SpecialEmailUser
777     - SpecialExpandTemplates
778     - SpecialExport
779     - SpecialFewestRevisions
780     - SpecialFileDuplicateSearch
781     - SpecialFilepath
782     - SpecialGoToInterwiki
783     - SpecialImport
784     - SpecialJavaScriptTest
785     - SpecialLinkAccounts
786     - SpecialLinkSearch
787     - SpecialListDuplicatedFiles
788     - SpecialListFiles
789     - SpecialListGrants
790     - SpecialListGroupRights
791     - SpecialListRedirects
792     - SpecialListUsers
793     - SpecialLockdb
794     - SpecialLog
795     - SpecialLonelyPages
796     - SpecialLongPages
797     - SpecialMIMESearch
798     - SpecialMediaStatistics
799     - SpecialMergeHistory
800     - SpecialMostCategories
801     - SpecialMostInterwikis
802     - SpecialMostLinked
803     - SpecialMostLinkedCategories
804     - SpecialMostLinkedTemplates
805     - SpecialMostRevisions
806     - SpecialMute
807     - SpecialMyLanguage
808     - SpecialNewFiles
809     - SpecialNewPages (and capitalisation corrected)
810     - SpecialNewSection
811     - SpecialPageData
812     - SpecialPageHistory
813     - SpecialPageInfo
814     - SpecialPageLanguage
815     - SpecialPagesWithProp
816     - SpecialPasswordPolicies
817     - SpecialPasswordReset
818     - SpecialPermanentLink
819     - SpecialPreferences
820     - SpecialPrefixIndex (and capitalisation corrected)
821     - SpecialProtectedPages (and capitalisation corrected)
822     - SpecialProtectedTitles (and capitalisation corrected)
823     - SpecialProtectPage
824     - SpecialPurge
825     - SpecialRandomInCategory
826     - SpecialRandom
827     - SpecialRandomRedirect
828     - SpecialRandomRootPage
829     - SpecialRecentChanges
830     - SpecialRecentChangesLinked
831     - SpecialRedirect
832     - SpecialRedirectToSpecial
833     - SpecialRemoveCredentials
834     - SpecialRenameUser (and capitalisation corrected)
835     - SpecialResetTokens
836     - SpecialRevisionDelete
837     - SpecialRunJobs
838     - SpecialSearch
839     - SpecialShortPages
840     - SpecialSpecialPages (and capitalisation corrected)
841     - SpecialStatistics
842     - SpecialTags
843     - SpecialTrackingCategories
844     - SpecialUnblock
845     - SpecialUncategorizedCategories
846     - SpecialUncategorizedImages
847     - SpecialUncategorizedPages
848     - SpecialUncategorizedTemplates
849     - SpecialUndelete
850     - SpecialUnlinkAccounts
851     - SpecialUnlockdb
852     - SpecialUnusedCategories
853     - SpecialUnusedImages
854     - SpecialUnusedTemplates
855     - SpecialUnwatchedPages
856     - SpecialUpload
857     - SpecialUploadStash
858     - SpecialUserLogin
859     - SpecialUserLogout
860     - SpecialVersion
861     - SpecialWantedCategories
862     - SpecialWantedTemplates
863     - SpecialWatchlist
864     - SpecialWhatLinksHere
865     - SpecialWithoutInterwiki
866   - MediaWiki\Specials\Redirects:
867     - SpecialAllMyUploads
868     - SpecialListAdmins
869     - SpecialListBots
870     - SpecialMycontributions
871     - SpecialMylog
872     - SpecialMypage
873     - SpecialMytalk
874     - SpecialMyuploads
875   - MediaWiki\SpecialPage:
876     - AuthManagerSpecialPage
877     - ChangesListSpecialPage
878     - DisabledSpecialPage
879     - FormSpecialPage
880     - ImageQueryPage
881     - IncludableSpecialPage
882     - LoginSignupSpecialPage
883     - PageQueryPage
884     - QueryPage
885     - RedirectSpecialArticle
886     - RedirectSpecialPage
887     - SpecialPage
888     - SpecialRedirectToSpecial
889     - SpecialRedirectWithAction
890     - UnlistedSpecialPage
891     - WantedQueryPage
892   - MediaWiki\Status:
893     - Status
894   - MediaWiki\Title:
895     - ForeignTitle
896     - ForeignTitleFactory
897     - ImportTitleFactory
898     - MalformedTitleException
899     - MediaWikiTitleCodec
900     - NaiveForeignTitleFactory
901     - NaiveImportTitleFactory
902     - NamespaceAwareForeignTitleFactory
903     - NamespaceImportTitleFactory
904     - NamespaceInfo
905     - SubpageImportTitleFactory
906     - TitleFormatter
907     - TitleParser
908     - TitleValue
909   - MediaWiki\User:
910     - BotPassword
911     - ExternalUserNames
912     - LoggedOutEditToken
913     - PasswordReset
914     - User
915     - UserArray
916     - UserArrayFromResult
917     - UserGroupMembership
918     - UserRightsProxy
919   - MediaWiki\User\CentralId:
920     - CentralIdLookup
921     - LocalIdLookup
922   - MediaWiki\Utils:
923     - MWTimestamp
924     - GitInfo
925     - ExtensionInfo (previously under MediaWiki\ExtensionInfo)
926   - Wikimedia\Rdbms:
927     - ConfiguredReadOnlyMode
928     - ReadOnlyMode
929 * Various mediawiki.ui variables have been deprecated in favor of
930   'mediawiki.skin.variables.less' Codex design tokens featuring replacements.
931 * Hook handlers must now be specified either as a PHP callable, or as a PHP
932   object that has a method matching the hook name. Other ways to specify
933   the handler are deprecated and will soon be removed. Deprecated ways to
934   specify a hook handler include callables wrapped in an array. Handlers
935   defined using a "HookHandlers" entry in extension.json are not affected.
936 * TitleArray::newFromResult() has been deprecated and now emits deprecation
937   warnings, use TitleArrayFromResults instead.
938 * The MediaWikiIntegrationTestCase::$users has been deprecated. Use Authority
939   if possible, or call ::getTestUser() or ::getTestSysop() directly.
940 * WebRequest::isSafeRequest() and ::markAsSafeRequest() has been deprecated
941   and now emits deprecation warnings. Use ::hasSafeMethod() instead.
942 * The tests/phpunit/phpunit.php entrypoint has been deprecated. PHPUnit
943   tests should be run with composer, for example with the
944   `composer phpunit:entrypoint` command.
945 * The unnamespace UserNamePrefixSearch class, deprecated in 1.36, now emits
946   deprecation warnings. Use the MediaWiki\User\UserNamePrefixSearch service.
947 * The jquery.cookie ResourceLoader module has been merged into the existing
948   mediawiki.cookie module; jquery.cookie remains but is deprecated.
949 * Passing a database to DatabaseBlockStore::insertBlock() is deprecated.
950   DatabaseBlockStoreFactory should be used to fetch a correct
951   DatabaseBlockStore instead.
952 * The global function wfGetLangObj is deprecated and emits deprecation
953   warnings. Use MediaWiki\Languages\LanguageFactory::getLanguage instead.
954 * The SwiftVirtualRESTService class is deprecated in 1.41 and now emits
955   deprecation warnings.
956 * SqlBagOStuff::expireAll() is deprecated and now emits deprecation warnings,
957   use SqlBagOStuff::deleteObjectsExpiringBefore() instead.
958 * SqlBagOStuff::deleteAll() is deprecated and now emits deprecation warnings.
959 * Passing an actor id to the UserIdentityValue constructor is now emits
960   deprecation warnings, it is deprecated since 1.36.
961 * UserGroupMembership::getGroupName(), deprecated in 1.38, and
962   UserGroupMembership::getGroupMemberName(), deprecated in 1.40, now emit
963   deprecation warnings.
964 * UserGroupMembership::getLink() has been deprecated in favour of
965   ::getLinkHTML() and ::getLinkWiki().
966 * Linker::formatComment(), ::formatLinksInComment(), ::commentBlock() and
967   ::revComment(), deprecated in 1.38, now emit deprecation warnings.
968 * PageArchive::listRevisions(), ::getRevisionRecordByTimestamp(),
969   ::getArchivedRevisionRecord(), ::getPreviousRevisionRecord(),
970   ::getLastRevisionId() and ::isDeleted(), deprecated in 1.38,
971   now emit deprecation warnings.
972 * SearchResultThumbnail::getSize() has been deprecated to be dropped in the
973   future as it is resource intensive and degrades performance.
974 * The EmailUserPermissionsErrors and UserCanSendEmail hooks have been
975   deprecated in favour of the EmailUserAuthorizeSend hook.
976 * The EmailUser hook has been deprecated in favour of the EmailUserSendEmail
977   hook.
978 * The InterwikiLoadPrefix hook now emits deprecation warnings. Resetting the
979   $wgInterwikiCache setting instead.
980 * SiteConfiguration::getConfig() now emits deprecation warnings, Use ::get()
981   instead.
982 * SiteConfiguration::extractVar() and ::extractGlobal() have been deprecated
983   and also emit deprecation warnings.
984 * JobQueueGroup::waitForBackups() is deprecated. JobQueue::waitForBackups()
985   should be used instead.
986 * Hooks::isRegistered(), ::getHandlers(), ::run() and ::runWithoutAbort(),
987   deprecated in 1.35, now emit deprecation warnings.
988 * VirtualRESTService class and its subclasses now emit deprecation warnings
989   in 1.41 and as a replacement we can use MultiHttpClient.
990 * Calling the MediaWikiServices::getVirtualRESTServiceClient() function
991   which creates the VirtualRESTServiceClient now emits deprecation warnings.
992 * Language::getMessage and Language::getAllMessages are deprecated. Use
993   LocalisationCache or MessageCache as appropriate.
994 * VirtualRESTService class is deprecated in 1.41 and as a replacement
995   we can use MultiHttpClient.
996 * MediaWikiServices::getConfiguredReadOnlyMode() is deprecated. Use
997   ::getReadOnlyMode() instead. ReadOnlyMode::getConfiguredReason()
998   and ::isConfiguredReadOnly() has been added to support that.
999 * UploadBase::isThrottled() has been deprecated and is emitting deprecation
1000   warnings. Rate limits are enforced by UploadBase::verifyTitlePermissions(),
1001   since rate limit checks are now implicit in permission checks.
1002 * JobSpecification::toSerializableArray() now emits deprecation warnings.
1003 * The following skin methods were deprecated:
1004   - Skin::makeSpecialUrl (use Title or Special class instead)
1005   - Skin::makeSpecialUrlSubpage (use Title or Special class instead)
1006 * mw.jqueryMsg.parser, deprecated in 1.31, now emits deprecation warnings.
1007 * ResourceLoader (T127268): The targets system is deprecated. Modules that
1008   have been marked as desktop or mobile only are no longer supported and
1009   will send deprecation warnings.
1010 * TextSlotDiffRenderer::setLanguage() is deprecated, and calling it will
1011   have no effect. Use ContentHandler::getSlotDiffRenderer(), or in subclasses,
1012   ContentHandler::createTextSlotDiffRenderer(), to correctly inject
1013   dependencies into TextSlotDiffRenderer.
1014 * The static methods encodeJsVar() and encodeJsCall() have been moved from the
1015   Xml class to the more appropriate MediaWiki\Html\Html one, and the old ones
1016   are now deprecated.
1017 * Some work to rename classes was done in previous releases, but the renaming
1018   was not noted at the time. The old aliases work for now but are deprecated;
1019   this is now explicitly noted:
1020   From 1.40:
1021   - Category -> MediaWiki\Category\Category
1022   - CategoriesRdf -> MediaWiki\Category\CategoriesRdf
1023   - CategoryViewer -> MediaWiki\Category\CategoryViewer
1024   - TrackingCategories -> MediaWiki\Category\TrackingCategories
1025   - CommentStore -> MediaWiki\CommentStore\CommentStore
1026   - CommentStoreComment -> MediaWiki\CommentStore\CommentStoreComment
1027   - EditPage -> MediaWiki\EditPage\EditPage
1028   - TemplatesOnThisPageFormatter
1029     -> MediaWiki\EditPage\TemplatesOnThisPageFormatter
1030   - LinkFilter -> MediaWiki\ExternalLinks\LinkFilter
1031   - AtomFeed -> MediaWiki\Feed\AtomFeed
1032   - ChannelFeed -> MediaWiki\Feed\ChannelFeed
1033   - FeedItem -> MediaWiki\Feed\FeedItem
1034   - FeedUtils -> MediaWiki\Feed\FeedUtils
1035   - RSSFeed -> MediaWiki\Feed\RSSFeed
1036   - Html -> MediaWiki\Html\Html
1037   - FormOptions -> MediaWiki\Html\FormOptions
1038   - HtmlHelper -> MediaWiki\Html\HtmlHelper
1039   - ListToggle -> MediaWiki\Html\ListToggle
1040   - TemplateParser -> MediaWiki\Html\TemplateParser
1041   - RawMessage -> MediaWiki\Language\RawMessage
1042   - FileDeleteForm -> MediaWiki\Page\File\FileDeleteForm
1043   - MergeHistory -> MediaWiki\Page\File\MergeHistory
1044   - MovePage -> MediaWiki\Page\File\MovePage
1045   - ProtectionForm -> MediaWiki\Page\File\ProtectionForm
1046   - MediaWiki\BadFileLookup -> MediaWiki\Page\File\BadFileLookup
1047   - PageProps -> MediaWiki\Page\PageProps
1048   - MagicWord -> MediaWiki\Parser\MagicWord
1049   - MagicWordArray -> MediaWiki\Parser\MagicWordArray
1050   - MagicWordFactory -> MediaWiki\Parser\MagicWordFactory
1051   - Linker -> MediaWiki\Linker\Linker
1052   - DummyLinker -> MediaWiki\Linker\DummyLinker
1053   - ForkController -> MediaWiki\Maintenance\ForkController
1054   - OrderedStreamingForkController
1055     -> MediaWiki\Maintenance\OrderedStreamingForkController
1056   - ContentSecurityPolicy -> MediaWiki\Request\ContentSecurityPolicy
1057   - DerivativeRequest -> MediaWiki\Request\DerivativeRequest
1058   - FauxRequest -> MediaWiki\Request\FauxRequest
1059   - FauxRequestUpload -> MediaWiki\Request\FauxRequestUpload
1060   - PathRouter -> MediaWiki\Request\PathRouter
1061   - WebRequestUpload -> MediaWiki\Request\WebRequestUpload
1062   - FauxResponse -> MediaWiki\Request\FauxResponse
1063   - WebResponse -> MediaWiki\Request\WebResponse
1064   - MediaWiki\HeaderCallback -> MediaWiki\Request\HeaderCallback
1065   - StubObject -> MediaWiki\StubObject\StubObject
1066   - DeprecatedGlobal -> MediaWiki\StubObject\DeprecatedGlobal
1067   - StubGlobalUser -> MediaWiki\StubObject\StubGlobalUser
1068   - StubUserLang -> MediaWiki\StubObject\StubUserLang
1069   - Title -> MediaWiki\Title\Title
1070   - TitleArray -> MediaWiki\Title\TitleArray
1071   - TitleArrayFromResult -> MediaWiki\Title\TitleArrayFromResult
1072   - TitleFactory -> MediaWiki\Title\TitleFactory
1073   - ActorMigration -> MediaWiki\User\ActorMigration
1074   - ActorMigrationBase -> MediaWiki\User\ActorMigrationBase
1075   - WikiMap -> MediaWiki\WikiMap\WikiMap
1076   - WikiReference -> MediaWiki\WikiMap\WikiReference
1077   From 1.39:
1078   - ResourceLoader -> MediaWiki\ResourceLoader\ResourceLoader
1079   From 1.29:
1080   - IMaintainableDatabase -> Wikimedia\Rdbms\IMaintainableDatabase
1081 * The WebRequest::getRequestId() and WebRequest::overrideRequestId() are
1082   deprecated. Use methods from MediaWiki\Http\Telemetry class instead.
1083 * The XmlJsCode wrapper class has been renamed to MediaWiki\Html\HtmlJsCode,
1084   and the old name is now deprecated.
1085 * The use of non-serializable arguments to ParserOutput::addWarningMsg() has
1086   been deprecated and will emit deprecation warnings.
1087 * Class UserRightsProxy, deprecated since 1.38, now emits
1088   deprecation warnings from its factory functions.
1089 * MediaWiki\ResourceLoader\Module::getDeprecationInformation() is deprecated.
1090   Use ::getDeprecationWarning() instead.
1091 * Passing a Message to OutputPage::setPageTitle() is deprecated.
1092   Use ::setPageTitleMsg() instead (which escapes HTML metacharacters).
1093 * Passing arguments to OutputPage::prepareErrorPage() is deprecated.
1094   Use explicit calls to OutputPage::setPageTitleMsg() and ::setHTMLTitle()
1095   instead.
1096 * Returning a string from Action::getPageTitle() is deprecated;
1097   return a Message instead, which will be formatted using FORMAT_ESCAPED.
1098 * Returning a string from SpecialPage::getDescription() is deprecated;
1099   return a Message instead, which will be formatted using FORMAT_ESCAPED.
1100 * MediaWiki\Block\AbstractBlock::getReason(), deprecated since 1.35, now emits
1101   deprecation warnings. Use ::getReasonComment() instead.
1102 * User::getGroups(), ::addGroup(), ::removeGroup(), ::getGroupMemberships(),
1103   ::getAllGroups(), ::getImplicitGroups(), deprecated since 1.35, now emit
1104   deprecation warnings.
1105 * The global function wfReportTime(), deprecated since 1.40, now emits
1106   deprecation warnings. The SkinTemplate parameter 'reporttime' is deprecated.
1107 * RevisionStore::getQueryInfo() and RevisionFactory::getQueryInfo() have been
1108   deprecated. Use ::newSelectQueryBuilder() instead.
1109 * Following methods in rdbms library have been made internal:
1110   - IDatabase::getLBInfo()
1111   - IDatabase::setLBInfo()
1112   - IDatabase::insert() Use InsertQueryBuilder instead.
1113   - IDatabase::update() Use UpdateQueryBuilder instead.
1114   - IDatabase::replace() Use ReplaceQueryBuilder instead.
1115   - IDatabase::upsert() Use InsertQueryBuilder instead.
1116   - IDatabase::delete() Use DeleteQueryBuilder instead.
1117   - IReadableDatabase::selectField() Use SelectQueryBuilder instead.
1118   - IReadableDatabase::selectFieldValues() Use SelectQueryBuilder instead.
1119   - IReadableDatabase::select() Use SelectQueryBuilder instead.
1120   - IReadableDatabase::selectRow() Use SelectQueryBuilder instead.
1121   - IReadableDatabase::estimateRowCount() Use SelectQueryBuilder instead.
1122   - IReadableDatabase::selectRowCount() Use SelectQueryBuilder instead.
1123   - ISQLPlatform::unionQueries() Use UnionQueryBuilder instead.
1124 * The core Wikimedia\Rdbms\DatabaseMysqlBase class has been renamed to reflect
1125   the earlier merger of Mysqli into it; it's now Wikimedia\Rdbms\DatabaseMySQL.
1126 * The following methods in SpecialEmailUser have been deprecated:
1127   - SpecialEmailUser::validateTarget(), use EmailUser::validateTarget()
1128   - SpecialEmailUser::getPermissionsError(), use EmailUser::canSend() or
1129     EmailUser::authorizeSend()
1130   - SpecialEmailUser::submit(), use EmailUser::sendEmailUnsafe()
1131 * User::isBlockedFromEmailuser() has been deprecated. EmailUser::canSend()
1132   checks blocks amongst other things. If you only need this check, use
1133   User::getBlock()->appliesToRight( 'sendemail' ).
1134 * User::canSendEmail() has been deprecated. Use EmailUser::canSend() instead.
1135 * The following methods, previously deprecated, now emit deprecation warnings:
1136   - ConfigFactory::getDefaultInstance(), deprecated since 1.27
1137   - AbstractContent::getNativeData(), deprecated since 1.33
1138   - TablePager::getBody(), deprecated since 1.24
1139   - ContentHandler::getSlotDiffRendererInternal(), deprecated since 1.35
1140   - ParserOutput::getCategories(), deprecated since 1.40
1141   - PasswordFactory::init(), deprecated since 1.32
1142 * WikitextContent::getRedirectTargetAndText has been deprecated, use
1143   WikitextContentHandler::extractRedirectTargetAndText instead.
1144 * WikiPage::doDeleteArticleBatched, deprecated in 1.37, now emits deprecation
1145   warnings.
1146 * WikiPage::getPageIsRedirectField() is now deprecated.
1147 * WikiPage::insertRedirect() is now deprecated.
1148 * Parser::getFreshParser(), deprecated since 1.39, now emits deprecation
1149   warnings.
1150 * The legacy MediaWiki UI ResourceLoader modules, such as `mediawiki.ui`, are
1151   all now emitting deprecation warnings in the JavaScript console. Please use
1152   Codex CSS components instead.
1153 * Article::getRedirectHeaderHtml() has been deprecated and emits deprecation
1154   warnings, use LinkRenderer::makeRedirectHeader() instead.
1155 * SpecialBlock::getTargetAndType(), deprecated since 1.36, now emits deprecation
1156   warnings.
1157 * ApiBase::checkTitleUserPermissions() now type-forces a PageIdentity instead of
1158   a LinkTarget. Passing a LinkTarget has been deprecated since 1.36.
1159 * Passing a User to ApiBase::checkUserRightsAny() in the second parameter, which
1160   was deprecated in 1.36, is no longer read. Instead, it will use the request
1161   context's set Authority via IContextSource::getAuthority().
1162 * Sanitizer::escapeIdReferenceList(), deprecated since 1.36, has been dropped.
1163 * RecentChange::getPerformer(), deprecated since 1.36, has been dropped.
1164 * SpecialPage::getLanguageConverter(), deprecated since 1.36, has been dropped.
1165   Use LanguageConverterFactory::getLanguageConverter() directly.
1166 * SpecialBlock::checkUnblockSelf(), deprecated since 1.36, has been dropped. Use
1167   BlockPermissionChecker instead.
1168 * DifferenceEngine::localiseLineNumbers() has been deprecated in favor of
1169   BaseTextDiffer::localizeLineNumbers(). Subclasses such as PhpTextDiffer may
1170   make this available via a ::localize() method.
1171 * ChangeTags::modifyDisplayQuery() and ChangeTagsStore::modifyDisplayQuery()
1172   have been deprecated in favor of ChangeTagsStore::modifyDisplayQueryBuilder()
1173 * Calling SpecialRandomPage::__construct without services as parameters is
1174   deprecated and emit deprecation warnings.
1176 === Other changes in 1.41 ===
1177 * ExternalLinksLookup::getExternalLinksForPage() now exists to centralize
1178   logic of looking up externallinks rows.
1179 * The update script no longer accepts the --skip-compat-checks option.
1180 * Use of the deprecated "Pragma: no-cache" HTTP response header on uncachable
1181   responses has been removed in favour of "Cache-Control: no-cache" (T345420).
1182 * Type hints were added to:
1183    - The return value of WebRequest:: and DerivativeRequest::getSession()
1184    - The return value of WebRequest:: and DerivativeRequest::getIP()
1185    - The return value of User::getTitleKey()
1186    - The return value of User::getRequest()
1187    - The `$key` parameter to Skin::normalizeKey()
1188   None of the methods whose return value was updated belongs to a class
1189   stable to extend, and adding type hints to parameters is backwards
1190   compatible. Therefore, this is not considered a breaking change.
1191 * The mergeMessageFileList script now only works for extensions and skins
1192   supporting extension registration (using extension.json or skin.json).
1193   It will no longer attempt to load PHP entry points.
1194 * Parser will no longer fall back to $wgTitle if a null is provided as a
1195   Title or PageReference. To change the relevant title used for methods
1196   that do not offer an option to set the page, call Parser::setPage.
1197   This affects the methods cleanSig, getSection and replaceSection.
1198 * (T347726, CVE-2023-51704) SECURITY: logging: Fix non-escaped messages
1199   used in rights log.
1201 == Compatibility ==
1203 MediaWiki 1.41 requires PHP 7.4.3 or later and the following PHP extensions:
1205 * ctype
1206 * dom
1207 * fileinfo
1208 * iconv
1209 * intl
1210 * json
1211 * mbstring
1212 * xml
1214 MariaDB is the recommended database software. MySQL, PostgreSQL, or SQLite can
1215 be used instead, but support for them is somewhat less mature.
1217 The supported versions are:
1219 * MariaDB 10.3 or higher
1220 * MySQL 5.7.0 or higher
1221 * PostgreSQL 10 or later
1222 * SQLite 3.8.0 or later
1224 == Online documentation ==
1225 Documentation for both end-users and site administrators is available on
1226 MediaWiki.org, and is covered under the GNU Free Documentation License (except
1227 for pages that explicitly state that their contents are in the public domain):
1229        https://www.mediawiki.org/wiki/Special:MyLanguage/Documentation
1231 == Mailing list ==
1232 A mailing list is available for MediaWiki user support and discussion:
1234        https://lists.wikimedia.org/mailman/listinfo/mediawiki-l
1236 A low-traffic announcements-only list is also available:
1238        https://lists.wikimedia.org/mailman/listinfo/mediawiki-announce
1240 It's highly recommended that you sign up for one of these lists if you're
1241 going to run a public MediaWiki, so you can be notified of security fixes.
1243 == IRC help ==
1244 There's usually someone online in #mediawiki on irc.libera.chat.