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/
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
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
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
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
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
79 * (T354045) API: mark HTML output as non-cacheable.
80 * (T355530) filerepo: Fix img_major_mime for files with a non-standard
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
90 * (T358949) updateCollation: Explicitly cast $scale to int.
91 * (T359055) api: Improve linking of language codes lists in top level i18n
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
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
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
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
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
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,
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
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
321 * The following DatabasePostgres methods were unused and have been removed:
322 - ::currentSequenceValue()
325 * The following IDatabase methods were unused and removed without deprecation:
327 - ::wasConnectionLoss()
328 * Database::getTempTableWrites(), previously protected, is now private.
329 * DatabasePostgres class parameter "keywordTableMap", deprecated since 1.37,
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,
354 * Maintenance::$mArgList, ::shouldExecute(), ::setAgentAndTriggers(),
355 ::adjustMemoryLimit(), ::globals(), and ::loadSettings() have been removed.
356 * The GenericArrayObject class, deprecated in 1.40,
358 * The $replace parameter has been removed from HookContainer::scopedRegister.
359 This parameter was unused outside core, and the functionality was intended
361 * PrevNextNavigationRenderer class, deprecated in 1.39,
363 * class alias MediaWiki\User\WatchlistNotificationManager, deprecated in 1.36,
365 * MediaWikiServices::getWatchlistNotificationManager(), deprecated in 1.36,
367 * Interface MediaWiki\Hook\ParserTestTablesHook, deprecated in 1.36,
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
373 - ::areCascadeProtectionSourcesLoaded()
374 - ::areRestrictionsCascading()
375 - ::areRestrictionsLoaded()
376 - ::getAllRestrictions()
377 - ::getCascadeProtectionSources()
378 - ::getFilteredRestrictionTypes()
379 - ::getRestrictionExpiry()
380 - ::getRestrictionTypes()
381 - ::getRestrictions()
382 - ::isCascadeProtected()
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,
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
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
419 * MediaWikiIntegrationTestCase::addCoreDBData() has been deprecated. The method
420 is now a no-op and is no longer called. Tests should create the fixtures
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
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
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
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
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
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:
472 - ::MESSAGES_FALLBACKS
475 - ::isSupportedLanguage()
476 - ::isWellFormedLanguageTag()
478 - ::isValidBuiltInCode()
479 - ::isKnownLanguageTag()
480 - ::getLocalisationCache()
481 - ::fetchLanguageNames()
482 - ::fetchLanguageName()
485 - ::autoConvertToAllVariants()
487 - ::convertNamespace()
491 - ::convertCategoryKey()
493 - ::getPreferredVariant()
494 - ::getDefaultVariant()
496 - ::getExtraHashOptions()
497 - ::getParentLanguage()
499 - ::getMessagesFileName()
500 - ::getJsonMessagesFileName()
502 - ::getFallbacksFor()
503 - ::getFallbacksIncludingSiteLanguage()
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
513 - ::addTrackingCategory()
515 - ::getCategoryLinks()
519 - ::hasDynamicContent()
521 - ::preventClickjacking()
522 - ::setCategoryLinks()
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
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:
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
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
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
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
634 * WikiPage::doDeleteUpdates() and ::getDeletionUpdates(), deprecated in 1.37,
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
648 - ::compareStringLength
650 - ::getVariableStartToEndRegex
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.
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
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
695 - EtcdConfigParseError
701 - MediaWiki\EventRelayer:
705 - MediaWiki\Installer:
715 - AllMessagesTablePager
720 - DeletedContribsPager
730 - ProtectedPagesPager
731 - ProtectedTitlesPager
732 - RangeChronologicalPager
733 - ReverseChronologicalPager
741 - MediaWiki\SiteStats:
744 - MediaWiki\Specials:
747 - SpecialAncientPages
750 - SpecialAutoblockList
755 - SpecialBotPasswords
756 - SpecialBrokenRedirects
758 - SpecialChangeContentModel
759 - SpecialChangeCredentials
761 - SpecialChangePassword
762 - SpecialComparePages
763 - SpecialConfirmEmail
765 - SpecialContributions
766 - SpecialCreateAccount
767 - SpecialDeadendPages
769 - SpecialDeletedContributions
771 - SpecialDoubleRedirects
774 - SpecialEditWatchlist
775 - SpecialEmailInvalidate
777 - SpecialExpandTemplates
779 - SpecialFewestRevisions
780 - SpecialFileDuplicateSearch
782 - SpecialGoToInterwiki
784 - SpecialJavaScriptTest
785 - SpecialLinkAccounts
787 - SpecialListDuplicatedFiles
790 - SpecialListGroupRights
791 - SpecialListRedirects
798 - SpecialMediaStatistics
799 - SpecialMergeHistory
800 - SpecialMostCategories
801 - SpecialMostInterwikis
803 - SpecialMostLinkedCategories
804 - SpecialMostLinkedTemplates
805 - SpecialMostRevisions
809 - SpecialNewPages (and capitalisation corrected)
814 - SpecialPageLanguage
815 - SpecialPagesWithProp
816 - SpecialPasswordPolicies
817 - SpecialPasswordReset
818 - SpecialPermanentLink
820 - SpecialPrefixIndex (and capitalisation corrected)
821 - SpecialProtectedPages (and capitalisation corrected)
822 - SpecialProtectedTitles (and capitalisation corrected)
825 - SpecialRandomInCategory
827 - SpecialRandomRedirect
828 - SpecialRandomRootPage
829 - SpecialRecentChanges
830 - SpecialRecentChangesLinked
832 - SpecialRedirectToSpecial
833 - SpecialRemoveCredentials
834 - SpecialRenameUser (and capitalisation corrected)
836 - SpecialRevisionDelete
840 - SpecialSpecialPages (and capitalisation corrected)
843 - SpecialTrackingCategories
845 - SpecialUncategorizedCategories
846 - SpecialUncategorizedImages
847 - SpecialUncategorizedPages
848 - SpecialUncategorizedTemplates
850 - SpecialUnlinkAccounts
852 - SpecialUnusedCategories
853 - SpecialUnusedImages
854 - SpecialUnusedTemplates
855 - SpecialUnwatchedPages
861 - SpecialWantedCategories
862 - SpecialWantedTemplates
864 - SpecialWhatLinksHere
865 - SpecialWithoutInterwiki
866 - MediaWiki\Specials\Redirects:
867 - SpecialAllMyUploads
870 - SpecialMycontributions
875 - MediaWiki\SpecialPage:
876 - AuthManagerSpecialPage
877 - ChangesListSpecialPage
878 - DisabledSpecialPage
881 - IncludableSpecialPage
882 - LoginSignupSpecialPage
885 - RedirectSpecialArticle
886 - RedirectSpecialPage
888 - SpecialRedirectToSpecial
889 - SpecialRedirectWithAction
890 - UnlistedSpecialPage
896 - ForeignTitleFactory
898 - MalformedTitleException
899 - MediaWikiTitleCodec
900 - NaiveForeignTitleFactory
901 - NaiveImportTitleFactory
902 - NamespaceAwareForeignTitleFactory
903 - NamespaceImportTitleFactory
905 - SubpageImportTitleFactory
916 - UserArrayFromResult
917 - UserGroupMembership
919 - MediaWiki\User\CentralId:
925 - ExtensionInfo (previously under MediaWiki\ExtensionInfo)
927 - ConfiguredReadOnlyMode
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
978 * The InterwikiLoadPrefix hook now emits deprecation warnings. Resetting the
979 $wgInterwikiCache setting instead.
980 * SiteConfiguration::getConfig() now emits deprecation warnings, Use ::get()
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
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:
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
1078 - ResourceLoader -> MediaWiki\ResourceLoader\ResourceLoader
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()
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
1146 * WikiPage::getPageIsRedirectField() is now deprecated.
1147 * WikiPage::insertRedirect() is now deprecated.
1148 * Parser::getFreshParser(), deprecated since 1.39, now emits deprecation
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
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
1203 MediaWiki 1.41 requires PHP 7.4.3 or later and the following PHP extensions:
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
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.
1244 There's usually someone online in #mediawiki on irc.libera.chat.