5 This is a security and maintenance release of the MediaWiki 1.36 branch.
7 === Changes since MediaWiki 1.36.0 ===
8 * (T283942) DatabaseInstaller.php: Only run core schema file if specified table
10 * (T247223) Optimise MessageCache::isMainCacheable() for the single-message
12 * (T283244) JavaScriptMinifer: Fix handling of "delete" as object property.
13 * (T284391) Fix SkinModule to correctly prepend remote path on document root
15 * (T235554) Disable DEFER_SET_LENGTH_AND_FLUSH headers to avoid HTTP errors.
16 * (T278579) Don't send headers on ob_end_clean().
17 * (T285287) MultiHttpClient: Replace PHP version check with defined().
18 * (T280226, CVE-2021-35197) SECURITY: Prevent blocked users from purging pages.
20 == MediaWiki 1.36.0 ==
22 === Changes since MediaWiki 1.36.0-rc.0 ===
23 * (T248481) rdbms: Use server time in
24 DatabaseMysqlBase::getLagFromPtHeartbeat().
25 * (T281549) WebInstaller: Don't show the announce-l subscribe checkbox for now.
26 * (T264214) Follow-ups for UserGroupManager.
27 * (T282280) resourceloader: Fix path-only URLs in wiki modules when script path
29 * (T281972) UserIdentityValue: Introduce convenience static factory methods.
30 * (T230428) Make page_is_redirect and page_is_new unsigned.
31 * (T280292) Legacy feature should not load thumbnail style rules (only layout).
32 * (T283247) Freenode -> Libera per wikimedia moving from freenode to libera.
33 * (T280270) composer: Lock Parsoid version to specific 0.13.0 release.
34 * (T142663) Add extension.json merge strategy "provide_default".
35 * (T283540) HookContainer: Fix normalization of callback for static handler.
36 * (T283464) registration: Fix array order for array_replace_recursive merge
38 * (T283539) Interwiki: Fix calling "onInterwikiLoadPrefix" hook.
39 * (T282594) Timeless: Re-branch to 40eb3dad1for REL1_36.
41 == MediaWiki 1.36.0-rc.0 ==
43 == Upgrading notes for 1.36 ==
44 Don't forget to always back up your database before upgrading!
46 See the file UPGRADE for more detailed per-version upgrade instructions from the
47 oldest supported upgrading version, MediaWiki 1.27.
49 Some specific notes for MediaWiki 1.36 upgrades are below:
50 * MediaWiki 1.36 now requires the PHP internationalization extension (commonly
51 referred to as Intl, ext-intl, or php-intl).
52 * The MediaWiki:Autoblock_whitelist block exemption control has been moved to
53 MediaWiki:Block-autoblock-exemptionlist. If you use this feature, please move
54 the MediaWiki:Autoblock_whitelist page.
55 * (T275334) $wgExtensionFunctions is sometimes used to change configuration
56 settings. This is not safe; extension functions are run relatively late, some
57 services are already initialized by that point and so they use the old
58 configuration. Changes in 1.36 make this kind of breakage even more common.
59 You can use the MediaWikiServices hook instead. (In the future there might be
60 a dedicated hook for configuration changes.)
62 For notes on 1.35.x and older releases, see HISTORY.
64 === Configuration changes for system administrators in 1.36 ===
65 The MediaWiki update script, maintenance/update.php, used to accept `--nopurge`
66 as an option to prevent clearing caches stored in the database during upgrade.
67 This is no longer encouraged, and the option has been removed.
69 ==== New configuration ====
70 * (T256001) $wgManualRevertSearchRadius – This setting controls a new feature
71 that marks edits as reverts if they restore the page to an exact previous
72 state. This configuration variable sets the maximum number of revisions of a
73 page that will be checked against every new edit. Set this to 0 to disable the
75 * (T244058) $wgOldRevisionParserCacheExpireTime — This setting was added to
76 control caching of ParserOutput for old (non-current) revisions.
77 * (T265263) $wgRememberMe - This setting configures the "remember me" checkbox
78 on account log-in systems via RememberMeAuthenticationRequest.
79 * (T157145) $wgSkinMetaTags – This setting lets sysadmins configure skins that
80 support meta tags. These tags make sharing of MediaWiki pages on a variety of
81 social platforms more contentful and thus useful.
82 * (T280944) $wgIncludejQueryMigrate - This setting lets sysadmins disable the
83 jQuery Migrate plugin. It has been enabled by default since MediaWiki 1.27.
84 In future releases it will be disabled by default.
86 ==== Changed configuration ====
87 * $wgLogos – This setting selects the logo shown on the site. The default value
88 for the site logo, which is shown in an install if you have not set one, will
89 now be the new logo of MediaWiki.
90 * (T274695) $wgAjaxEditStash — This setting, to disable the edit stashing
91 feature when users start writing an edit summary, has been deprecated. In
92 future releases, this feature will always be enabled.
93 * $wgUploadStashScalerBaseUrl – This setting, to enable remote on-demand media
94 scaling, was deprecated. Use the `thumbProxyUrl` setting in $wgLocalFileRepo
96 * $wgSlaveLagWarning and $wgSlaveLagCritical – These settings have been renamed,
97 to $wgDatabaseReplicaLagWarning & $wgDatabaseReplicaLagCritical respectively.
98 The former configuration variable names are deprecated, but will be used as
99 the fall back if they are still set, and remain temporarily available for
100 extensions which try to read them.
101 * $wgWANObjectCaches - The "coalesceKeys" option was removed without deprecation
102 and replaced by a new "coalesceScheme" option, set to "hash_stop" by default.
103 If you use Dynomite, then set the new "coalesceKeys" option to "hash_tag". The
104 "cluster" and "mcrouterAware" options were also removed without deprecation.
105 Use "broadcastRoutingPrefix" instead.
107 ==== Removed configuration ====
108 * $wgUseTwoButtonsSearchForm — This setting, deprecated in 1.35, has been
110 * $wgAllowImageMoving — This setting, deprecated in 1.35, has been removed. Use
111 group permission settings instead. For example, to prevent sysops from
112 moving files, set `$wgGroupPermissions['sysop']['movefile'] = false;`
113 * $wgExtNewTables, $wgExtNewFields, $wgExtNewIndexes, $wgExtPGNewFields,
114 $wgExtPGAlteredFields, $wgExtModifiedFields — These settings were removed.
115 They became obsolete after 1.17 overhauled the database updater, but were kept
116 for backwards compatibility. The LoadExtensionSchemaUpdates hook should be
118 * $wgParserConf - This setting, deprecated in 1.35, has been removed. The last
119 use of this setting was for pre-processor configuration, which was deprecated
120 in 1.34 and removed in 1.35.
121 * $wgEnableRestAPI - This setting, ignored since 1.35, has been removed.
122 * $wgPagePropsHaveSortkey – This temporary setting has been removed, along with
123 the schema change upgrade path it controlled. If your site is still using it,
124 meaning you have not yet applied the `pp_sortkey` schema change from 1.24, you
125 must now apply it before upgrading.
126 * The deprecated password policies PasswordCannotMatchBlacklist and
127 PasswordNotInLargeBlacklist were removed. Please use
128 PasswordCannotMatchDefaults and PasswordNotInCommonList respectively instead.
130 === New user-facing features in 1.36 ===
131 * The logo of MediaWiki has changed. This means that the "Powered By MediaWiki"
132 button shown in the skin footer will be different.
133 * All HTML5 named entities are now accepted in wikitext.
134 * (T106263) The file description page's alternate sizes now include 2048px.
136 === New developer features in 1.36 ===
137 * Parser test files can now declare a dependency on a specific extension being
138 loaded, not just on the presence of a certain extension tag hook. This is a
139 better fit for extensions like TimedMediaHandler, which affect the output but
140 don't register parser hooks. Use `extension:Foo` in the `!! hooks` section of
141 your parser test file to declare a dependency on the `Foo` extension being
143 * To expose code previously present in SpecialBlock/SpecialUnblock to other
144 parts of the code, or to extensions, the new BlockUser and UnblockUser command
145 objects were added. Use the BlockUserFactory and UnblockUserFactory services
147 * The hook UsersPagerDoBatchLookupsHook takes now a \Wikimedia\Rdbms\IDatabase,
148 instead of \Wikimedia\Rdbms\DBConnRef, as the first parameter.
149 * MediaHandlers can now customize the formatting of the metadata they emit by
150 over-riding MediaHandler::formatTag( $key, $value ). The default for unknown
151 tags is numeric formatting; non-EXIF tags which are non-numeric should always
152 use this method to specify the desired formatting.
153 * The new 'title' type can be used to validate action API and REST API inputs.
154 * The new ArticleParserOptions hook allows customizing the parser options used
155 to parse wikitext for an article, based on user preferences, title, etc.
156 * The new 'raw' type can be used to validate action API inputs. It bypasses the
157 Unicode NFC normalization done on inputs of type 'string', so it more suitable
158 when the input is binary or may contain deprecated Unicode sequences or
159 characters (such as U+2001) that should be passed unmodified.
160 * (T260330) A new abstraction for running shell commands has been introduced,
161 called BoxedCommand. A BoxedCommand object can be obtained with
162 MediaWikiServices::getInstance()->getCommandFactory()->createBoxed().
163 * ResourceLoader modules can now mark themselves as ES6-only by setting
164 `'es6' => true` in their module definition. ES6-only modules will not be
165 executed in browsers that don't support ES6, such as IE11.
167 === External library changes in 1.36 ===
169 ==== New external libraries ====
170 * Added wikimedia/minify 2.2.2.
171 * Added wikimedia/request-timeout 1.1.0.
172 * Added wikimedia/shellbox 1.0.4.
175 ==== Changed external libraries ====
176 * Updated composer/semver from 1.5.1 to 3.2.4.
177 * Updated guzzlehttp/guzzle from 6.5.4 to 7.2.0.
178 * Updated jQuery from v3.4.1 to v3.6.0.
179 * Updated jQuery Migrate from v3.1.0 to v3.3.2.
180 * Updated jquery.client from 2.0.2 to 3.0.0.
181 * Updated OOUI from 0.39.3 to 0.41.3.
182 * Updated pear/mail_mime from 1.10.8 to 1.10.9.
183 * Updated pear/net_smtp from 1.9.1 to 1.9.2.
184 * Updated pimple/pimple from 3.3.0 to 3.3.1.
185 * Updated wikimedia/at-ease from 2.0.0 to 2.1.0.
186 * Updated wikimedia/cldr-plural-rule-parser from 1.0.0 to 2.0.0.
187 * Updated wikimedia/common-passwords from 0.2.0 to 0.3.0.
188 * Updated wikimedia/composer-merge-plugin from 1.4.1 to 2.0.1.
189 * Updated wikimedia/html-formatter from 1.0.2 to 3.0.1.
190 * Updated wikimedia/ip-set from 2.1.0 to 3.0.0.
191 * Updated wikimedia/ip-utils from 1.0.0 to 3.0.2.
192 * Updated wikimedia/less.php from 3.0.0 to 3.1.0.
193 * Updated wikimedia/object-factory from 2.1.0 to 3.0.0.
194 * Updated wikimedia/php-session-serializer from 1.0.7 to 2.0.0.
195 * Updated wikimedia/remex-html from 2.2.0 to 2.2.2.
196 * Updated wikimedia/utfnormal from 2.0.0 to 3.0.2.
197 * Updated wikimedia/wait-condition-loop from 1.0.1 to 2.0.1.
198 * Updated wikimedia/xmp-reader from 0.7.0 to 0.8.1.
200 ===== Changed development-only external libraries =====
201 * Updated composer/spdx-licenses from 1.5.3 to 1.5.4.
202 * Updated doctrine/dbal from 2.10.2 to 3.0.0.
203 * Updated doctrine/sql-formatter from 1.1.0 to 1.1.1.
204 * Updated mediawiki/mediawiki-phan-config from 0.10.2 to 0.10.6.
205 * Updated monolog/monolog from 1.25.3 to 2.2.0.
206 * Updated nikic/php-parser from 4.4.0 to 4.10.2.
207 * Updated psy/psysh from 0.10.4 to 0.10.5.
208 * Updated seld/jsonlint from 1.7.1 to 1.8.3.
209 * Updated symfony/yaml from ~3.4|~4.3|~5.0.5 to ~3.4|~5.1.
210 * Updated wikimedia/testing-access-wrapper from 1.0.0 to 2.0.0.
212 ==== Removed external libraries ====
213 * The html5shiv library has been removed, as support for Internet Explorer 8 has
215 * The wikimedia/avro suggested development-only library has been removed, as the
216 support for logging in Avro format has been dropped.
218 === Bug fixes in 1.36 ===
219 * (T190285) ApiEditPage module used to switch 'undo' and 'undoafter' parameters,
220 if it founds you reversed them (based on assumption that higher revision ID
221 indicates a later revision). The assumption is not always true, and is
222 hindering proper edit undoing in some cases, hence the logic has been removed.
223 Reversing the parameters will now lead to edit conflict or undefined behavior.
224 * (T263340) In history merging, pages with a content model that does not support
225 redirects will now be recorded as deleted if no revision is being left in the
226 source page (that's if all revisions of the page have been merged to another).
228 === Action API changes in 1.36 ===
229 * (T269636) `Access-Control-Max-Age` was added to the default list of headers
230 allowed for cross-origin API requests ($wgAllowedCorsHeaders).
231 * (T258108) Accounts with the 'bot' right no longer have pages automatically
232 added to the watchlist when making API edits, regardless of their preferences.
233 This is to reduce the size of the watchlist data in the database. To add API
234 bot edits to the watchlist, explicitly set the 'watch' option.
236 === Languages updated in 1.36 ===
237 MediaWiki supports over 350 languages. Many localisations are updated regularly.
238 Below only new and removed languages are listed, as well as changes to languages
239 because of Phabricator reports.
241 * (T258975) Added a Latin/Cyrillic script converter for the Talysh language.
242 * (T245359) Split Bali script locale from "ban" (Balinese) (ban-bali).
243 * (T264582) Added language support for Madurese (mad).
244 * (T259330) Added language support for Mara (mrh).
245 * (T263968) Added language support for Nias (nia).
246 * (T270365) Added language support for Tyap (kcg).
247 * (T276745) Added language support for Wayuu (guc).
249 === Breaking changes in 1.36 ===
250 * Grade C (non-JavaScript) support for Internet Explorer 8 has been dropped.
251 * (T249459) wfIsBadImage(), deprecated in 1.34, has been removed.
252 * (T176526) EditPage::getContextTitle() will now throw an exception if a context
253 title was not set using setContextTitle(). Previously, this mis-use would only
254 cause a deprecation warning to be emitted.
255 * The DeferredStringifier class, deprecated since 1.31, was removed.
256 * Multiple methods that fell back to the $wgUser global variable were
257 individually hard deprecated previously. The following have now been removed:
258 - ApiTestCase::doLogin
259 - Article::doDeleteArticle
260 - Article::doDeleteArticleReal
261 - Article::getComment
262 - Article::getCreator
264 - Article::getUserText
265 - Article::insertProtectNullRevision
268 - ForeignDBFile::delete
269 - ForeignDBFile::recordUpload
271 - LocalFile::deleteOld
272 - LocalFile::recordUpload
273 - PageArchive::undelete
274 - RecentChange::markPatrolled
275 - Title::getUserPermissionsErrors
276 - Title::quickUserCan
278 - WebRequest::getLimitOffset
279 - WikiPage::doDeleteArticle
280 - WikiPage::insertProtectNullRevision
281 * The SpecialPageFactory class, deprecated in 1.32, has been removed. Use the
282 SpecialPageFactory service instead.
283 * Multiple methods previously had optional User parameters, with fallbacks
284 to the $wgUser global variable. Not passing a User to those methods was
285 previously hard deprecated, and support for not passing a User has now
287 - ArchivedFile::userCan
289 - FileDeleteForm::__construct
290 - FileDeleteForm::doDelete
291 - LocalFileDeleteBatch::__construct
292 - LogEventsList::getExcludeClause (only needed for the 'user' audience)
293 - LogEventsList::userCan
294 - LogEventsList::userCanBitfield
295 - LogEventsList::userCanViewLogType
296 - LogPage::addEntry (also accepts user id instead)
297 - OldLocalFile::userCan
299 - Title::getNotificationTimestamp (though the entire method is deprecated)
300 - WikiPage::getComment (only needed for the FOR_THIS_USER audience)
301 - WikiPage::getCreator (only needed for the FOR_THIS_USER audience)
302 - WikiPage::getUser (only needed for the FOR_THIS_USER audience)
303 - WikiPage::getUserText (only needed for the FOR_THIS_USER audience)
304 * The following hooks have been removed:
306 - APIQueryRecentChangesTokens
307 - APIQueryRevisionsTokens
308 - APIQueryUsersTokens
309 - ApiTokensGetTokenTypes
310 * LogEventsList::typeAction previously accepted an optional right parameter, and
311 checked if the context user ($wgUser) had that right. Passing a right was hard
312 deprecated in 1.35, and support for passing a right has now been removed.
313 * WikiPage::doDeleteArticleReal previously accepted an optional user as its
314 fifth parameter, and fell back to $wgUser if not user was provided. The
315 signature changed to have the user as the second parameter, and the old
316 signature was hard deprecated in 1.35. Support for the old signature has now
318 * User::addNewUserLogEntry, deprecated since 1.27, was removed.
319 * As part of refactoring the EditPage class, EditPage::setPreloadedContent,
320 which had no known callers was removed entirely. Additionally, the following
321 public methods were made private:
322 - ::extractSectionTitle
323 - ::getSummaryInputWidget
324 - ::noSuchSectionPage
326 * EditPage::matchSpamRegex and ::matchSummarySpamRegex, deprecated in 1.35,
327 were removed. Use the SpamChecker service instead.
328 * The global function `wfWaitForSlaves`, deprecated in 1.27 and hard-deprecated
329 in 1.35, has been removed. Use LBFactory::waitForReplication() instead.
330 * Calling Action::factory() with null as the first parameter, rather than a
331 string, was deprecated in 1.35 and support was now removed.
332 * Calling Action::factory() with an object that wasn't an Article as the second
333 parameter was deprecated in 1.35 and support was now removed.
334 * The global variable $wgMemc, deprecated since 1.35, has been removed. Usage
335 should generally be migrated to WANObjectCache, or if you really need the
336 internal object, use ObjectCache::getLocalClusterInstance instead.
337 * The preprocessDump.php maintenance script was removed.
338 * CategoryFinder, which was deprecated in 1.31 and hard-deprecated in 1.35,
340 * GenderCache::singleton(), which was deprecated in 1.28 and hard-deprecated
341 in 1.35, has been removed.
342 * Sanitizer::escapeId(), deprecated in 1.30, has been removed.
343 * Direct invocation of Parser::__construct() (instead of via a ParserFactory)
344 now throws an exception; support has also been removed for several
345 deprecated variants on the arguments passed to Parser::__construct.
346 Direct invocation of Parser::__construct was deprecated in 1.34.
347 * Parser::setFunctionTagHook(), deprecated in 1.35, has been removed.
348 * The following properties of Parser, deprecated in 1.35, have been made
350 - $mTagHooks - use Parser::getTags()
351 - $mFunctionHooks - use Parser::getFunctionHooks()
352 - $mOutput - use Parser::getOutput()
353 - $mPreprocessor - use Parser::getPreprocessor()
354 * The ParserBeforeTidy hook, deprecated in 1.35, has been removed.
355 * The ParserBeforeTidy, ParserBeforeStrip, and ParserAfterStrip hooks,
356 deprecated in 1.35, have been removed.
357 * All methods of MWTidy except for MW::tidy() have been removed. These were each
358 either marked as @internal or deprecated in 1.35.
359 * (T248062) Mixins `.background-image-svg()` and `.background-image-svg-quick()`
360 (provided by mediawiki.mixins.less), which have been deprecated since 1.35,
361 have now been removed. MediaWiki no longer supports any browser which would
362 require this SVG-fallback PNG support, so you can simply use the regular CSS
363 `background-image:` declaration instead.
364 * The ResourceLoader module `mediawiki.legacy.oldshared` and its file
365 'oldshared.css', deprecated since 1.35 has been removed (T248357).
366 * `ResourceLoader::__construct` now requires a Config parameter. The optional
367 nature of this parameter was deprecated in 1.34.
368 * The LinkBegin and LinkEnd hooks, deprecated in 1.28, have been removed. You
369 can instead use the HtmlPageLinkRendererBegin and HtmlPageLinkRendererEnd
371 * The EmailUser hook passes its fifth param, $error, by reference, to allow
372 hook handlers to add error messages, indicate that they have sent the email
373 instead of core, etc. Setting the parameter to something other than a
374 Status object, true, false, an empty string, an array, or a MessageSpecifier,
375 object, which had been deprecated in 1.29, is no longer supported, and now
376 results in an MWException being thrown.
377 * Skin::getDynamicStylesheetQuery(), deprecated in 1.32, has been removed. You
378 should use action=raw&ctype=text/css directly.
379 * Skin::makeI18nUrl(), deprecated in 1.35, has been removed.
380 * The following User methods, deprecated and moved to BlockManager in 1.34, were
384 - ::isLocallyBlockedProxy
385 - ::trackBlockWithCookie
386 * Support for v1 of the parser tests file format has been removed; it was
387 deprecated in 1.35. (T174199)
388 * SpecialUnblockUser::processUIUnblock() now returns a Status object instead of
389 an array of messages or a boolean value. This function was also marked as
390 @internal and is no longer safe to call it publicly.
391 * mw.Title.getDotExtension() from the 'mediawiki.Title' module was removed
392 without deprecation. You should use mw.Title.getExtension() and prepend the
394 * Profiler::getTemplated and Profiler::setTemplated, deprecated in 1.34, have
396 * DatabaseMysqlBase now requires MySQL version 5.6.4+ when "lagDetectionMethod"
397 is set to "pt-heartbeat".
398 * Removed HookContainer::getOriginalHooksForTest() without deprecation. This
399 method was introduced in 1.35 for internal use, and appears unused outside of
401 * ParserCache::__construct() now requires three parameters.
402 * Message->getFormat(), deprecated in 1.29, has been removed.
403 * Support for passing Article to ParserCache::get, deprecated in 1.35, has been
405 * ParserCache::singleton(), deprecated in 1.30, has been removed.
406 * DatabaseBlock::deleteIfExpired and ::fromMaster, deprecated in 1.35, have been
408 * Some deprecated AbstractBlock methods have been removed:
409 - ::prevents, deprecated in 1.33
410 - ::shouldTrackWithCookie, deprecated in 1.34
411 - ::getBlocker, deprecated in 1.35
412 - ::setBlocker, deprecated in 1.35
413 - ::getBlockErrorParams, deprecated in 1.35
414 * Multiple DatabaseBlock methods dealing with cookies, deprecated in 1.34,
419 - ::getIdFromCookieValue
420 - ::shouldTrackWithCookie
421 * The public static callback function SpecialUnblock::processUIUnblock has been
422 removed. This method was for internal use only, and appears unused outside of
424 * ChangeTags::truncateTagDescription, deprecated in 1.35, has been removed.
425 * Deprecated null fallbacks in PasswordReset constructor have been removed.
426 * User::isEveryoneAllowed and User::getAllRights, deprecated in 1.34, has been
428 * The following methods of the UserGroupMembership class, deprecated in 1.35,
431 - ::newFromRow - use UserGroupManager::newGroupMembershipFromRow
432 - ::selectFields - use UserGroupManager::getQueryInfo
433 - ::delete - use UserGroupManager::removeUserFromGroup
434 - ::insert - use UserGroupManager::addUserToGroup
435 - ::purgeExpired - use UserGroupManager::purgeExpired
436 - ::getMembershipsForUser - use UserGroupManager::getUserGroupMemberships
437 - ::getMembership - use UserGroupManager::getUserGroupMemberships
438 * The public static callback function SpecialBlock::validateTargetField has been
439 removed. This method was for internal use only, and appears unused outside of
441 * The public static callback function SpecialUploadStash::tryClearStashedUploads
442 has been removed. This method was for internal use only, and appears unused
443 outside of MediaWiki core.
444 * SpecialComparePages::showDiff() ::revOrTitle(), ::checkExistingTitle(), and
445 ::checkExistingRevision() were marked as @internal to allow for breaking
446 changes. They are no longer safe to call. The methods were unused outside of
448 * Each special page within core now uses service injection via it constructor.
449 When extending these special pages, a call to the grandparent constructor
450 (`SpecialPage::__construct()`) in the sub-class would now break the derived
451 special page, as the fallback code in the parent constructor cannot set the
452 services as needed. Be sure to call the parent constructor when extending
453 core special pages. Extending core's special pages is not part of the stable
454 interface, and should generally be avoided.
455 * Language::getExtraUserToggles and ::viewPrevNext, deprecated in 1.34, have
457 * StreamFile::send404Message and ::parseRange, deprecated in 1.34, have been
459 * SVGMetadataExtractor class, deprecated in 1.34, has been removed.
460 * ProcessCacheLRU class, deprecated in 1.32, has been removed.
461 * wfForeignMemcKey(), deprecated in 1.35, has been removed.
462 * LoadBalancer::safeWaitForMasterPos(), deprecated in 1.34, has been removed.
463 * JobQueue::factory() now requires its `idGenerator` option. The optional
464 nature of this option was deprecated in 1.35.
465 * ApiFeedRecentChanges::getFeedObject has been changed to private, and appears
466 unused outside of MediaWiki core.
467 * Skin::subPageSubtitle() has been changed to private method. Callers should
468 use Skin::prepareSubtitle().
469 * RevisionDeleter::checkRevisionExistence was removed without deprecation.
470 It had no known callers.
471 * wfForeignMemcKey() and wfMemcKey(), deprecated in 1.35, have been removed.
472 * MediaWiki now also requires the php-intl extension.
473 * BotPassword::save() now returns a Status object for the result rather than
475 * The methods in CoreTagHooks have been marked @internal and type hints have
476 been added. The methods appeared to be unused outside of MediaWiki core.
477 * SquidPurgeClient and SquidPurgeClientPool, deprecated since 1.35, have been
479 * Several methods on WikiPage will now throw an exception when called on a
480 WikiPage instance that where constructed on a title that does not refer to a
481 proper page (but rather a special page or interwiki link). The behavior was
482 previously undefined and could in some cases lead to data corruption. Affected
483 methods are: getId(), insertOn(), newPageUpdater(), doUpdateRestrictions(),
484 doDeleteArticleReal(), doRollback(), and doEditContent().
485 * The ParserTestRunner no longer invokes the ParserTestTables hook. Instead, it
486 clones all database tables before running tests, like MediaWikiIntegrationTest
487 does. If an extension was mis-using the hook to *exclude* tables from the
488 clone, that will no longer occur, and tests may fail.
489 * The following classes, which were only loaded for tests and had no uses found
490 in public MediaWiki-related git, were removed:
493 * Passing Title as a second parameter to RevisionStore::getPreviousRevision and
494 getNextRevision, hard deprecated since 1.31, was prohibited.
495 * (T275619) Maintenance::hasOption and Maintenance::getOption now behave as
496 documented and are not altered by previous calls to these methods.
497 * The internal class FirejailCommand was removed.
498 * Command::execute() now returns a Shellbox\Command\UnboxedResult instead of a
499 MediaWiki\Shell\Result. Any type hints should be updated.
500 * WikiPage::$mIsRedirect was removed.
501 * ObjectCache::detectLocalServerCache(), deprecated in 1.35, was removed.
502 * The following functions from the Title class have been removed:
503 - countRevisionsBetween
505 * The PageProps class was converted to a service. PageProps::overrideInstance
506 was removed, and MediaWikiServices::redefineService should be used
508 * Support for creating a MediaWikiTitleCodec object without the InterwikiLookup
509 and NamespaceInfo services, deprecated in 1.34, was removed. Note that the
510 MediaWikiTitleCodec class is not @newable or @stable to create, and should
511 be retrieved from MediaWikiServices instead.
512 * The $wgContLang variable, deprecated in 1.32, was removed. You can instead use
513 MediaWikiServices::getInstance()->getContentLanguage().
514 * User::clearAllNotifications(), hard deprecated in 1.35, was removed. Use
515 WatchlistManager::clearAllUserNotifications() instead.
516 * DatabaseBlock::getBlocker can return any UserIdentity instance, not just User.
517 * MediaWiki::triggerJobs(), deprecated in 1.34, was removed.
518 * The following Article methods, deprecated in 1.35, were removed:
528 - getAutoDeleteReason
534 - getHiddenCategories
548 - insertRedirectEntry
557 - prepareContentForEdit
559 - protectDescriptionLog
560 - replaceSectionAtRev
561 - replaceSectionContent
563 - shouldCheckParserCache
565 - triggerOpportunisticLinksUpdate
566 - updateCategoryCounts
570 - doUpdateRestrictions
575 * The monolog-based logging system has dropped the Avro format. Because of this,
576 the AvroFormatter class and the AvroValidator utility class have been removed
578 * AbstractBlock::$mReason, deprecated in 1.34, was removed.
579 Use AbstractBlock::getReasonComment and AbstractBlock::setReason instead.
581 === Deprecations in 1.36 ===
582 * (T278026) The DB_MASTER constant has been deprecated in favour of DB_PRIMARY.
583 * (T245963) User::getGrantName() is now hard deprecated and will be removed in
584 a subsequent release. Use MWGrants::grantName() instead.
585 * wfIncrStats() is now deprecated. Use MediaWikiServices::getInstance()
586 ->getStatsdDataFactory()->updateCount() instead.
587 * WikiPage::doEditContent() is now deprecated. Use
588 WikiPage::doUserEditContent() instead. Note that doEditContent() was also
589 deprecated in 1.32 for unrelated reasons and doUserEditContent() is
590 deprecated for other reasons, however, using doUserEditContent() is
591 recommended over using doEditContent().
592 * WikiPage::doUserEditContent() is now deprecated. Use
593 PageUpdater::saveRevision instead. Note that the new method expects callers
594 to take care of checking EDIT_MINOR against the minoredit right, and to apply
595 the autopatrol right as appropriate.
596 * LocalFile::recordUpload2, soft deprecated in 1.35, now emits deprecation
597 warnings. Use ::recordUpload3 instead.
598 * Constructing a new instance of the ParserOptions class without providing
599 a User object, which falls back to the global $wgUser, is now deprecated.
600 * The User class, which was marked as @newable in 1.35, is no longer newable,
601 meaning that it is no longer safe to manually call the constructor via
602 `new User`. Instead, use the UserFactory service. Additionally, the
603 following static constructor methods were deprecated in favor of using the
607 - User::newFromActorId
608 - User::newFromIdentity
610 - User::newFromConfirmationCode
611 * The following User methods have been hard deprecated in favor of the new
612 UserEditTracker service:
613 - User::getFirstEditTimestamp
614 - User::getLatestEditTimestamp
615 * The confusingly-named User->isLoggedIn() method has been deprecated in favour
616 of the method it wraps, User->isRegistered().
617 * Use of the `preprocessor=Preprocessor_DOM` option in parser test files has
618 been deprecated. Preprocessor_DOM was removed in 1.35.
619 * ParserOptions::setTidy() has been deprecated. It has had no effect since
621 * Sanitizer::escapeIdReferenceList() has been deprecated; it will eventually
622 be made private to the class, as it appears to have no uses outside the
624 * Sanitizer::hackDocType() is deprecated; it will eventually be made private.
625 * Skin::getIndicatorsHTML() is deprecated. The functionality can be retained
626 by reimplementing the method using the raw indicators data from
627 OutputPage::getIndicators.
628 * Skin::makeVariablesScript() has been deprecated. Use
629 ResourceLoader::makeInlineScript() instead.
630 * SpecialPageFactory::getRestrictedPages() has been deprecated.
631 Use SpecialPageFactory::getUsablePages() instead.
632 * Title::nameOf() is deprecated; use Title::newFromID()->getPrefixedDBkey()
634 * DatabaseBlock::insert, DatabaseBlock::update, DatabaseBlock::purgeExpired and
635 DatabaseBlock::delete are deprecated. Use DatabaseBlockStore::insertBlock,
636 DatabaseBlockStore::updateBlock, DatabaseBlockStore::purgeExpiredBlocks and
637 DatabaseBlockStore::deleteBlock instead.
638 * SpecialBlock::getTargetAndType and AbstractBlock::parseTarget are deprecated.
639 Call BlockUtils::parseBlockTarget instead.
640 * SpecialUnblock::processUnblock was deprecated - use UnblockUserFactory
642 * Deprecated MediaWikiIntegrationtestCase::removeTemporaryHook() in favor of
643 MediaWikiIntegrationtestCase::clearHook().
644 * Skin::getSearchLink(), also exposed as 'searchaction' option in SkinTemplate,
645 has been deprecated. Use Title or SpecialPage methods directly.
646 * Skin::getAllowedSkins and ::getSkinNames have been deprecated. Use their
647 respective equivalents in SkinFactory instead.
648 * The RollbackComplete hook has been deprecated, use the PageSaveComplete hook
650 * Skin::makeUrl() has been deprecated. Title methods should be used instead.
651 * Skin::privacyLink(), Skin::disclaimerLink() and Skin::aboutLink() have been
652 deprecated. Please use Skin::footerLink() instead.
653 * Skin::getLogo() has been deprecated. Use ResourceLoaderSkinModule instead.
654 * The module `mediawiki.toc.styles` has been replaced by
655 ResourceLoaderSkinModule. If you are having problems styling table of contents
656 ensure you have an updated skin.
657 * Skin::mainPageLink() has been deprecated. Use LinkRenderer service instead.
658 * BaseTemplate::getToolbox() method has been hard deprecated. The toolbox data
659 is now available in a sidebar data array which you can get from any class
660 that's extending QuickTemplate class.
661 * Constructing a DefaultPreferencesFactory, LinkHolderArray or PasswordReset
662 without a $hookContainer parameter is deprecated.
663 * Autopromote class, soft deprecated since 1.35, now emits deprecation warnings.
664 Use UserGroupManager instead.
665 * SpecialBlock::canBlockEmail has been deprecated. Please use
666 BlockPermissionChecker::checkEmailPermissions instead.
667 * SpecialBlock::checkUnblockSelf has been deprecated. Please use
668 BlockPermissionChecker::checkBlockPermissions instead.
669 * SpecialBlock::parseExpiryInput was deprecated - use
670 BlockUser::parseExpiryInput instead.
671 * SpecialBlock::validateTarget has been deprecated, use BlockUtils instead.
672 * SpecialBlock::validateTargetField has been deprecated for external use,
673 use BlockUtils instead.
674 * SpecialPage::getLanguageConverter has been deprecated, use
675 LanguageConverterFactory::getLanguageConverter() directly.
676 * ParserCache::getKey has been deprecated. Use ParserCache::getMetadata and
677 ParserCache::makeParserOutputKey instead.
678 * The PHPUnit4And6Compat class, used to provide compatibility with PHPUnit 4,
679 was removed. MediaWiki support for PHPUnit 4 ended with the removal of HHVM
681 * The PHPUnit6And8Compat class, used to provide compatibility with PHPUnit 6,
682 was removed without deprecation. This class was introduced during the
683 upgrade to PHPUnit 8, but never used.
684 * MediaWikiIntegrationTestCase::assertType, hard-deprecated in 1.35 due to
685 incompatibility with PHPUnit 8, was removed.
686 * ParserCache::getETag has been deprecated, instead build suitable etag
688 * The following functions from the Language class have been hard deprecated
689 and will be removed in a subsequent release:
692 - updateConversionTable
694 * The following functions from the Title class have been hard deprecated:
695 - getPreviousRevisionID
698 * The following functions from the User class have been hard deprecated:
701 * The mw.language.commafy client-side method has been deprecated, to match
702 the deprecation of Language::commafy. Use mw.language.convertNumber
704 * The "es6-promise" module has been deprecated. Use "es6-polyfills" instead.
705 * Title::isDeleted() and Title::isDeletedQuick() have been deprecated. Please
706 use Title::getDeletedEditsCount() and Title::hasDeletedEdits() instead.
707 * Article::getContentObject, soft-deprecated since 1.32, was hard-deprecated.
708 * WikiRevision::importUpload, soft-deprecated since 1.31, was hard-deprecated.
709 * Html::infoBox() has been deprecated. There's no replacement.
710 * Message::toString() without a $format parameter, soft-deprecated since 1.28,
711 was hard-deprecated. Use explicit formatting methods instead, such as
712 Message::text() and Message::escaped().
713 * BagOStuff::makeKeyInternal() usage outside of BagOStuff has been deprecated.
714 * BagOStuff::setDebug() is deprecated and calls to it are ignored. Debug logs
715 are now unconditionally enabled.
716 * The following global functions have been hard deprecated:
717 - wfAppendToArrayIfNotDefault
719 - wfClearOutputBuffers
720 - wfConfiguredReadOnlyReason
722 - wfGetPrecompiledData
724 * BeforeParserFetchTemplateAndtitleHook has been deprecated; replace
725 with the new BeforeParserFetchTemplateRevisionRecord hook. (The
726 similar ParserFetchTemplateHook was deprecated in 1.35; the new hook
728 * The InterwikiLoadPrefix hook has been deprecated; it is not compatible
729 with future wikitext parsers (which need to enumerate all interwiki
730 prefixes). In test cases please use $wgInterwikiCache instead.
731 * WikiPage instances should no longer be constructed for titles that do not
732 represent editable pages (e.g. special pages). WikiPages were always
733 documented to represent "MediaWiki article and history".
734 * Skin::getSkinStylePath() has been deprecated. Please replace usages with
735 the direct path to the resources.
736 * The second argument of EnhancedChangesList::getDiffHistLinks, $query, has
738 * The ParserTestTables hook has been deprecated; it is no longer necessary
739 after a ParserTestRunner refactoring.
740 * The following classes have been hard deprecated: CachedAction,
741 SpecialCachedPage, CacheHelper, ICacheHelper. They were unused in MediaWiki
742 ecosystem, so no replacement was provided.
743 * The ProtectionForm::buildForm hook has been deprecated. Please use the
744 ProtectionFormAddFormFields hook instead.
745 * RevisionStore::newMutableRevisionFromArray has been hard deprecated. Instead,
746 MutableRevisionRecord should be constructed directly via constructor.
747 * UserIdentity::getActorId() is deprecated. The actor ID should not be exposed
748 to application logic. Storage layer code should use the ActorNormalization
749 service for normalizing and denormalizing user names.
750 * Constructing a UserIdentityValue with an actor ID as the third parameter is
751 deprecated. The parameter should be omitted. Storage layer code should use
752 the ActorNormalization service for normalizing and denormalizing user names.
753 * Command::cgroup() is deprecated and no longer functional. $wgShellCgroup is
754 now implemented as an Executor option.
755 * Command::restrict() is deprecated. Instead use the new separate accessors.
756 * MWTidy::tidy() is deprecated. Use MediaWikiServices::getTidy()-tidy() instead.
757 * TidyDriverBase::supportsValidate() is deprecated; it has always returned
759 * WatchedItem::getUser hard-deprecated in favor of ::getUserIdentity.
760 * WatchedItemStoreInterface::enqueueWatchlistExpiryJob was hard deprecated in
761 favor of the new method maybeEnqueueWatchlistExpiryJob that takes care of
762 relevant configuration checks.
763 * LogEntry::getPerformer() and its implementations have been hard-deprecated, in
764 favor of ::getPerformerIdentity().
765 * AuthManager::singleton(), deprecated in 1.35, is hard deprecated. Use
766 MediaWikiServices::getAuthManager() instead.
767 * User::clearNotification(), deprecated in 1.35, is hard deprecated. Use
768 WatchlistManager::clearTitleUserNotification() instead.
769 * Passing string to DatabaseBlock::setBlocker was deprecated. Only UserIdentity
771 * DatabaseBlock constructor 'byText' option was deprecated in favour of 'by'
772 option, which now accepts UserIdentity. Passing user ID is deprecated.
773 * Parser::getUser was deprecated. Use Parser::getUserIdentity instead.
774 * DatabaseBlock::isWhitelistedFromAutoblocks was deprecated. Use
775 DatabaseBlock::isExemptedFromAutoblocks instead.
776 * User::isIPRange(), deprecated in 1.35, is hard deprecated.
777 Use the UserNameUtils service or IPUtils directly.
778 * BaseTemplate::getFooterIcons(), deprecated in 1.35, is hard deprecated. Read
779 footer icons from template data requested via $this->get('footericons').
780 * `box-shadow()` LESS mixin from mediawiki.mixins is deprecated due to updated
781 basic browser support. Use unprefixed property `box-shadow:` instead.
782 * MergeHistory::checkPermissions was deprecated. Use ::probablyCanMerge or
783 ::authorizeMerge instead.
784 * User::isValidUserName(), deprecated in 1.35, is hard deprecated.
785 Use the UserNameUtils service instead.
786 * The TitleArrayFromResult hook has been deprecated.
787 * The EditPageBeforeEditToolbar hook has been deprecated; it has become
788 defunct after the classic edit toolbar was removed. Use one of the many
789 other EditPage hooks instead.
790 * Deprecated the class name MediaWiki\User\WatchlistNotificationManager; use
791 MediaWiki\Watchlist\WatchlistManager instead. Deprecated the method
792 MediaWikiServices->getWatchlistNotificationManager(); use
793 MediaWikiServices->getWatchlistManager() instead.
794 * The "ArticleEditUpdatesDeleteFromRecentchanges" hook, deprecated in 1.35, has
795 been removed. Other hooks like "RecentChange_save" can be used instead.
797 === Other changes in 1.36 ===
798 * The 'tidy' key in ParserOptions (used in the parser cache) has been removed.
799 It has had no effect since 1.35.
800 * A future release of MediaWiki will make `{{=}}` a built-in parser function,
801 for use when automatically escaping the `=` character in template arguments.
802 A tracking category and parser warning have been added to this release when
803 `{{=}}` is used and it expands to something other than `=`.
804 * The implementation of TestFileReader::read has been changed to use Parsoid's
805 parser test file parser. This should be compatible with existing code, but it
806 only supports version 2 of the test file specification and may be more strict
807 when parsing invalid input, including duplicate tests.
808 * BeforeParserFetchTemplateRevisionRecord, a new hook, unifies and replaces the
809 old BeforeParserFetchTemplateAndtitleHook and ParserFetchTemplateHook.
810 * The SkinLessImportPaths attribute was added, allowing skins to add a directory
811 to the import path for LESS stylesheets. Skins can use this to provide a
812 custom version of mediawiki.skin.variables.less, setting skin-specific values
813 for certain LESS variables.
814 * The interaction between ContentHandler::getParserOutputForIndexing() and
815 ContentHandler::getDataForSearchIndex() has been clarified (the latter should
816 only be called with the result of the former). Extensions may override
817 getParserOutputForIndexing() to skip generating HTML, which may improve
818 indexing performance. (The default implementation still generates HTML, and
819 getDataForSearchIndex() implementations can still rely on it if they do not
820 over-ride getParserOutputForIndexing().)
821 * Article::fetchContentObject, ::mContentObject, ::mContentLoaded,
822 ::mRevIdFetched, all deprecated since 1.32, were removed.
823 * Article::mParserOptions and ::setParserOptions were removed.
824 * Article and ImagePage::getEmptyPageParserOutput, unused, were removed.
825 * ParserCache's default serialization format was changed from PHP serialization
826 to JSON serialization. In case some installed extension do not support JSON
827 yet, $wgParserCacheUseJson can be used to revert back to PHP serialization.
828 * PermissionManager::groupHasPermission, ::getGroupPermissions and
829 ::getGroupsWithPermission were deprecated, use GroupPermissionsLookup
831 * WatchedItemStoreInterface now accepts PageIdentity where it accepted
832 LinkTarget, calling with LinkTarget was deprecated.
833 * 'movable' attribute has been added to the 'namespaces' property of
834 extension.json schema. Extensions that define namespaces can set it to
835 `false` to disallow moving pages in the specified namespace. Extensions
836 should either use this or NamespaceIsMovableHook, but not both. The hook
837 overrides the attribute.
841 MediaWiki 1.36 requires PHP 7.3.19 or later and the following PHP extensions:
852 MySQL/MariaDB is the recommended DBMS. PostgreSQL or SQLite can also be used,
853 but support for them is somewhat less mature.
855 The supported versions are:
857 * MySQL 5.5.8 or later
858 * PostgreSQL 9.4 or later
859 * SQLite 3.8.0 or later
861 == Online documentation ==
862 Documentation for both end-users and site administrators is available on
863 MediaWiki.org, and is covered under the GNU Free Documentation License (except
864 for pages that explicitly state that their contents are in the public domain):
866 https://www.mediawiki.org/wiki/Special:MyLanguage/Documentation
869 A mailing list is available for MediaWiki user support and discussion:
871 https://lists.wikimedia.org/mailman/listinfo/mediawiki-l
873 A low-traffic announcements-only list is also available:
875 https://lists.wikimedia.org/mailman/listinfo/mediawiki-announce
877 It's highly recommended that you sign up for one of these lists if you're
878 going to run a public MediaWiki, so you can be notified of security fixes.
881 There's usually someone online in #mediawiki on irc.libera.chat.