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