3 == MediaWiki 1.36.0-PRERELEASE ==
5 THIS IS NOT A RELEASE YET
7 MediaWiki 1.36 is an alpha-quality development branch, and is not recommended
10 == Upgrading notes for 1.36 ==
11 Don't forget to always back up your database before upgrading!
13 See the file UPGRADE for more detailed upgrade instructions, including
14 important information when upgrading from versions prior to 1.11.
16 Some specific notes for MediaWiki 1.36 upgrades are below:
17 * MediaWiki 1.36 now requires the PHP internationalization extension
18 (commonly referred to as Intl, ext-intl and php-intl).
21 For notes on 1.35.x and older releases, see HISTORY.
23 === Configuration changes for system administrators in 1.36 ===
24 MediaWiki update script, maintenance/update.php, used to accept `--nopurge`
25 option to prevent clearing caches stored in the database during upgrade,
26 this is no longer recommended and the option has been removed.
29 ==== New configuration ====
30 * $wgManualRevertSearchRadius – this introduces a new feature that marks edits
31 as reverts if they restore the page to an exact previous state. This
32 configuration variable sets the maximum number of revisions of a page that
33 will be checked against every new edit. Set this to 0 to disable the feature
35 * $wgOldRevisionParserCacheExpireTime was added, to control caching of
36 ParserOutput for old revisions (T244058).
39 ==== Changed configuration ====
42 ==== Removed configuration ====
43 * $wgUseTwoButtonsSearchForm - This setting, deprecated in 1.35, has been
45 * $wgAllowImageMoving - This setting, deprecated in 1.35, has been removed.
46 Use group permission settings instead. For example, to prevent sysops
47 from moving files, set `$wgGroupPermissions['sysop']['movefile'] = false;`
48 * $wgExtNewTables, $wgExtNewFields, $wgExtNewIndexes, $wgExtPGNewFields,
49 $wgExtPGAlteredFields, $wgExtModifiedFields — These settings were removed.
50 They became obsolete after 1.17 overhauled the database updater, but were kept
51 for backwards compatibility. The LoadExtensionSchemaUpdates hook should be
55 === New user-facing features in 1.36 ===
56 * All HTML5 named entities are now accepted in wikitext.
59 === New developer features in 1.36 ===
60 * Parser test files can now declare a dependency on a specific extension
61 being loaded, not just on the presence of a certain extension tag hook.
62 This is a better fit for extensions like TimedMediaHandler, which affect
63 the output but don't register parser hooks. Use `extension:Foo` in
64 the `!! hooks` section of your parser test file to declare a dependency
65 on the `Foo` extension being loaded.
66 * To expose code previously present in SpecialBlock/SpecialUnblock
67 to other parts of the code, or to extensions,
68 the new BlockUser and UnblockUser command objects were added.
69 Use the BlockUserFactory and UnblockUserFactory services to create them.
70 * The hook UsersPagerDoBatchLookupsHook takes now a \Wikimedia\Rdbms\IDatabase
71 instead of \Wikimedia\Rdbms\DBConnRef as first parameter
72 * MediaHandlers can now customize the formatting of the metadata they emit
73 by overriding MediaHandler::formatTag( $key, $value ). The default for
74 unknown tags is numeric formatting; non-EXIF tags which are non-numeric
75 should always use this method to specify the desired formatting.
76 * The new 'title' type can be used to validate action API and REST API inputs.
77 * The new ArticleParserOptions hook allows customizing the parser options
78 used to parse wikitext for an article, based on user preferences, title,
80 * The new 'raw' type can be used to validate action API inputs. It bypasses
81 the Unicode NFC normalization done on inputs of type 'string', so it more
82 suitable when the input is binary or may contain deprecated Unicode
83 sequences or characters (such as U+2001) that should be passed unmodified.
86 === External library changes in 1.36 ===
89 ==== New external libraries ====
90 * Added pear/net_url2 2.2.2.
93 ===== New development-only external libraries =====
96 ==== Changed external libraries ====
97 * Updated composer/semver from 1.5.1 to 3.2.4.
98 * Updated guzzlehttp/guzzle from 6.5.4 to 7.2.0.
99 * Updated jquery.client from 2.0.2 to 3.0.0.
100 * Updated OOUI from 0.39.3 to 0.41.1.
101 * Updated pear/mail_mime from 1.10.8 to 1.10.9.
102 * Updated pear/net_smtp from 1.9.1 to 1.9.2.
103 * Updated pimple/pimple from 3.3.0 to 3.3.1.
104 * Updated wikimedia/html-formatter from 1.0.2 to 2.0.1.
105 * Updated wikimedia/ip-utils from 1.0.0 to 3.0.1.
106 * Updated wikimedia/less.php from 3.0.0 to 3.1.0.
107 * Updated wikimedia/object-factory from 2.1.0 to 3.0.0.
108 * Updated wikimedia/remex-html from 2.2.0 to 2.2.2.
109 * Updated wikimedia/xmp-reader from 0.7.0 to 0.8.0.
110 * Updated wikimedia/utfnormal from 2.0.0 to 3.0.1.
113 ===== Changed development-only external libraries =====
114 * Updated composer/spdx-licenses from 1.5.3 to 1.5.4.
115 * Updated doctrine/dbal from 2.10.2 to 3.0.0.
116 * Updated doctrine/sql-formatter from 1.1.0 to 1.1.1.
117 * Updated mediawiki/mediawiki-phan-config from 0.10.2 to 0.10.6.
118 * Updated monolog/monolog from 1.25.3 to 2.2.0.
119 * Updated nikic/php-parser from 4.4.0 to 4.10.2.
120 * Updated psy/psysh from 0.10.4 to 0.10.5.
121 * Updated seld/jsonlint from 1.7.1 to 1.8.3.
122 * Updated symfony/yaml from ~3.4|~4.3|~5.0.5 to ~3.4|~5.1.
123 * Updated wikimedia/testing-access-wrapper from 1.0.0 to 2.0.0.
126 ==== Removed external libraries ====
127 * The html5shiv library has been removed, as support for Internet Explorer 8 has
131 === Bug fixes in 1.36 ===
132 * (T190285) ApiEditPage module used to switch 'undo' and 'undoafter' parameters,
133 if it founds you reversed them (based on assumption that higher revision ID
134 indicates a later revision). The assumption is not always true and is
135 hindering proper edit undoing in some cases, hence the logic has been removed.
136 Reversing the parameters will now lead to edit conflict or undefined behavior.
137 * (T263340) In history merging, pages with a content model that does not support
138 redirects will now be recorded as deleted if no revision is being left in the
139 source page (that's if all revisions of the page have been merged to another).
142 === Action API changes in 1.36 ===
143 * (T269636) `Access-Control-Max-Age` was added to the default list of headers
144 allowed for cross-origin API requests ($wgAllowedCorsHeaders).
145 * (T258108) Accounts with the 'bot' right no longer have pages automatically
146 added to the watchlist when making API edits, regardless of their preferences.
147 This is to reduce the size of the watchlist data in the database. To add API
148 bot edits to the watchlist, explicitly set the 'watch' option.
151 === Action API internal changes in 1.36 ===
154 === Languages updated in 1.36 ===
155 MediaWiki supports over 350 languages. Many localisations are updated regularly.
156 Below only new and removed languages are listed, as well as changes to languages
157 because of Phabricator reports.
159 * (T245359) Split Bali script locale from "ban" (Balinese) (ban-bali).
160 * (T259330) Added language support for Mara (mrh).
161 * (T263968) Added language support for Nias (nia).
162 * (T264582) Added language support for Madurese (mad).
163 * (T270365) Added language support for Tyap (kcg).
165 === Breaking changes in 1.36 ===
166 * (T249459) wfIsBadImage(), deprecated in 1.34, has been removed.
167 * (T176526) EditPage::getContextTitle() will now throw an exception if a context
168 title was not set using setContextTitle(). Previously, this mis-use would only
169 cause a deprecation warning to be emitted.
170 * The DeferredStringifier class, deprecated since 1.31, was removed.
171 * Multiple methods that fell back to the $wgUser global variable were
172 individually hard deprecated previously. The following have now been removed:
173 - ApiTestCase::doLogin
174 - Article::doDeleteArticle
175 - Article::doDeleteArticleReal
176 - Article::getComment
177 - Article::getCreator
179 - Article::getUserText
180 - Article::insertProtectNullRevision
183 - ForeignDBFile::delete
184 - ForeignDBFile::recordUpload
186 - LocalFile::deleteOld
187 - LocalFile::recordUpload
188 - PageArchive::undelete
189 - RecentChange::markPatrolled
190 - Title::getUserPermissionsErrors
191 - Title::quickUserCan
193 - WebRequest::getLimitOffset
194 - WikiPage::doDeleteArticle
195 - WikiPage::insertProtectNullRevision
196 - All methods of the old SpecialPageFactory; the entire class was removed
197 * Multiple methods previously had optional User parameters, with fallbacks
198 to the $wgUser global variable. Not passing a User to those methods was
199 previously hard deprecated, and support for not passing a User has now
201 - ArchivedFile::userCan
203 - FileDeleteForm::__construct
204 - FileDeleteForm::doDelete
205 - LocalFileDeleteBatch::__construct
206 - LogEventsList::getExcludeClause (only needed for the 'user' audience)
207 - LogEventsList::userCan
208 - LogEventsList::userCanBitfield
209 - LogEventsList::userCanViewLogType
210 - LogPage::addEntry (also accepts user id instead)
211 - OldLocalFile::userCan
213 - Title::getNotificationTimestamp (though the entire method is deprecated)
214 - WikiPage::getComment (only needed for the FOR_THIS_USER audience)
215 - WikiPage::getCreator (only needed for the FOR_THIS_USER audience)
216 - WikiPage::getUser (only needed for the FOR_THIS_USER audience)
217 - WikiPage::getUserText (only needed for the FOR_THIS_USER audience)
218 * The following hooks have been removed:
220 - APIQueryRecentChangesTokens
221 - APIQueryRevisionsTokens
222 - APIQueryUsersTokens
223 - ApiTokensGetTokenTypes
224 * LogEventsList::typeAction previously accepted an optional right parameter,
225 and checked if the context user ($wgUser) had that right. Passing a right
226 was hard deprecated in 1.35, and support for passing a right has now been
228 * WikiPage::doDeleteArticleReal previously accepted an optional user as its
229 fifth parameter, and fell back to $wgUser if not user was provided. The
230 signature changed to have the user as the second parameter, and the old
231 signature was hard deprecated in 1.35. Support for the old signature has
233 * User::addNewUserLogEntry, deprecated since 1.27, was removed.
234 * As part of refactoring the EditPage class, EditPage::setPreloadedContent,
235 which had no known callers was removed entirely. Additionally, the
236 following public methods were made private:
237 - ::extractSectionTitle
238 - ::getSummaryInputWidget
239 - ::noSuchSectionPage
241 * The global function `wfWaitForSlaves`, deprecated in 1.27 and hard-deprecated
242 in 1.35, has been removed. Use LBFactory::waitForReplication() instead.
243 * The global variable $wgMemc, deprecated since 1.35, has been removed.
244 Usage should generally be migrated to WANObjectCache, or if you really need
245 the internal object, use ObjectCache::getLocalClusterInstance instead.
246 * CategoryFinder, which was deprecated in 1.31 and hard-deprecated in 1.35,
248 * GenderCache::singleton(), which was deprecated in 1.28 and hard-deprecated
249 in 1.35, has been removed.
250 * Sanitizer::escapeId(), deprecated in 1.30, has been removed.
251 * Parser::setFunctionTagHook(), deprecated in 1.35, has been removed.
252 * The ParserBeforeTidy hook, deprecated in 1.35, has been removed.
253 * The ParserBeforeTidy, ParserBeforeStrip, and ParserAfterStrip hooks,
254 deprecated in 1.35, have been removed.
255 * All methods of MWTidy except for MW::tidy() have been removed. These
256 were either @internal or deprecated in 1.35.
257 * The support for IE8 has been dropped.
258 * (T248062) Mixins `.background-image-svg()` and `.background-image-svg-quick()`
259 (provided by mediawiki.mixins.less), which have been deprecated since 1.35,
260 have now been removed. MediaWiki no longer supports any browser which would
261 require this SVG-fallback PNG support, so you can simply use the regular CSS
262 `background-image:` declaration instead.
263 * The ResourceLoader module `mediawiki.legacy.oldshared` and its file
264 'oldshared.css', deprecated since 1.35 has been removed (T248357).
265 * The LinkBegin and LinkEnd hooks, deprecated in 1.28, have been removed. You
266 can instead use the HtmlPageLinkRendererBegin and HtmlPageLinkRendererEnd
268 * Skin::getDynamicStylesheetQuery(), deprecated in 1.32, has been removed. You
269 should use action=raw&ctype=text/css directly.
270 * Skin::makeI18nUrl(), deprecated in 1.35, has been removed.
271 * The following User methods, deprecated and moved to BlockManager in 1.34,
272 were removed: isDnsBlacklisted, inDnsBlacklist, isLocallyBlockedProxy,
273 trackBlockWithCookie.
274 * Support for v1 of the parser tests file format has been removed; it was
275 deprecated in 1.35. (T174199)
276 * SpecialUnblockUser::processUIUnblock() has a different return
277 value (previously, array of messages or a boolean value, now,
278 a Status object). This function was also marked as @internal and is no
279 longer safe to call it publicly.
280 * mw.Title.getDotExtension() from the 'mediawiki.Title' module was removed
281 without deprecation. You should use mw.Title.getExtension() and prepend
283 * Profiler::getTemplated and Profiler::setTemplated, deprecated in 1.34,
285 * Removed HookContainer::getOriginalHooksForTest() without deprecation.
286 This method was introduced in 1.35 for internal use, and appears unused
287 outside of MediaWiki core.
288 * ParserCache::__construct() now requires three parameters.
289 * Message->getFormat(), deprecated in 1.29, has been removed.
290 * Support for passing Article to ParserCache::get, deprecated in 1.35,
292 * ParserCache::singleton(), deprecated in 1.30, has been removed.
293 * DatabaseBlock::deleteIfExpired and ::fromMaster, deprecated in 1.35, have been
295 * AbstractBlock::prevents, deprecated in 1.33, has been removed.
296 * AbstractBlock::shouldTrackWithCookie, deprecated in 1.34, has been removed.
297 * AbstractBlock::getBlocker, ::setBlocker, and ::getBlockErrorParams,
298 deprecated in 1.35, have been removed.
299 * Multiple DatabaseBlock methods dealing with cookies, deprecated in 1.34,
304 - ::getIdFromCookieValue
305 - ::shouldTrackWithCookie
306 * The public static callback function SpecialUnblock::processUIUnblock has been
307 removed. This method was for internal use only, and appears unused outside of
309 * ChangeTags::truncateTagDescription, deprecated in 1.35, has been removed.
310 * Deprecated null fallbacks in PasswordReset constructor have been removed.
311 * User::isEveryoneAllowed and User::getAllRights, deprecated in 1.34, has been
313 * The following methods of the UserGroupMembership class, deprecated in 1.35,
316 - ::newFromRow - use UserGroupManager::newGroupMembershipFromRow
317 - ::selectFields - use UserGroupManager::getQueryInfo
318 - ::delete - use UserGroupManager::removeUserFromGroup
319 - ::insert - use UserGroupManager::addUserToGroup
320 - ::purgeExpired - use UserGroupManager::purgeExpired
321 - ::getMembershipsForUser - use UserGroupManager::getUserGroupMemberships
322 - ::getMembership - use UserGroupManager::getUserGroupMemberships
323 * The public static callback function SpecialBlock::validateTargetField has been
324 removed. This method was for internal use only, and appears unused outside of
326 * The public static callback function SpecialUploadStash::tryClearStashedUploads
327 has been removed. This method was for internal use only, and appears unused
328 outside of MediaWiki core.
329 * SpecialComparePages::showDiff() ::revOrTitle(), ::checkExistingTitle(),
330 and ::checkExistingRevision() were marked as @internal to allow for
331 breaking changes. They are no longer safe to call. The methods were
332 unused outside of MediaWiki core.
333 * Special pages provided by core now using service injection via constructor.
334 When extending a special page the call to grandparent constructor
335 ("SpecialPage::__construct()") in the sub class breaks the extension special
336 page, because the fallback code in the parent constructor cannot set the
337 services as needed. Be sure to call the parent constructor when extending
338 core special pages. The extending of core special pages is not part of the
339 stable interface and should be avoided.
340 * Language::getExtraUserToggles and ::viewPrevNext, deprecated in 1.34, have
342 * StreamFile::send404Message and ::parseRange, deprecated in 1.34, have been
344 * SVGMetadataExtractor class, deprecated in 1.34, has been removed.
345 * ProcessCacheLRU class, deprecated in 1.32, has been removed.
346 * wfForeignMemcKey(), deprecated in 1.35, has been removed.
347 * LoadBalancer::safeWaitForMasterPos(), deprecated in 1.34, has been removed.
348 * ApiFeedRecentChanges::getFeedObject has been changed to private, and appears
349 unused outside of MediaWiki core.
350 * Skin::subPageSubtitle() has been changed to private method. Callers should
351 use Skin::prepareSubtitle().
352 * RevisionDeleter::checkRevisionExistence was removed without deprecation.
353 It had no known callers.
354 * wfForeignMemcKey() and wfMemcKey(), deprecated in 1.35, have been removed.
355 * MediaWiki now also requires the php-intl extension.
356 * BotPassword::save() now returns a Status object for the result rather than
358 * The methods in CoreTagHooks have been marked @internal and type hints have
359 been added. The methods were unused outside of MediaWiki core.
360 * SquidPurgeClient and SquidPurgeClientPool, deprecated since 1.35, have been
362 * ParserTestRunner no longer invokes the ParserTestTables hook, instead
363 cloning all database tables before running tests as MediaWikiIntegrationTest
364 does. If an extension was misusing the hook to *exclude* tables from the
365 clone, that will no longer occur and tests may fail.
366 * The UserWrapper class, which was only loaded for tests and had no uses found
367 in public MediaWiki-related git, was removed.
368 * Passing Title as a second parameter to RevisionStore::getPreviousRevision and
369 getNextRevision, hard deprecated since 1.31, was prohibited.
372 === Deprecations in 1.36 ===
373 * (T245963) User::getGrantName() is now hard deprecated and will be removed in
374 a subsequent release. Use MWGrants::grantName() instead.
375 * (T260933) UserIdentity::getId() is now deprecated. Use
376 UserIdentity::getUserId() instead.
377 * wfIncrStats() is now deprecated. Use MediaWikiServices::getInstance()
378 ->getStatsdDataFactory()->updateCount() instead.
379 * WikiPage::doEditContent() is now deprecated. Use
380 WikiPage::doUserEditContent() instead. Note that doEditContent() was also
381 deprecated in 1.32 for unrelated reasons and doUserEditContent() is
382 deprecated for other reasons, however, using doUserEditContent() is
383 recommended over using doEditContent().
384 * WikiPage::doUserEditContent() is now deprecated. Use
385 PageUpdater::saveRevision instead. Note that the new method expects callers
386 to take care of checking EDIT_MINOR against the minoredit right, and to apply
387 the autopatrol right as appropriate.
388 * LocalFile::recordUpload2, soft deprecated in 1.35, now emits deprecation
389 warnings. Use ::recordUpload3 instead.
390 * Constructing a new instance of the ParserOptions class without providing
391 a User object, which falls back to the global $wgUser, is now deprecated.
392 * The User class, which was marked as @newable in 1.35, is no longer newable,
393 meaning that it is no longer safe to manually call the constructor via
394 `new User`. Instead, use the UserFactory service.
395 * The confusingly-named User->isLoggedIn() method has been deprecated in favour
396 of the method it wraps, User->isRegistered().
397 * Use of the `preprocessor=Preprocessor_DOM` option in parser test files has
398 been deprecated. Preprocessor_DOM was removed in 1.35.
399 * ParserOptions::setTidy() has been deprecated. It has had no effect since
401 * Sanitizer::escapeIdReferenceList() has been deprecated; it will eventually
402 be made private to the class, as it appears to have no uses outside the
404 * Sanitizer::hackDocType() is deprecated; it will eventually be made private.
405 * Skin::getIndicatorsHTML() is deprecated. The functionality can be retained
406 by reimplementing the method using the raw indicators data from
407 OutputPage::getIndicators.
408 * Skin::makeVariablesScript() has been deprecated. Use
409 ResourceLoader::makeInlineScript() instead.
410 * The PageProps class was converted to a service. PageProps::overrideInstance
411 was deprecated, and MediaWikiServices::redefineService should be used
413 * Title::nameOf() is deprecated; use Title::newFromID()->getPrefixedDBkey()
415 * DatabaseBlock::insert, DatabaseBlock::update, DatabaseBlock::purgeExpired and
416 DatabaseBlock::delete are deprecated. Use DatabaseBlockStore::insertBlock,
417 DatabaseBlockStore::updateBlock, DatabaseBlockStore::purgeExpiredBlocks and
418 DatabaseBlockStore::deleteBlock instead.
419 * SpecialBlock::getTargetAndType is deprecated. Call AbstractBlock::parseTarget
421 * SpecialUnblock::processUnblock was deprecated - use UnblockUserFactory
423 * Deprecated MediaWikiIntegrationtestCase::removeTemporaryHook() in favor of
424 MediaWikiIntegrationtestCase::clearHook().
425 * Skin::getSearchLink(), also exposed as 'searchaction' option in SkinTemplate,
426 has been deprecated. Use Title or SpecialPage methods directly.
427 * Skin::getAllowedSkins and ::getSkinNames have been deprecated. Use their
428 respective equivalents in SkinFactory instead.
429 * The RollbackComplete hook has been deprecated, use the PageSaveComplete hook
431 * Skin::makeUrl() has been deprecated. Title methods should be used instead.
432 * Skin::privacyLink(), Skin::disclaimerLink() and Skin::aboutLink() have been
433 deprecated. Please use Skin::footerLink() instead.
434 * Skin::getLogo() has been deprecated. Use ResourceLoaderSkinModule instead.
435 * The module `mediawiki.toc.styles` has been replaced by
436 ResourceLoaderSkinModule. If you are having problems styling table of contents
437 ensure you have an updated skin.
438 * Skin::mainPageLink() has been deprecated. Use LinkRenderer service instead.
439 * BaseTemplate::getToolbox() method has been hard deprecated. The toolbox data
440 is now available in a sidebar data array which you can get from any class
441 that's extending QuickTemplate class.
442 * Constructing a DefaultPreferencesFactory, LinkHolderArray or PasswordReset
443 without a $hookContainer parameter is deprecated.
444 * Autopromote class, soft deprecated since 1.35, now emits deprecation warnings.
445 Use UserGroupManager instead.
446 * SpecialBlock::canBlockEmail has been deprecated. Please use
447 BlockPermissionChecker::checkEmailPermissions instead.
448 * SpecialBlock::checkUnblockSelf has been deprecated. Please use
449 BlockPermissionChecker::checkBlockPermissions instead.
450 * SpecialBlock::parseExpiryInput was deprecated - use
451 BlockUser::parseExpiryInput instead.
452 * SpecialBlock::validateTarget has been deprecated, use BlockUtils instead.
453 * SpecialBlock::validateTargetField has been deprecated for external use,
454 use BlockUtils instead.
455 * SpecialPage::getLanguageConverter has been deprecated, use
456 LanguageConverterFactory::getLanguageConverter() directly.
457 * ParserCache::getKey has been deprecated. Use ParserCache::getMetadata and
458 ParserCache::makeParserOutputKey instead.
459 * The PHPUnit4And6Compat class, used to provide compatibility with PHPUnit 4,
460 was removed. MediaWiki support for PHPUnit 4 ended with the removal of HHVM
462 * The PHPUnit6And8Compat class, used to provide compatibility with PHPUnit 6,
463 was removed without deprecation. This class was introduced during the
464 upgrade to PHPUnit 8, but never used.
465 * MediaWikiIntegrationTestCase::assertType, hard-deprecated in 1.35 due to
466 incompatibility with PHPUnit 8, was removed.
467 * ParserCache::getETag has been deprecated, instead build suitable etag
469 * The following functions from the Language class have been hard deprecated
470 and will be removed in a subsequent release:
473 - updateConversionTable
475 * The mw.language.commafy client-side method has been deprecated, to match
476 the deprecation of Language::commafy. Use mw.language.convertNumber
478 * Title::isDeleted() and Title::isDeletedQuick() have been deprecated. Please
479 use Title::getDeletedEditsCount() and Title::hasDeletedEdits() instead.
480 * Article::getContentObject, soft-deprecated since 1.32, was hard-deprecated.
481 * WikiRevision::importUpload, soft-deprecated since 1.31, was hard-deprecated.
482 * Html::infoBox() has been deprecated. There's no replacement.
483 * BagOStuff::makeKeyInternal() usage outside of BagOStuff has been deprecated.
484 * BagOStuff::setDebug() is deprecated and calls to it are ignored. Debug logs
485 are now unconditionally enabled.
486 * The following global functions have been hard deprecated:
487 - wfAppendToArrayIfNotDefault
489 - wfClearOutputBuffers
490 - wfConfiguredReadOnlyReason
492 - wfGetPrecompiledData
494 * The InterwikiLoadPrefix hook has been deprecated; it is not compatible
495 with future wikitext parsers (which need to enumerate all interwiki
496 prefixes). In test cases please use $wgInterwikiCache instead.
497 * Skin::getSkinStylePath() has been deprecated. Please replace usages with
498 the direct path to the resources.
499 * The second argument of EnhancedChangesList::getDiffHistLinks, $query, has
501 * The ParserTestTables hook has been deprecated; it is no longer necessary
502 after a ParserTestRunner refactoring.
503 * The following classes have been hard deprecated: CachedAction,
504 SpecialCachedPage, CacheHelper, ICacheHelper. They were unused in MediaWiki
505 ecosystem, so no replacement was provided.
506 * The ProtectionForm::buildForm hook has been deprecated. Please use the
507 ProtectionFormAddFormFields hook instead.
508 * RevisionStore::newMutableRevisionFromArray has beed hard deprecated. Instead,
509 MutableRevisionRecord should be constructed directly via constructor.
512 === Other changes in 1.36 ===
513 * The 'tidy' key in ParserOptions (used in the parser cache) has been removed.
514 It has had no effect since 1.35.
515 * A future release of MediaWiki will make {{=}} a built-in parser function,
516 for use when automatically escaping the `=` character in template arguments.
517 A tracking category and parser warning have been added to this release when
518 {{=}} is used and it expands to something other than `=`.
519 * The implementation of TestFileReader::read has been changed to use
520 Parsoid's parser test file parser. This should be compatible with
521 existing code, but it only supports version 2 of the test file
522 specification and may be more strict when parsing invalid input,
523 including duplicate tests.
524 * The SkinLessImportPaths attribute was added, allowing skins to add a
525 directory to the import path for LESS stylesheets. Skins can use this
526 to provide a custom version of mediawiki.skin.variables.less, setting
527 skin-specific values for certain LESS variables.
528 * The interaction between ContentHandler::getParserOutputForIndexing()
529 and ContentHandler::getDataForSearchIndex() has been clarified
530 (the latter should only be called with the result of the former).
531 Extensions may override getParserOutputForIndexing() to skip generating HTML,
532 which may improve indexing performance. (The default implementation
533 still generates HTML, and getDataForSearchIndex() implementations can still
534 rely on it if they do not override getParserOutputForIndexing().)
535 * Article::fetchContentObject, ::mContentObject, ::mContentLoaded,
536 ::mRevIdFetched, deprecated since 1.32, were removed.
537 * Article::mParserOptions and ::setParserOptions were removed.
538 * Article and ImagePage::getEmptyPageParserOutput, unused, were removed.
539 * ParserCache default serialization format was changed from PHP serialization
540 to JSON serialization. In case some installed extension do not support JSON
541 yet, $wgParserCacheUseJson can be used to revert back to PHP serialization.
542 * PermissionManager::groupHasPermission, ::getGroupPermissions and
543 ::getGroupsWithPermission were deprecated, use GroupPermissionsLookup
547 MediaWiki 1.36 requires PHP 7.2.22 or later, and the following PHP extensions:
558 MySQL/MariaDB is the recommended DBMS. PostgreSQL or SQLite can also be used,
559 but support for them is somewhat less mature.
561 The supported versions are:
563 * MySQL 5.5.8 or later
564 * PostgreSQL 9.4 or later
565 * SQLite 3.8.0 or later
567 == Online documentation ==
568 Documentation for both end-users and site administrators is available on
569 MediaWiki.org, and is covered under the GNU Free Documentation License (except
570 for pages that explicitly state that their contents are in the public domain):
572 https://www.mediawiki.org/wiki/Special:MyLanguage/Documentation
575 A mailing list is available for MediaWiki user support and discussion:
577 https://lists.wikimedia.org/mailman/listinfo/mediawiki-l
579 A low-traffic announcements-only list is also available:
581 https://lists.wikimedia.org/mailman/listinfo/mediawiki-announce
583 It's highly recommended that you sign up for one of these lists if you're
584 going to run a public MediaWiki, so you can be notified of security fixes.
587 There's usually someone online in #mediawiki on irc.freenode.net.