2021-04-06 20:49:22 +00:00
|
|
|
|
= MediaWiki 1.37 =
|
|
|
|
|
|
|
|
|
|
|
|
== MediaWiki 1.37.0-PRERELEASE ==
|
|
|
|
|
|
|
|
|
|
|
|
THIS IS NOT A RELEASE YET
|
|
|
|
|
|
|
2021-09-16 02:13:04 +00:00
|
|
|
|
MediaWiki 1.37 is an beta-quality release branch, and is not recommended
|
2021-04-06 20:49:22 +00:00
|
|
|
|
for use in production.
|
|
|
|
|
|
|
|
|
|
|
|
== Upgrading notes for 1.37 ==
|
|
|
|
|
|
Don't forget to always back up your database before upgrading!
|
|
|
|
|
|
|
2021-04-06 23:25:35 +00:00
|
|
|
|
See the file UPGRADE for more detailed per-version upgrade instructions from the
|
|
|
|
|
|
oldest supported upgrading version, MediaWiki 1.27.
|
2021-04-06 20:49:22 +00:00
|
|
|
|
|
|
|
|
|
|
Some specific notes for MediaWiki 1.37 upgrades are below:
|
2021-04-20 13:42:53 +00:00
|
|
|
|
* (T280806) Deprecated methods of fetching API tokens have been removed. This
|
|
|
|
|
|
may cause older bots and scripts to fail. Most queries are trivially
|
|
|
|
|
|
updateable to using new methods. See the Action API changes section below
|
|
|
|
|
|
for more information.
|
2021-04-06 20:49:22 +00:00
|
|
|
|
|
|
|
|
|
|
For notes on 1.36.x and older releases, see HISTORY.
|
|
|
|
|
|
|
|
|
|
|
|
=== Configuration changes for system administrators in 1.37 ===
|
2021-09-05 16:56:31 +00:00
|
|
|
|
* (T242768) The PasswordCannotMatchUsername password policy has been removed,
|
|
|
|
|
|
please use PasswordCannotBeSubstringInUsername instead. If you have not
|
|
|
|
|
|
customised your password policies, there will be nothing to do here.
|
2021-04-06 20:49:22 +00:00
|
|
|
|
|
|
|
|
|
|
==== New configuration ====
|
2020-07-21 20:00:23 +00:00
|
|
|
|
* $wgBrowserFormatDetection - This setting allows the enabling or disabling
|
2021-09-16 02:13:04 +00:00
|
|
|
|
of automatic detection of possible phone numbers in a webpage in iOS Safari.
|
2021-04-06 20:49:22 +00:00
|
|
|
|
|
|
|
|
|
|
==== Changed configuration ====
|
2021-09-16 02:13:04 +00:00
|
|
|
|
* $wgContentHandlerTextFallback - This migration setting, which defines how to
|
|
|
|
|
|
react if a plain text version of a non-text Content object is requested using
|
|
|
|
|
|
ContentHandler::getContentText(), is deprecated.
|
|
|
|
|
|
* $wgActions – This setting lets sysadmins over-ride which actions can be used.
|
|
|
|
|
|
It has been re-worked to support injecting dependencies into Action sub-
|
|
|
|
|
|
classes as part of wider work on dependency injection. Previously, $wgActions
|
|
|
|
|
|
was an array where the keys were the names of actions, and the values had the
|
|
|
|
|
|
following impacts (for a given key 'Foo'):
|
2021-08-02 01:59:15 +00:00
|
|
|
|
- `true`: use the class 'FooAction' unless for a specific page
|
2021-09-16 02:13:04 +00:00
|
|
|
|
WikiPage::getActionOverrides() wants to override that action
|
|
|
|
|
|
- a string: use the class with that name, and do not allow over-riding on a
|
|
|
|
|
|
per-page basis
|
2021-08-02 01:59:15 +00:00
|
|
|
|
- `false`: the action is disabled
|
2021-09-16 02:13:04 +00:00
|
|
|
|
- a callable: use the Action instance returned by invoking that callback, and
|
|
|
|
|
|
do not allow overriding on a per-page basis
|
|
|
|
|
|
- an object: use that specific Action instance, and do not allow overr-iding
|
|
|
|
|
|
on a per-page basis.
|
|
|
|
|
|
As part of T253078, values can now be arrays that are not callables, which are
|
|
|
|
|
|
treated as ObjectFactory specs, allowing for services to be injected.
|
|
|
|
|
|
Additionally, the distinction between values that allow per-page overrides and
|
|
|
|
|
|
those that do not was removed - all actions can now be overridden on a per-
|
|
|
|
|
|
page basis using WikiPage::getActionOverrides().
|
|
|
|
|
|
* $wgShellboxUrl – This setting, new in 1.36 to configure the novel Shellbox
|
|
|
|
|
|
encapsulation system, is now deprecated; use $wgShellboxUrls as a mapping of
|
2021-06-18 08:41:28 +00:00
|
|
|
|
service => URL instead.
|
2021-09-16 02:13:04 +00:00
|
|
|
|
* $wgIncludejQueryMigrate – This setting, introduced in 1.29 to on whether to
|
|
|
|
|
|
provide a migration layer for jQuery, has now switched its default value from
|
|
|
|
|
|
true to false. This may break gadgets that depended on methods that were
|
|
|
|
|
|
removed in jQuery 3 in 2017. See T280944 for more information.
|
2021-04-18 23:07:14 +00:00
|
|
|
|
* A number of settings have been renamed. The former configuration variable
|
|
|
|
|
|
names are deprecated, but will be used as the fall back if they are still set,
|
2021-09-16 02:13:04 +00:00
|
|
|
|
and remain temporarily available for extensions which might try to read them:
|
2021-04-18 23:07:14 +00:00
|
|
|
|
- $wgFileBlacklist is now $wgProhibitedFileExtensions
|
|
|
|
|
|
- $wgMimeTypeBlacklist is now $wgMimeTypeExclusions
|
|
|
|
|
|
- $wgEnableUserEmailBlacklist is now $wgEnableUserEmailMuteList
|
|
|
|
|
|
- $wgShortPagesNamespaceBlacklist is now $wgShortPagesNamespaceExclusions
|
2021-09-16 02:13:04 +00:00
|
|
|
|
* $wgMimeTypeExclusions - As well as being renamed, this configuration array now
|
|
|
|
|
|
also prohibits the RFC 4329 form of JavaScript, 'application/javascript', as
|
|
|
|
|
|
well as previous MIME types.
|
|
|
|
|
|
* $wgFragmentMode - This setting, which determines the encoding of section IDs,
|
|
|
|
|
|
has now switched its default value from legacy-first to html5-first: both the
|
|
|
|
|
|
HTML5 anchor and the legacy percent-encoding-style anchor will still be
|
|
|
|
|
|
generated for section titles, but references to them will use the HTML5
|
|
|
|
|
|
version, resulting in human-readable fragments.
|
2021-04-06 20:49:22 +00:00
|
|
|
|
|
|
|
|
|
|
==== Removed configuration ====
|
2021-07-13 17:40:29 +00:00
|
|
|
|
* $wgLegacyJavaScriptGlobals, deprecated in 1.36.
|
2021-09-16 02:13:04 +00:00
|
|
|
|
* (T274695) $wgAjaxEditStash, deprecated in 1.36.
|
2021-07-13 17:40:29 +00:00
|
|
|
|
* $wgShowDBErrorBacktrace, deprecated and non-functional since 1.32.
|
|
|
|
|
|
* $wgShowSQLErrors, deprecated and non-functional since 1.32.
|
2021-09-16 02:13:04 +00:00
|
|
|
|
* $wgLangObjCacheSize, without deprecation; the LanguageFactory service now
|
|
|
|
|
|
always retains at most 10 objects in its LRU-cache.
|
|
|
|
|
|
* $wgDjvuToXML, without deprecation; the tool it enables is obsolete and
|
|
|
|
|
|
abandoned upstream. Use $wgDjvuDump to use that tool instead.
|
2021-04-06 20:49:22 +00:00
|
|
|
|
|
|
|
|
|
|
=== New user-facing features in 1.37 ===
|
2021-03-14 01:07:51 +00:00
|
|
|
|
* (T161934) MediaWiki now supports JPEG2000 files, to a limited extent.
|
2021-04-06 20:49:22 +00:00
|
|
|
|
|
|
|
|
|
|
=== New developer features in 1.37 ===
|
|
|
|
|
|
|
|
|
|
|
|
=== External library changes in 1.37 ===
|
|
|
|
|
|
|
|
|
|
|
|
==== New external libraries ====
|
2021-09-13 21:19:21 +00:00
|
|
|
|
* Added symfony/polyfill-php80 1.23.1.
|
2021-04-15 11:56:41 +00:00
|
|
|
|
* Added whatwg-fetch 3.6.2.
|
2021-07-02 21:05:23 +00:00
|
|
|
|
* Added wikimedia/normalized-exception 1.0.1.
|
2021-04-06 20:49:22 +00:00
|
|
|
|
|
|
|
|
|
|
===== New development-only external libraries =====
|
|
|
|
|
|
|
|
|
|
|
|
==== Changed external libraries ====
|
2021-04-24 02:33:12 +00:00
|
|
|
|
* Updated OOjs from v5.0.0 to v6.0.0
|
2021-09-09 23:49:16 +00:00
|
|
|
|
* Updated OOjs-Router from v0.2.0 to v0.3.0
|
2021-08-19 06:56:04 +00:00
|
|
|
|
* Updated OOUI from v0.41.3 to v0.42.0
|
2021-08-27 02:25:45 +00:00
|
|
|
|
* Updated WVUI from v0.1.0 to v0.3.0
|
2021-09-09 19:44:48 +00:00
|
|
|
|
* Updated cssjanus/cssjanus from v1.3.0 to v2.1.0.
|
2021-04-25 18:41:41 +00:00
|
|
|
|
* Updated psr/container from v1.0.0 to v1.1.1.
|
2021-07-27 23:07:12 +00:00
|
|
|
|
* Updated wikimedia/minify from v2.2.2 to v2.2.4.
|
2021-04-25 18:41:41 +00:00
|
|
|
|
* Updated wikimedia/object-factory from v3.0.0 to v3.0.2.
|
2021-04-26 17:16:32 +00:00
|
|
|
|
* Updated wikimedia/parsoid from v0.13.0-a20 to v0.14.0-a1.
|
2021-08-03 17:20:27 +00:00
|
|
|
|
* Updated wikimedia/relpath from v2.1.1 to v3.0.0.
|
2021-08-08 18:47:54 +00:00
|
|
|
|
* Updated wikimedia/remex-html from v2.3.1 to v2.3.2.
|
2021-08-23 18:18:42 +00:00
|
|
|
|
* Updated wikimedia/shellbox from v1.0.4 to v2.0.0.
|
2021-08-23 21:21:18 +00:00
|
|
|
|
* Updated wikimedia/wait-condition-loop from v2.0.1 to v2.0.2.
|
2021-04-06 20:49:22 +00:00
|
|
|
|
|
|
|
|
|
|
===== Changed development-only external libraries =====
|
2021-07-23 15:48:08 +00:00
|
|
|
|
* Updated qunit from 2.10.0 to 2.16.0.
|
2021-04-06 20:49:22 +00:00
|
|
|
|
|
|
|
|
|
|
==== Removed external libraries ====
|
2021-04-02 01:18:18 +00:00
|
|
|
|
* The pimple/pimple development-only library has been removed.
|
2021-04-06 20:49:22 +00:00
|
|
|
|
|
|
|
|
|
|
=== Bug fixes in 1.37 ===
|
|
|
|
|
|
|
|
|
|
|
|
=== Action API changes in 1.37 ===
|
2021-09-16 02:13:04 +00:00
|
|
|
|
* (T280806) The API methods for fetching tokens which were deprecated in
|
|
|
|
|
|
MediaWiki 1.24 have been removed. action=query&meta=tokens&type= should be
|
|
|
|
|
|
used instead. Please note some token types no longer exist, and you should
|
|
|
|
|
|
just use type=csrf for those instead.
|
2021-04-20 13:42:53 +00:00
|
|
|
|
- action=query&prop=info&intoken ->
|
|
|
|
|
|
action=query&meta=tokens&type=csrf
|
2021-09-16 02:13:04 +00:00
|
|
|
|
- action=tokens&type= ->
|
|
|
|
|
|
action=query&meta=tokens&type=
|
2021-04-20 13:42:53 +00:00
|
|
|
|
- action=query&list=recentchanges&rctoken ->
|
|
|
|
|
|
action=query&meta=tokens&type=csrf
|
|
|
|
|
|
- action=query&prop=revisions&rvtoken=rollback ->
|
|
|
|
|
|
action=query&meta=tokens&type=rollback
|
|
|
|
|
|
- action=query&meta=userinfo&uiprop=preferencestoken ->
|
|
|
|
|
|
action=query&meta=tokens&type=csrf
|
|
|
|
|
|
- action=query&list=users&ustoken=userrights ->
|
|
|
|
|
|
action=query&meta=tokens&type=userrights
|
2021-04-06 20:49:22 +00:00
|
|
|
|
|
|
|
|
|
|
=== Action API internal changes in 1.37 ===
|
|
|
|
|
|
|
|
|
|
|
|
=== Languages updated in 1.37 ===
|
|
|
|
|
|
MediaWiki supports over 350 languages. Many localisations are updated regularly.
|
|
|
|
|
|
Below only new and removed languages are listed, as well as changes to languages
|
|
|
|
|
|
because of Phabricator reports.
|
|
|
|
|
|
|
2021-04-17 07:29:24 +00:00
|
|
|
|
* (T280435) LRM and RLM characters were removed from names of languages with
|
|
|
|
|
|
parentheses in Names.php
|
2021-05-22 16:20:58 +00:00
|
|
|
|
* (T283422) Add namespace name translations and change the autonym of
|
|
|
|
|
|
the Kinyarwanda language to "Ikinyarwanda".
|
2021-05-30 08:10:28 +00:00
|
|
|
|
* (T283423) Change the autonym of the Lombard language from "lumbaart"
|
|
|
|
|
|
to "lombard".
|
2021-04-08 08:52:21 +00:00
|
|
|
|
* (T279619) Added language support for Dagbani (dag).
|
2021-05-05 15:07:28 +00:00
|
|
|
|
* (T282085) Added language support for Malay in Arabic (Jawi) script (ms-arab).
|
2021-05-18 11:08:56 +00:00
|
|
|
|
* (T283053) Added language support for Ojibwe (ojb).
|
2021-05-24 09:10:08 +00:00
|
|
|
|
* (T283480) Added language support for Wallisian (wls, Fakaʻuvea).
|
2021-05-28 12:10:47 +00:00
|
|
|
|
* (T284002) Added language support for Paiwan (pwn).
|
2021-06-01 08:31:35 +00:00
|
|
|
|
* (T284044) Added language support for Carpathian Romani (rmc).
|
2021-07-12 04:38:36 +00:00
|
|
|
|
* (T286460) Added language support for Gun (guw, Gungbe).
|
2021-07-26 07:20:15 +00:00
|
|
|
|
* (T287345) Added language support for Baoulé (bci).
|
2021-09-10 14:07:26 +00:00
|
|
|
|
* (T290126) Added language support for Kildin Sami (sjd).
|
|
|
|
|
|
* (T290408) Added language support for Pite Sami (sje).
|
2018-10-17 17:33:21 +00:00
|
|
|
|
* (T25216) Started the renaming of the language code for Norman from nrm to
|
|
|
|
|
|
nrf.
|
2021-04-06 20:49:22 +00:00
|
|
|
|
|
|
|
|
|
|
=== Breaking changes in 1.37 ===
|
2021-09-16 02:13:04 +00:00
|
|
|
|
* The Revision class, emitting deprecation warnings since 1.35, was removed
|
|
|
|
|
|
entirely. As part of this, the following hooks that included a Revision object
|
2021-04-11 20:49:08 +00:00
|
|
|
|
were removed:
|
2021-09-16 02:13:04 +00:00
|
|
|
|
- ArticleRevisionUndeleted - use RevisionUndeleted
|
|
|
|
|
|
- ArticleRollbackComplete - use RollbackComplete
|
|
|
|
|
|
- DiffRevisionTools - use DiffTools
|
|
|
|
|
|
- DiffViewHeader - use DifferenceEngineViewHeader
|
|
|
|
|
|
- HistoryRevisionTools - use HistoryTools
|
|
|
|
|
|
- NewRevisionFromEditComplete - use RevisionFromEditComplete
|
|
|
|
|
|
- PageContentInsertComplete - use PageSaveComplete
|
|
|
|
|
|
- PageContentSaveComplete - use PageSaveComplete
|
|
|
|
|
|
- ParserFetchTemplate - use BeforeParserFetchTemplateRevisionRecord
|
|
|
|
|
|
- RevisionInsertComplete - use RevisionRecordInserted
|
|
|
|
|
|
- TitleMoveComplete - use PageMoveComplete
|
|
|
|
|
|
- TitleMoveCompleting - use PageMoveCompleting
|
|
|
|
|
|
- UndeleteShowRevision - no replacement
|
|
|
|
|
|
- UserRetrieveNewTalks - no replacement
|
|
|
|
|
|
… the following methods and variables have been removed:
|
|
|
|
|
|
- Article::$mRevision
|
|
|
|
|
|
- Article::getRevisionFetched()
|
|
|
|
|
|
- ContribsPager::tryToCreateValidRevision()
|
|
|
|
|
|
- EditPage::$mBaseRevision
|
|
|
|
|
|
- EditPage::getBaseRevision()
|
|
|
|
|
|
- LinksUpdate::getRevision()
|
|
|
|
|
|
- LinksUpdate::setRevision()
|
|
|
|
|
|
- PageArchive::getArchivedRevision()
|
|
|
|
|
|
- PageArchive::getPreviousRevision()
|
|
|
|
|
|
- PageArchive::getRevision()
|
|
|
|
|
|
- Parser::$mRevisionObject
|
|
|
|
|
|
- Parser::fetchCurrentRevisionOfTitle()
|
|
|
|
|
|
- Parser::getRevisionObject()
|
|
|
|
|
|
- Parser::statelessFetchRevision()
|
|
|
|
|
|
- ParserOptions::getCurrentRevisionCallback()
|
|
|
|
|
|
- ParserOptions::setCurrentRevisionCallback()
|
|
|
|
|
|
- Title::countAuthorsBetween()
|
|
|
|
|
|
- Title::getFirstRevision()
|
|
|
|
|
|
- User::getNewMessageLinks()
|
|
|
|
|
|
- User::getNewMessageRevisionId()
|
|
|
|
|
|
- User::setNewtalk()
|
|
|
|
|
|
- WikiPage::getOldestRevision()
|
|
|
|
|
|
- WikiPage::getRevision()
|
|
|
|
|
|
- WikiPage::getUndoContent()
|
|
|
|
|
|
- WikiPage::updateIfNewerOn()
|
|
|
|
|
|
… and the following methods no longer accept Revision objects as parameters:
|
|
|
|
|
|
- CategoryMembershipChange::__construct()
|
|
|
|
|
|
- ContentHandler::getUndoContent()
|
|
|
|
|
|
- DerivedPageDataUpdater::prepareUpdate()
|
|
|
|
|
|
- DifferenceEngine::getRevisionHeader()
|
|
|
|
|
|
- Linker::buildRollbackLink()
|
|
|
|
|
|
- Linker::generateRollback()
|
|
|
|
|
|
- Linker::getRevDeleteLink()
|
|
|
|
|
|
- Linker::getRollbackEditCount()
|
|
|
|
|
|
- Linker::revComment()
|
|
|
|
|
|
- Linker::revUserLink()
|
|
|
|
|
|
- Linker::revUserTools()
|
|
|
|
|
|
- WikiPage::doDeleteUpdates()
|
|
|
|
|
|
- WikiPage::doEditUpdates()
|
|
|
|
|
|
- WikiPage::hasDifferencesOutsideMainSlot()
|
|
|
|
|
|
- WikiPage::onArticleEdit()
|
|
|
|
|
|
- WikiPage::prepareContentForEdit()
|
|
|
|
|
|
- WikiPage::updateRevisionOn()
|
2021-05-02 02:44:33 +00:00
|
|
|
|
The following methods return arrays that formerly included a 'revision'
|
|
|
|
|
|
key that would emit deprecation warnings when accessed and return a
|
|
|
|
|
|
Revision object. The Revision object has been removed from the arrays,
|
|
|
|
|
|
and the 'revision-record' key should be used to get the relevant
|
|
|
|
|
|
RevisionRecord instead:
|
2021-09-16 02:13:04 +00:00
|
|
|
|
- PageUpdater::doCreate()
|
|
|
|
|
|
- PageUpdater::doModify()
|
|
|
|
|
|
- Parser::statelessFetchTemplate()
|
|
|
|
|
|
- WikiPage::doEditContent()
|
|
|
|
|
|
Finally, the ParserOptions `templateCallback` option is a callback that is
|
|
|
|
|
|
called in Parser::fetchTemplateAndTitle() and should return an array - the
|
2021-05-02 02:44:33 +00:00
|
|
|
|
'revision' key to that array used to be a Revision object and was used if
|
2021-09-16 02:13:04 +00:00
|
|
|
|
no 'revision-record' was returned - is now ignored.
|
EPIC: Remove the Revision class entirely
Following soft deprecation in 1.31, hard deprecation
in 1.35, and removal of remaining deprecated uses,
the entire Revision class, and the tests for it, can
now be removed. This will be followed by a patch to
clean up old references in comments - this is just
dealing with the code.
There were some other tests in RevisionDbTest.php
for Title::getNextRevisionID and Title::getRelativeRevisionID,
which could have been kept, but since those methods are
tested separately in TitleTest, no need to keep these, so
just remove the entire file.
Also remove the RevisionTestModifyableContent and
RevisionTestModifyableContentHandler classes that were
only loaded for use in RevisionDbTest - not sure how
the stable interface policy applies to classes that
are only loaded within tests, so mention that in the
release notes as a breaking change.
Bug: T247143
Change-Id: I05a297d28b85c7413384979f5c908be318098d9d
2021-05-02 22:26:07 +00:00
|
|
|
|
* Previously, the classes RevisionTestModifyableContent and
|
2021-09-16 02:13:04 +00:00
|
|
|
|
RevisionTestModifyableContentHandler were loaded for use in tests, but were
|
|
|
|
|
|
only used within the tests for the since-removed Revision class. This content
|
|
|
|
|
|
and content handler class were removed without deprecation.
|
|
|
|
|
|
* WANObjectCache::HOLDOFF_NONE, deprecated since 1.35, was removed. Use
|
|
|
|
|
|
WANObjectCache::HOLDOFF_TTL_NONE instead.
|
|
|
|
|
|
* Calling ResourceLoader::makeVersionQuery() without $modules parameter,
|
|
|
|
|
|
deprecated since MediaWiki 1.34, is no longer supported.
|
2021-06-15 07:03:23 +00:00
|
|
|
|
* LocalFile::recordUpload2(), deprecated since 1.35, was removed.
|
2021-09-16 02:13:04 +00:00
|
|
|
|
* The following methods and fields in the Language class, deprecated since 1.35,
|
|
|
|
|
|
have been removed:
|
|
|
|
|
|
- ::classFromCode()
|
|
|
|
|
|
- ::clearCaches()
|
|
|
|
|
|
- ::convertTitle()
|
|
|
|
|
|
- ::findVariantLink()
|
|
|
|
|
|
- ::$mConverter
|
|
|
|
|
|
- ::updateConversionTable()
|
|
|
|
|
|
* The following methods in the Parser class have been removed after having been
|
|
|
|
|
|
deprecated in 1.35:
|
2021-04-25 17:29:33 +00:00
|
|
|
|
- fetchTemplate()
|
|
|
|
|
|
- Title()
|
2021-02-17 04:11:46 +00:00
|
|
|
|
* (T273354) When an edit is prevented by an 'EditFilterMergedContent' hook
|
|
|
|
|
|
handler without changing the status, the edit form will now be displayed.
|
2021-04-08 19:34:40 +00:00
|
|
|
|
* User::clearNotification() which had been deprecated in 1.35 has been removed.
|
|
|
|
|
|
Use WatchlistManager::clearTitleUserNotification() instead.
|
2021-04-30 23:25:07 +00:00
|
|
|
|
* User::getNewtalk() which had been deprecated in 1.35 has been removed. Use
|
|
|
|
|
|
TalkPageNotificationManager::userHasNewMessages() instead.
|
2021-09-16 02:13:04 +00:00
|
|
|
|
* The Autopromote class, deprecated since 1.35, was removed. Use
|
2021-04-19 04:07:09 +00:00
|
|
|
|
UserGroupManager instead.
|
2021-09-16 02:13:04 +00:00
|
|
|
|
* The CachedAction, SpecialCachedPage, CacheHelper, and ICacheHelper classes,
|
|
|
|
|
|
all emitting deprecation warnings since 1.36, have been removed.
|
2021-03-28 16:19:05 +00:00
|
|
|
|
* The hooks BeforeHttpsRedirect, CanIPUseHTTPS and UserRequiresHTTPS, deprecated
|
|
|
|
|
|
in 1.35, were removed.
|
2021-06-02 13:46:17 +00:00
|
|
|
|
* The TitleArrayFromResult hook, deprecated in 1.36, was removed.
|
2021-04-21 02:15:03 +00:00
|
|
|
|
* The deprecated "es6-promise" alias ResourceLoader module has been removed. Use
|
2021-09-16 02:13:04 +00:00
|
|
|
|
the "es6-polyfills" module directly intead.
|
2021-07-17 07:28:41 +00:00
|
|
|
|
* The deprecated "mediawiki.legacy.protect" ResourceLoader module, deprecated
|
|
|
|
|
|
since 1.36, has been removed. Use "mediawiki.action.protect" instead.
|
2021-09-16 02:13:04 +00:00
|
|
|
|
* The AuthenticationProvider interface and the SessionProvider class no longer
|
|
|
|
|
|
extend the PSR LoggerAwareInterface concept, so they can't be typehinted as
|
|
|
|
|
|
LoggerAwareInterface.
|
|
|
|
|
|
* User::getGrantName(), emitting deprecation warnings since 1.36, has been
|
|
|
|
|
|
removed. Use MWGrants::grantName() instead.
|
2021-05-09 01:58:32 +00:00
|
|
|
|
* The following ApiBase methods, deprecated since 1.35, have been removed:
|
|
|
|
|
|
- ApiBase::explodeMultiValue
|
|
|
|
|
|
- ApiBase::parseMultiValue
|
|
|
|
|
|
- ApiBase::validateLimit
|
|
|
|
|
|
- ApiBase::validateTimestamp
|
2021-09-16 02:13:04 +00:00
|
|
|
|
* The User::idCacheByName() public static field was removed without deprecation.
|
|
|
|
|
|
Instead of using it, get a UserIdentity by name from the UserIdentityLookup
|
|
|
|
|
|
service.
|
|
|
|
|
|
* IDatabase::upsert() and IDatabase::replace() now only accept a single unique
|
|
|
|
|
|
key. Previously, a warning was issued if there were multiple unique keys
|
|
|
|
|
|
provided.
|
2021-05-08 18:39:28 +00:00
|
|
|
|
* The MediaWiki:Autoblock_whitelist block exemption control was moved in 1.36 to
|
|
|
|
|
|
MediaWiki:Block-autoblock-exemptionlist. The backward-compatibility of reading
|
|
|
|
|
|
the old MediaWiki:Autoblock_whitelist page has now been dropped.
|
2021-09-16 02:13:04 +00:00
|
|
|
|
* The following overridable methods in File hierarchy have changed signatures:
|
|
|
|
|
|
- File::deleteFile() - now accepts UserIdentity instead of User
|
|
|
|
|
|
- File::getDescription() - now accepts Authority instead of User
|
|
|
|
|
|
- File::userCan() - now accepts Authority instead of User
|
|
|
|
|
|
- LocalFile::deleteOldFile() - now accepts UserIdentity instead of User
|
2021-05-10 22:03:58 +00:00
|
|
|
|
* The following global methods, each deprecated since 1.36, have been removed:
|
2021-09-16 02:13:04 +00:00
|
|
|
|
- wfAppendToArrayIfNotDefault()
|
|
|
|
|
|
- wfAcceptToPrefs()
|
|
|
|
|
|
- wfConfiguredReadOnlyReason()
|
|
|
|
|
|
- wfDebugMem()
|
|
|
|
|
|
- wfGetPrecompiledData()
|
|
|
|
|
|
- wfNegotiateType()
|
|
|
|
|
|
* The following deprecated methods of the Title class have been removed:
|
|
|
|
|
|
- ::nameOf(), deprecated in 1.36
|
|
|
|
|
|
- ::getPreviousRevisionID(), deprecated in 1.34
|
|
|
|
|
|
- ::getNextRevisionID(), deprecated in 1.34
|
|
|
|
|
|
- ::getEarliestRevTime(), deprecated in 1.35
|
|
|
|
|
|
* UploadBase::stashFile(), deprecated since 1.28, was removed.
|
2021-05-16 16:44:38 +00:00
|
|
|
|
* wfGetRusage(), deprecated since 1.35, has been removed.
|
2021-03-17 18:19:25 +00:00
|
|
|
|
* The following CLI options were removed from tests/phpunit.php:
|
2021-09-16 02:13:04 +00:00
|
|
|
|
- use-filebackend
|
|
|
|
|
|
- use-jobqueue
|
|
|
|
|
|
- use-bagostuff
|
2021-03-17 18:19:25 +00:00
|
|
|
|
The following options (inherited from Maintenance) were also removed:
|
2021-09-16 02:13:04 +00:00
|
|
|
|
- conf
|
|
|
|
|
|
- dbuser
|
|
|
|
|
|
- dbpass
|
|
|
|
|
|
- dbdefaultgroup
|
|
|
|
|
|
- globals
|
|
|
|
|
|
- memory-limit
|
|
|
|
|
|
- profiler
|
|
|
|
|
|
- server
|
2021-03-17 18:19:25 +00:00
|
|
|
|
The following options were changed to environment variables:
|
2021-09-16 02:13:04 +00:00
|
|
|
|
- wiki => PHPUNIT_WIKI
|
|
|
|
|
|
- use-normal-tables => PHPUNIT_USE_NORMAL_TABLES
|
|
|
|
|
|
- use-filebackend => PHPUNIT_USE_FILEBACKEND
|
|
|
|
|
|
- use-bagostuff => PHPUNIT_USE_BAGOSTUFF
|
|
|
|
|
|
- use-jobqueue => PHPUNIT_USE_JOBQUEUE
|
2021-03-17 18:19:25 +00:00
|
|
|
|
This is so that we can use the default PHPUnit entry point (T90875).
|
2021-05-19 09:23:29 +00:00
|
|
|
|
* The PHPUNIT_REUSE_DB / --reuse-db option was removed from the phpunit.php
|
|
|
|
|
|
runner. It had been broken for at least three years already. The original use
|
|
|
|
|
|
case was speeding up tests on Oracle, but Oracle support was dropped several
|
|
|
|
|
|
releases ago.
|
2021-03-20 15:03:10 +00:00
|
|
|
|
* The MediaWikiPHPUnitTest__endTestHook and MediaWikiPHPUnitTest__startTestHook
|
|
|
|
|
|
PHPUnit hooks were removed. MediaWikiHooksPHPUnitExtension was also removed.
|
2021-06-02 13:35:17 +00:00
|
|
|
|
* EntryPoint::getTextFormatters() was made private without a deprecation period;
|
|
|
|
|
|
it had no known external callers.
|
2021-09-16 02:13:04 +00:00
|
|
|
|
* DatabaseBlock::chooseBlock(), deprecated since 1.35, was removed.
|
|
|
|
|
|
* SpecialPageFactory::getRestrictedPages(), deprecated since 1.36, was removed.
|
|
|
|
|
|
* SpecialBlock::validateTarget(), deprecated since 1.36, was removed.
|
2021-05-29 04:35:08 +00:00
|
|
|
|
* The PatchFileLocation trait was removed without deprecation.
|
2021-09-16 02:13:04 +00:00
|
|
|
|
* ActorMigrationBase::getExistingActorId() and ::getNewActorId(), emitting
|
|
|
|
|
|
deprecation warnings since 1.36, were removed.
|
|
|
|
|
|
* Hook handlers implementing the MediaWikiServicesHook hook are now prohibited
|
|
|
|
|
|
from having services injected. This is because by definition, this hook runs
|
|
|
|
|
|
before the service container is fully initialized.
|
Use the unserialized form of image metadata internally
Image metadata is usually a serialized string representing an array.
Passing the string around internally and having everything unserialize
it is an awkward convention.
Also, many image handlers were reading the file twice: once for
getMetadata() and again for getImageSize(). Often getMetadata()
would actually read the width and height and then throw it away.
So, in filerepo:
* Add File::getMetadataItem(), which promises to allow partial
loading of metadata per my proposal on T275268 in a future commit.
* Add File::getMetadataArray(), which returns the unserialized array.
Some file handlers were returning non-serializable strings from
getMetadata(), so I gave them a legacy array form ['_error' => ...]
* Changed MWFileProps to return the array form of metadata.
* Deprecate the weird File::getImageSize(). It was apparently not
called by anything, but was overridden by UnregisteredLocalFile.
* Wrap serialize/unserialize with File::getMetadataForDb() and
File::loadMetadataFromDb() in preparation for T275268.
In MediaHandler:
* Merged MediaHandler::getImageSize() and MediaHandler::getMetadata()
into getSizeAndMetadata(). Deprecated the old methods.
* Instead of isMetadataValid() we now have isFileMetadataValid(), which
only gets a File object, so it can decide what data it needs to load.
* Simplified getPageDimensions() by having it return false for non-paged
media. It was not called in that case, but was implemented anyway.
In specific handlers:
* Rename DjVuHandler::getUnserializedMetadata() and
extractTreesFromMetadata() for clarity. "Metadata" in these function
names meant an XML string.
* Updated DjVuImage::getImageSize() to provide image sizes in the new
style.
* In ExifBitmapHandler, getRotationForExif() now takes just the
Orientation tag, rather than a serialized string. Also renamed for
clarity.
* In GIFMetadataExtractor, return the width, height and bits per channel
instead of throwing them away. There was some conflation in
decodeBPP() which I picked apart. Refer to GIF89a section 18.
* In JpegMetadataExtractor, process the SOF0/SOF2 segment to extract
bits per channel, width, height and components (channel count). This
is essentially a port of PHP's getimagesize(), so should be bugwards
compatible.
* In PNGMetadataExtractor, return the width and height, which were
previously assigned to unused local variables. I verified the
implementation by referring to the specification.
* In SvgHandler, retain the version validation from unpackMetadata(),
but rename the function since it now takes an array as input.
In tests:
* In ExifBitmapTest, refactored some tests by using a provider.
* In GIFHandlerTest and PNGHandlerTest, I removed the tests in which
getMetadata() returns null, since it doesn't make sense when ported to
getMetadataArray(). I added tests for empty arrays instead.
* In tests, I retained serialization of input data since I figure it's
useful to confirm that existing database rows will continue to be read
correctly. I removed serialization of expected values, replacing them
with plain data.
* In tests, I replaced access to private class constants like
BROKEN_FILE with string literals, since stability is essential. If
the class constant changes, the test should fail.
Elsewhere:
* In maintenance/refreshImageMetadata.php, I removed the check for
shrinking image metadata, since it's not easy to implement and is
not future compatible. Image metadata is expected to shrink in
future.
Bug: T275268
Change-Id: I039785d5b6439d71dcc21dcb972177dba5c3a67d
2021-05-19 00:24:32 +00:00
|
|
|
|
* The protected property LocalFile::$metadata was removed without deprecation.
|
2021-09-16 02:13:04 +00:00
|
|
|
|
* WatchedItem::getUser(), emitting deprecation warnings since 1.36, has been
|
|
|
|
|
|
removed.
|
|
|
|
|
|
* AuthManager::singleton(), emitting deprecation warnings since 1.36, has been
|
|
|
|
|
|
removed.
|
2021-06-24 07:01:21 +00:00
|
|
|
|
* The AugmentPageProps class was removed without deprecation. It had no known
|
|
|
|
|
|
uses.
|
2021-09-16 02:13:04 +00:00
|
|
|
|
* Html::infobox(), deprecated since 1.36, was removed.
|
2021-06-24 00:38:27 +00:00
|
|
|
|
* ParserOptions::__construct() now requires that the first parameter is a
|
|
|
|
|
|
UserIdentity object - passing `null` used to fallback to the global
|
|
|
|
|
|
$wgUser but was deprecated since 1.36.
|
|
|
|
|
|
* ParserOptions::newCanonical() no longer supports the first parameter being
|
|
|
|
|
|
null (or omitted entirely), which would fallback to the global $wgUser but
|
|
|
|
|
|
was deprecated since 1.35.
|
2021-06-23 13:18:02 +00:00
|
|
|
|
* The SkinTemplatePreventOtherActiveTabs hook, deprecated in 1.35, was removed
|
|
|
|
|
|
entirely.
|
2021-06-23 13:23:45 +00:00
|
|
|
|
* The SkinTemplateTabAction hook, deprecated in 1.35, was removed entirely.
|
2021-06-23 13:26:03 +00:00
|
|
|
|
* The SkinTemplateBuildNavUrlsNav_urlsAfterPermalink hook, deprecated in 1.35,
|
|
|
|
|
|
was removed entirely.
|
2021-08-03 00:13:23 +00:00
|
|
|
|
* The SkinTemplateToolboxEndHook, deprecated in 1.35, was removed entirely.
|
2021-09-16 02:13:04 +00:00
|
|
|
|
* The following methods of RevisionStore class, formerly emitting deprecation
|
|
|
|
|
|
warnings, were removed:
|
|
|
|
|
|
- ::newMutableRevisionFromArray()
|
|
|
|
|
|
- ::loadRevisionFromPageId()
|
|
|
|
|
|
- ::loadRevisionFromTitle()
|
|
|
|
|
|
- ::loadRevisionFromTimestamp()
|
|
|
|
|
|
- ::listRevisionSizes()
|
|
|
|
|
|
* LogEntry::getPerformer(), deprecated since 1.36, was removed along with
|
|
|
|
|
|
methods in sub-classes: DatabaseLogEntry, ManualLogEntry, RCDatabaseLogEntry.
|
|
|
|
|
|
* Skin::getRelevantUser() now returns an instance of UserIdentity, and not
|
|
|
|
|
|
necessarily a User object. There is no known usages in MediaWiki ecosystem
|
|
|
|
|
|
that were not satisfied with UserIdentity.
|
2021-06-22 14:35:13 +00:00
|
|
|
|
* Direct construction of MergeHistory class, deprecated since 1.35, is no longer
|
|
|
|
|
|
supported. Use MergeHistoryFactory instead. MergeHistory::checkPermissions,
|
|
|
|
|
|
deprecated since 1.36, was removed.
|
2021-07-13 21:06:49 +00:00
|
|
|
|
* Skin::generateDebugHTML(), deprecated since 1.35, was removed. Call
|
|
|
|
|
|
MWDebug::getHTMLDebugLog() directly.
|
2021-06-24 03:54:48 +00:00
|
|
|
|
* The ApiTestCase class no longer interacts with the global $wgUser.
|
|
|
|
|
|
Previously, the global variable was set at the start of each test, and in
|
|
|
|
|
|
ApiTestCase::doApiRequest() if a performer was specified $wgUser was
|
|
|
|
|
|
updated to match, and if no performer was specified $wgUser was used
|
|
|
|
|
|
instead. Now, $wgUser is not updated, and if no performer is specified
|
|
|
|
|
|
the reusable TestUser object for the sysop is relied on. Extensions
|
|
|
|
|
|
or skins that rely on the global $wgUser variable (which has been
|
|
|
|
|
|
deprecated since 1.35) should instead retrieve the acting user from the
|
|
|
|
|
|
relevant context source.
|
2021-09-16 02:13:04 +00:00
|
|
|
|
* SkinTemplate::makeArticleUrlDetails(), deprecated since 1.35, was removed.
|
|
|
|
|
|
* Skin::makeNSUrl(), deprecated since 1.35, was removed.
|
2021-07-15 19:52:30 +00:00
|
|
|
|
* Skin::getRevisionId(), deprecated since 1.34, was removed. Use
|
|
|
|
|
|
OutputPage::getRevisionId() instead.
|
|
|
|
|
|
* Skin::isRevisionCurrent(), deprecated since 1.34, was removed. Use
|
|
|
|
|
|
OutputPage::isRevisionCurrent() instead.
|
2021-07-15 23:00:08 +00:00
|
|
|
|
* AbstractBlock::parseTarget(), deprecated since 1.36, was removed.
|
2021-09-16 02:13:04 +00:00
|
|
|
|
* The ArticleEditUpdates hook, deprecated since 1.35, was removed.
|
|
|
|
|
|
* The `@stable to extend` class CentralIdLookup has following changes:
|
|
|
|
|
|
- The protected ::checkAudience() method now returns an Authority instead of a
|
|
|
|
|
|
User instance.
|
|
|
|
|
|
- A number of its `@stable to override` methods now accept an Authority
|
|
|
|
|
|
instead of a User instance as the $audience parameter.
|
|
|
|
|
|
- A number of methods now accept a UserIdentity instead of their User
|
|
|
|
|
|
parameter.
|
|
|
|
|
|
- The ::localUserFromCentralId() method now returns UserIdentity and not
|
|
|
|
|
|
necessarily a User object.
|
2021-06-22 21:26:40 +00:00
|
|
|
|
All extensions that extend this class or use this method were updated to be
|
|
|
|
|
|
ready to the new behavior.
|
2021-09-16 02:13:04 +00:00
|
|
|
|
* WatchedItemStoreInterface::enqueueWatchlistExpiryJob(), deprecated since 1.36,
|
2021-07-23 08:50:53 +00:00
|
|
|
|
was removed.
|
2021-07-15 00:46:59 +00:00
|
|
|
|
* ResultWrapper is now abstract. It cannot be directly constructed (T286694).
|
2021-07-19 12:51:06 +00:00
|
|
|
|
* The SecondaryDataUpdates hook, deprecated in 1.32, was removed entirely.
|
2021-07-21 11:28:35 +00:00
|
|
|
|
* Content::getDeletionUpdates(), was removed. Use
|
|
|
|
|
|
ContentHandler::getDeletionUpdates() instead.
|
2021-07-22 09:56:07 +00:00
|
|
|
|
* Content::getSecondaryDataUpdates(), was removed. Use
|
|
|
|
|
|
ContentHandler::getSecondaryDataUpdates() instead.
|
2021-07-23 11:27:46 +00:00
|
|
|
|
* wfDiff(), deprecated since 1.25, has been removed.
|
2021-07-16 17:38:02 +00:00
|
|
|
|
* Language::$mLangObjCache, deprecated since 1.35, was removed.
|
2021-08-03 18:02:52 +00:00
|
|
|
|
* Language::$transformData, deprecated since 1.35, was removed.
|
|
|
|
|
|
* Language::transformUsingPairFile() was marked @internal. Its deprecated
|
|
|
|
|
|
parameters are no longer supported.
|
2021-06-25 15:36:19 +00:00
|
|
|
|
* SpecialMute::getTarget(), unused outside of the SpecialMute class, was
|
|
|
|
|
|
made private.
|
2021-09-16 02:13:04 +00:00
|
|
|
|
* The Skin::setupSkinUserCss() method, deprecated in 1.32, was removed. Please
|
|
|
|
|
|
use skin registration instead.
|
2021-03-30 21:54:58 +00:00
|
|
|
|
* The ResourceLoaderSkinModule `legacy`, `content` and `content-thumbnails`
|
|
|
|
|
|
features were deprecated. Skins should instead select from the features
|
|
|
|
|
|
listed on [[mw:Manual:ResourceLoaderSkinModule]].
|
2021-09-16 02:13:04 +00:00
|
|
|
|
* ParserCache::getKey() and ::getEtag(), deprecated since 1.36, were removed.
|
2021-07-31 14:26:12 +00:00
|
|
|
|
* The BaseTemplateToolbox hook, deprecated since 1.35, was removed.
|
2018-05-26 14:58:37 +00:00
|
|
|
|
* Previously a capitalize-all-nouns class was added to the body element of
|
2021-07-31 14:26:12 +00:00
|
|
|
|
languages where nouns must be capitalized. This class is no longer added to
|
|
|
|
|
|
the body tag and must be provided by skins.
|
|
|
|
|
|
* The SkinTemplateOutputPageBeforeExec hook, deprecated since 1.35, was removed.
|
2021-09-16 02:13:04 +00:00
|
|
|
|
* Calling Message::toString() without a parameter, which triggered deprecation
|
|
|
|
|
|
warnings since 1.36, is no longer supported. You can instead use the explicit
|
|
|
|
|
|
formatting methods directly, such as Message::text() and Message::escaped().
|
|
|
|
|
|
* Article::getContentObject(), deprecated since 1.32, was removed.
|
|
|
|
|
|
* Article::delete(), Article::confirmDelete() and ImagePage::delete() now emit
|
|
|
|
|
|
deprecation warnings. The logic responsible for building the form is being
|
|
|
|
|
|
moved to DeleteAction, while the actual deletion logic will be moved to a
|
|
|
|
|
|
separate service.
|
|
|
|
|
|
* WikiImporter::debugRevisionHandler(), unused and for debug only, was removed.
|
|
|
|
|
|
* Content::preloadTransform() now emits deprecation warnings. Instead, please
|
|
|
|
|
|
use ContentTransformer::preloadTransform(). Extensions defining a content
|
|
|
|
|
|
model should override ContentHandler::preloadTransform().
|
|
|
|
|
|
* Content::preSaveTransform() now emits deprecation warnings. Instead, please
|
|
|
|
|
|
use ContentTransformer::preSaveTransform() instead. Extensions defining
|
|
|
|
|
|
a content model should override ContentHandler::preSaveTransform().
|
|
|
|
|
|
* Constructing WikiPage objects from Title instances that cannot exist, emitting
|
|
|
|
|
|
deprecation warnings since 1.36, now throws an exception. Additionally,
|
|
|
|
|
|
WikiPage now implements ProperPageIdentity, rather than just PageIdentity.
|
|
|
|
|
|
* The Skin::bottomScripts() method is deprecated. Please instead use
|
|
|
|
|
|
OutputPage::getBottomScripts().
|
|
|
|
|
|
* LinksUpdate::getTriggeringUser() now returns ?UserIdentity instead of ?User.
|
2021-04-06 20:49:22 +00:00
|
|
|
|
|
|
|
|
|
|
=== Deprecations in 1.37 ===
|
2021-09-16 02:13:04 +00:00
|
|
|
|
* JobQueue::getWiki(), deprecated in 1.33, now emits deprecation warnings.
|
|
|
|
|
|
* AbstractBlock::getTargetAndType() and ::getTarget() now emit deprecation
|
|
|
|
|
|
warnings. Use ::getTargetName() and ::getTargetUserIdentity() together with
|
|
|
|
|
|
::getType().
|
|
|
|
|
|
* Passing a UserIdentity to WatchlistManager::clearAllUserNotifications() and
|
|
|
|
|
|
WatchlistManager::clearTitleUserNotifications() is now deprecated. Pass an
|
|
|
|
|
|
Authority instead.
|
|
|
|
|
|
* Passing LinkTarget to WatchlistManager::clearTitleUserNotifications() and
|
2021-03-26 22:24:43 +00:00
|
|
|
|
WatchlistManager::getTitleNotificationTimestamp(). Pass PageIdentity instead.
|
2021-09-16 02:13:04 +00:00
|
|
|
|
* The User class methods ::isWatched(), ::isTempWatched(), ::removeWatch(), and
|
|
|
|
|
|
::addWatch() have been deprecated. Use corresponding methods in
|
|
|
|
|
|
WatchlistManager instead.
|
|
|
|
|
|
* Multiple WatchAction methods have been deprecated in lieu of WatchlistManager:
|
|
|
|
|
|
- ::doWatchOrUnwatch() use WatchlistManager::setWatch()
|
|
|
|
|
|
- ::doWatch() -> WatchlistManager::addWatch()
|
|
|
|
|
|
- ::doUnwatch() -> WatchlistManager::removeWatch()
|
|
|
|
|
|
* WatchAction::getWatchToken() now emits deprecation warnings. Instead use
|
|
|
|
|
|
CsrfTokenSet::getToken().
|
2021-08-02 01:56:24 +00:00
|
|
|
|
* Action::getHookContainer() has been marked as internal. Actions that require
|
|
|
|
|
|
access to a hook container should have one injected instead.
|
2021-09-16 02:13:04 +00:00
|
|
|
|
* The ::getTitle() and ::setTitle() methods in Parser have been deprecated.
|
|
|
|
|
|
Use ::getPage() and ::setPage() instead.
|
2021-04-08 19:34:40 +00:00
|
|
|
|
* Title::isWatchable() has been deprecated. Use WatchlistManager::isWatchable()
|
|
|
|
|
|
instead.
|
2021-05-14 22:05:55 +00:00
|
|
|
|
* Methods and classes related to the primary database, previously referred to as
|
|
|
|
|
|
'master', have been deprecated, with the new ones replacing them as follows:
|
|
|
|
|
|
- The DBMasterPos and MySQLMasterPos classes have been respectively renamed to
|
|
|
|
|
|
DBPrimaryPos and MySQLPrimaryPos.
|
|
|
|
|
|
- LocalRepo::getMasterDB() -> ::getPrimaryDB()
|
|
|
|
|
|
- ForeignDBRepo::getMasterDB() -> ::getPrimaryDB()
|
|
|
|
|
|
- JobQueueDB::getMasterDB() -> ::getPrimaryDB()
|
|
|
|
|
|
- ForeignDBViaLBRepo::getMasterDB() -> ::getPrimaryDB()
|
|
|
|
|
|
- DBFileJournal::getMasterDB() -> ::getPrimaryDB()
|
|
|
|
|
|
- ILoadBalancer::getMasterPos() -> ::getPrimaryPos()
|
|
|
|
|
|
- IDatabase::getMasterPos() -> ::getPrimaryPos()
|
|
|
|
|
|
- ILoadBalancer::finalizeMasterChanges() -> ::finalizePrimaryChanges()
|
2021-05-14 22:10:00 +00:00
|
|
|
|
- ILoadBalancer::approveMasterChanges() -> ::approvePrimaryChanges()
|
2021-05-14 22:16:39 +00:00
|
|
|
|
- ILoadBalancer::beginMasterChanges() -> ::beginPrimaryChanges()
|
|
|
|
|
|
- ILBFactory::beginMasterChanges() -> ::beginPrimaryChanges()
|
2021-05-14 22:22:15 +00:00
|
|
|
|
- ILoadBalancer::commitMasterChanges() -> ::commitPrimaryChanges()
|
|
|
|
|
|
- ILBFactory::commitMasterChanges() -> ::commitPrimaryChanges()
|
2021-09-02 18:52:20 +00:00
|
|
|
|
- IDatabase::getTopologyRootMaster() -> ::getTopologyRootPrimary()
|
2021-09-02 18:57:19 +00:00
|
|
|
|
- IDatabase::masterPosWait() -> ::primaryPosWait()
|
2021-09-02 19:04:20 +00:00
|
|
|
|
- ILoadBalancer::runMasterTransactionIdleCallbacks() ->
|
|
|
|
|
|
::runPrimaryTransactionIdleCallbacks()
|
2021-09-02 19:07:38 +00:00
|
|
|
|
- ILoadBalancer::runMasterTransactionListenerCallbacks() ->
|
|
|
|
|
|
::runPrimaryTransactionListenerCallbacks()
|
2021-09-02 19:14:52 +00:00
|
|
|
|
- ILoadBalancer::rollbackMasterChanges() -> ::rollbackPrimaryChanges()
|
|
|
|
|
|
- ILBFactory::rollbackMasterChanges() -> ::rollbackPrimaryChanges()
|
2021-09-02 19:18:11 +00:00
|
|
|
|
- ILoadBalancer::flushMasterSnapshots() -> ::flushPrimarySnapshots()
|
2021-09-02 19:23:30 +00:00
|
|
|
|
- ILoadBalancer::hasMasterConnection() -> ::hasPrimaryConnection()
|
2021-09-02 19:27:32 +00:00
|
|
|
|
- ILoadBalancer::hasMasterChanges() -> ::hasPrimaryChanges()
|
|
|
|
|
|
- ILBFactory::hasMasterChanges() -> ::hasPrimaryChanges()
|
2021-09-02 19:29:57 +00:00
|
|
|
|
- ILoadBalancer::lastMasterChangeTimestamp() -> ::lastPrimaryChangeTimestamp()
|
2021-09-02 19:35:05 +00:00
|
|
|
|
- ILoadBalancer::hasOrMadeRecentMasterChanges() ->
|
|
|
|
|
|
::hasOrMadeRecentPrimaryChanges()
|
|
|
|
|
|
- ILBFactory::hasOrMadeRecentMasterChanges() ->
|
|
|
|
|
|
::hasOrMadeRecentPrimaryChanges()
|
2021-09-02 22:49:16 +00:00
|
|
|
|
- ILoadBalancer::pendingMasterChangeCallers() ->
|
|
|
|
|
|
::pendingPrimaryChangeCallers()
|
2021-09-02 22:54:07 +00:00
|
|
|
|
- ILoadBalancer::forEachOpenMasterConnection() ->
|
|
|
|
|
|
::forEachOpenPrimaryConnection()
|
2021-09-02 22:58:37 +00:00
|
|
|
|
- ILoadBalancer::waitForMasterPos() -> ::waitForPrimaryPos()
|
2021-09-02 23:06:36 +00:00
|
|
|
|
- Database::assertIsWritableMaster() -> ::assertIsWritablePrimary()
|
2021-09-16 02:13:04 +00:00
|
|
|
|
- RevDelList::reloadFromMaster() -> ::reloadFromPrimary()
|
|
|
|
|
|
- ExternalStoreDB::getMaster() -> ::getPrimary()
|
2021-09-02 23:23:41 +00:00
|
|
|
|
- DatabaseMysqlBase::getMasterServerInfo() -> ::getPrimaryServerInfo()
|
2021-09-04 00:36:34 +00:00
|
|
|
|
- MWExceptionHandler::rollbackMasterChangesAndLog() ->
|
|
|
|
|
|
::rollbackPrimaryChangesAndLog()
|
2021-09-16 02:13:04 +00:00
|
|
|
|
* wfGetLB(), deprecated since 1.27, now emits deprecation warnings.
|
|
|
|
|
|
* wfLocalFile(), deprecated since 1.34, now emits deprecation warnings.
|
|
|
|
|
|
* wfFindFile(), deprecated since 1.34, now emits deprecation warnings.
|
2021-04-11 15:55:02 +00:00
|
|
|
|
* wfIncrStats(), deprecated in 1.36, now emits deprecation warnings.
|
2021-03-28 16:19:05 +00:00
|
|
|
|
* wfCanIPUseHTTPS() is now deprecated, and always returns true.
|
2021-05-01 01:28:36 +00:00
|
|
|
|
* The UserLoadFromDatabase hook has been deprecated. It had no known uses.
|
2021-04-30 14:41:54 +00:00
|
|
|
|
* The following methods in ApiPageSet have been deprecated:
|
2021-09-16 02:13:04 +00:00
|
|
|
|
- ::getTitles(), use ::getTargets() instead.
|
|
|
|
|
|
- ::getGoodTitles(), use ::getGoodPages() instead.
|
|
|
|
|
|
- ::getMissingTitles(), use ::getMissingPages() instead.
|
|
|
|
|
|
- ::getGoodAndMissingTitles(), use ::getGoodAndMissingPages() instead.
|
|
|
|
|
|
- ::getRedirectTitles(), use ::getRedirectTargets() instead.
|
|
|
|
|
|
- ::getSpecialTitles(), use ::getSpecialPages() instead.
|
|
|
|
|
|
* The following methods from the User class, deprecated in 1.35, now each emit
|
2021-04-12 14:45:26 +00:00
|
|
|
|
deprecation warnings:
|
2021-09-16 02:13:04 +00:00
|
|
|
|
- ::getOptions()
|
|
|
|
|
|
- ::isIP()
|
|
|
|
|
|
- ::isUsableName()
|
|
|
|
|
|
- ::isCreatableName()
|
|
|
|
|
|
- ::getCanonicalName()
|
|
|
|
|
|
- ::addAutopromoteOnceGroups()
|
|
|
|
|
|
- ::getEffectiveGroups()
|
|
|
|
|
|
- ::getAutomaticGroups()
|
|
|
|
|
|
- ::getFormerGroups()
|
|
|
|
|
|
- ::getIntOption()
|
|
|
|
|
|
- ::getBoolOption()
|
2021-04-06 20:53:56 +00:00
|
|
|
|
* The following methods in User were deprecated:
|
2021-09-16 02:13:04 +00:00
|
|
|
|
- ::idFromName() - use UserIdentityLookup::getUserIdentityByName() instead.
|
|
|
|
|
|
- ::resetIdByNameCache() - in tests, reset service container. No replacement
|
2021-04-06 20:53:56 +00:00
|
|
|
|
needed in production code.
|
2021-04-22 06:00:25 +00:00
|
|
|
|
* Use of ActorMigration for any table except revision, deprecated in 1.34, now
|
|
|
|
|
|
emits deprecation warnings. Instead of getInsertValues(), use
|
|
|
|
|
|
ActorNormalization::acquireActorId(). Instead of getWhere() and getJoin(),
|
|
|
|
|
|
do your own join on the actor table.
|
2021-04-26 20:25:28 +00:00
|
|
|
|
* DatabasePostgres::remappedTableName() and its dependent constructor parameter
|
|
|
|
|
|
'keywordTableMap' are deprecated. Reserved identifiers that are used as table
|
|
|
|
|
|
names should be quoted where necessary.
|
2021-05-03 12:29:14 +00:00
|
|
|
|
* LinkCache::singleton(), deprecated since 1.28, now emits deprecation warnings.
|
2021-05-03 13:08:33 +00:00
|
|
|
|
* MessageCache::singleton(), deprecated since 1.34, now emits deprecation
|
|
|
|
|
|
warnings.
|
2021-05-03 14:38:44 +00:00
|
|
|
|
* LockManagerGroup::singleton() and ::destroySingletons(), deprecated since
|
|
|
|
|
|
1.34, now emit deprecation warnings.
|
2021-05-07 22:19:29 +00:00
|
|
|
|
* HtmlFileCacheUpdate::newFromTitles() is now deprecated and emitting warnings.
|
|
|
|
|
|
Use newFromPages() instead.
|
2021-09-16 02:13:04 +00:00
|
|
|
|
* SessionProvider ::setLogger(), ::setManager(), ::setConfig(), and
|
|
|
|
|
|
::setHookContainer() were deprecated. Use ::init() to inject dependencies, or
|
|
|
|
|
|
override ::postInitSetup() to do any custom post-initialization configuration.
|
|
|
|
|
|
* AbstractAuthenticationProvider ::setLogger(), ::setManager(), ::setConfig(),
|
|
|
|
|
|
and ::setHookContainer() now emit deprecation warnings. Use ::init() to inject
|
|
|
|
|
|
dependencies, or override ::postInitSetup() to do any custom post-
|
|
|
|
|
|
initialization configuration.
|
|
|
|
|
|
* User::isLoggedIn(), deprecated since 1.36, now emits deprecation warnings. Use
|
|
|
|
|
|
the method it wraps, User::isRegistered(), instead.
|
2021-05-03 19:22:09 +00:00
|
|
|
|
* FileBackendGroup::singleton() and ::destroySingletons(), deprecated since
|
|
|
|
|
|
1.35, now emit deprecation warnings.
|
2021-09-16 02:13:04 +00:00
|
|
|
|
* The first parameter of User::getBlock() should now be an integer using the
|
2021-03-10 19:40:33 +00:00
|
|
|
|
Authority::FOR_XXX constants. Providing a boolean is deprecated.
|
|
|
|
|
|
* ApiBase::addBlockInfoToStatus() is deprecated for use by extensions. It is now
|
|
|
|
|
|
marked as @internal and may be deleted in the future.
|
|
|
|
|
|
It should not be necessary to call this method, Authority should be providing
|
|
|
|
|
|
all relevant information via a PermissionStatus object.
|
2021-09-16 02:13:04 +00:00
|
|
|
|
* JobQueueGroup::singleton() was deprecated - use
|
|
|
|
|
|
MediaWikiServices::getJobQueueGroup() instead.
|
|
|
|
|
|
* JobQueueGroup::destroySingletons() was deprecated. JobQueueGroups are now
|
2021-03-17 12:37:06 +00:00
|
|
|
|
automatically destroyed after tests.
|
2021-09-16 02:13:04 +00:00
|
|
|
|
* LinkCache::addGoodLinkObj() has been deprecated, since it is prone to
|
2021-06-09 21:17:21 +00:00
|
|
|
|
corrupting the cache with invalid information. Use addGoodLinkObjFromRow()
|
|
|
|
|
|
instead. PHPUnit tests must use LinkCacheTestTrait::addGoodLinkObject().
|
2021-09-16 02:13:04 +00:00
|
|
|
|
* ContentHandler::getContentText() is now deprecated. Use Content::getText()
|
|
|
|
|
|
instead.
|
2021-06-01 20:14:36 +00:00
|
|
|
|
* LinkCache::addLinkObj() has been deprecated, use PageStore::getPageForLink()
|
|
|
|
|
|
instead.
|
2021-09-16 02:13:04 +00:00
|
|
|
|
* MediaWiki\User\UserNamePrefixSearch::search() previously accepted as its first
|
|
|
|
|
|
parameter either the string 'public' or a UserIdentity object, to filter
|
|
|
|
|
|
results for. It now expects an Authority object instead of UserIdentity, and
|
|
|
|
|
|
providing just a UserIdentity will now trigger a deprecation warning.
|
2021-05-20 15:14:28 +00:00
|
|
|
|
* User::getRights(), deprecated since 1.34, now emits deprecation warnings.
|
2021-09-16 02:13:04 +00:00
|
|
|
|
* User::changeableGroups() and ::changeableByGroup() now emit deprecation
|
|
|
|
|
|
warnings, use corresponding methods in UserGroupManager instead.
|
2021-04-24 04:54:48 +00:00
|
|
|
|
* User::incEditCount() was deprecated in favor of the new method
|
|
|
|
|
|
UserEditTracker::incrementUserEditCount().
|
2021-09-16 02:13:04 +00:00
|
|
|
|
* RepoGroup::singleton(), ::destroySingleton() and ::setSingleton(), deprecated
|
|
|
|
|
|
since 1.34, now emit deprecation warnings.
|
|
|
|
|
|
* RecentChange::getPerformer(), deprecated since 1.36, now emits deprecation
|
|
|
|
|
|
warnings. Use ::getPerformerIdentity() instead.
|
2021-06-02 14:14:15 +00:00
|
|
|
|
* ContentHandler::cleanupHandlersCache(), deprecated since 1.35, now emits
|
|
|
|
|
|
deprecation warnings.
|
2021-07-29 14:19:22 +00:00
|
|
|
|
* Category::getTitle() was deprecated in favor of Category::getPage()
|
2021-09-16 02:13:04 +00:00
|
|
|
|
* File::getUser() method now emits deprecation warnings, along with its over-
|
|
|
|
|
|
rides in LocalFile and ForeignApiFile in favor of ::getUploader().
|
2021-06-02 06:49:01 +00:00
|
|
|
|
* SpecialBlock::checkUnblockSelf(), deprecated in 1.36, now emits deprecation
|
|
|
|
|
|
warnings.
|
2021-06-02 19:03:07 +00:00
|
|
|
|
* (T284179) The mediawiki.viewport ResourceLoader module is deprecated. You can
|
|
|
|
|
|
now just use MutationObserver or InterSectionObserver directly, which are
|
|
|
|
|
|
widely available in all supported JavaScript browsers.
|
2021-09-16 02:13:04 +00:00
|
|
|
|
* The following constructor options of DatabaseBlock class will now trigger
|
|
|
|
|
|
deprecation warnings:
|
|
|
|
|
|
- the 'byText' property with blocker's name,
|
|
|
|
|
|
- the 'by' property with blocker's ID,
|
|
|
|
|
|
For both of these, use the 'by' property with UserIdentity value instead.
|
2021-01-12 00:19:53 +00:00
|
|
|
|
* The BeforeResetNotificationTimestamp hook was deprecated.
|
2021-09-16 02:13:04 +00:00
|
|
|
|
* ArchivedFile::getUser() ::getRawUser() ::getRawUserText() were deprecated in
|
|
|
|
|
|
favor of ::getUploader.() ::getRawDescription() was deprecated in favor of
|
|
|
|
|
|
::getDescription() with RAW audience parameter.
|
2021-06-03 01:34:31 +00:00
|
|
|
|
* When calling LocalFile::newFromRow() or LocalFile::loadFromRow(), passing
|
2021-09-16 02:13:04 +00:00
|
|
|
|
extra fields not requested by ::getQueryInfo() will now trigger deprecation
|
|
|
|
|
|
warnings. This is to warn callers that deprefixing and automatic assignment of
|
|
|
|
|
|
such fields will not be done in a future version.
|
|
|
|
|
|
* JobSpecification::getTitle() was deprecated without providing a replacement.
|
|
|
|
|
|
It wasn't used and job given the purpose of JobSpecification class it is not
|
|
|
|
|
|
needed.
|
|
|
|
|
|
* The protected method File::getImageSize() is now deprecated.
|
2021-09-08 17:19:11 +00:00
|
|
|
|
* BacklinkCache::get() was deprecated, use
|
|
|
|
|
|
BacklinkCacheFactory::getBacklinkCache() instead.
|
2021-09-16 02:13:04 +00:00
|
|
|
|
* Title::getBacklinkCache() now emits deprecation warnings. Instead, use the
|
|
|
|
|
|
::getBacklinkCache() method in the BacklinkCacheFactory service.
|
|
|
|
|
|
* MediaHandler::getImageSize(), ::getMetadata(), and ::isMetadataValid() were
|
|
|
|
|
|
deprecated and should no longer be overridden. Instead, sub-classes should
|
Use the unserialized form of image metadata internally
Image metadata is usually a serialized string representing an array.
Passing the string around internally and having everything unserialize
it is an awkward convention.
Also, many image handlers were reading the file twice: once for
getMetadata() and again for getImageSize(). Often getMetadata()
would actually read the width and height and then throw it away.
So, in filerepo:
* Add File::getMetadataItem(), which promises to allow partial
loading of metadata per my proposal on T275268 in a future commit.
* Add File::getMetadataArray(), which returns the unserialized array.
Some file handlers were returning non-serializable strings from
getMetadata(), so I gave them a legacy array form ['_error' => ...]
* Changed MWFileProps to return the array form of metadata.
* Deprecate the weird File::getImageSize(). It was apparently not
called by anything, but was overridden by UnregisteredLocalFile.
* Wrap serialize/unserialize with File::getMetadataForDb() and
File::loadMetadataFromDb() in preparation for T275268.
In MediaHandler:
* Merged MediaHandler::getImageSize() and MediaHandler::getMetadata()
into getSizeAndMetadata(). Deprecated the old methods.
* Instead of isMetadataValid() we now have isFileMetadataValid(), which
only gets a File object, so it can decide what data it needs to load.
* Simplified getPageDimensions() by having it return false for non-paged
media. It was not called in that case, but was implemented anyway.
In specific handlers:
* Rename DjVuHandler::getUnserializedMetadata() and
extractTreesFromMetadata() for clarity. "Metadata" in these function
names meant an XML string.
* Updated DjVuImage::getImageSize() to provide image sizes in the new
style.
* In ExifBitmapHandler, getRotationForExif() now takes just the
Orientation tag, rather than a serialized string. Also renamed for
clarity.
* In GIFMetadataExtractor, return the width, height and bits per channel
instead of throwing them away. There was some conflation in
decodeBPP() which I picked apart. Refer to GIF89a section 18.
* In JpegMetadataExtractor, process the SOF0/SOF2 segment to extract
bits per channel, width, height and components (channel count). This
is essentially a port of PHP's getimagesize(), so should be bugwards
compatible.
* In PNGMetadataExtractor, return the width and height, which were
previously assigned to unused local variables. I verified the
implementation by referring to the specification.
* In SvgHandler, retain the version validation from unpackMetadata(),
but rename the function since it now takes an array as input.
In tests:
* In ExifBitmapTest, refactored some tests by using a provider.
* In GIFHandlerTest and PNGHandlerTest, I removed the tests in which
getMetadata() returns null, since it doesn't make sense when ported to
getMetadataArray(). I added tests for empty arrays instead.
* In tests, I retained serialization of input data since I figure it's
useful to confirm that existing database rows will continue to be read
correctly. I removed serialization of expected values, replacing them
with plain data.
* In tests, I replaced access to private class constants like
BROKEN_FILE with string literals, since stability is essential. If
the class constant changes, the test should fail.
Elsewhere:
* In maintenance/refreshImageMetadata.php, I removed the check for
shrinking image metadata, since it's not easy to implement and is
not future compatible. Image metadata is expected to shrink in
future.
Bug: T275268
Change-Id: I039785d5b6439d71dcc21dcb972177dba5c3a67d
2021-05-19 00:24:32 +00:00
|
|
|
|
override getSizeAndMetadata().
|
|
|
|
|
|
* Deprecated File::getMetadata(). Instead use ::getMetadataArray(),
|
|
|
|
|
|
::getMetadataItem() and ::getMetadataItems().
|
2021-09-16 02:13:04 +00:00
|
|
|
|
* Message::title() has been deprecated; use Message::page() instead.
|
|
|
|
|
|
* BaseTemplate::getAfterPortlet(), BaseTemplate::renderAfterPortlet(), and the
|
2021-06-10 16:49:08 +00:00
|
|
|
|
BaseTemplateAfterPortlet hook, which were deprecated in 1.35,
|
|
|
|
|
|
now emit deprecation warnings.
|
2021-09-16 02:13:04 +00:00
|
|
|
|
* The LocalFile::getHistory() hook is deprecated.
|
2021-06-28 23:12:34 +00:00
|
|
|
|
* Calling WikiPage::prepareContentForEdit() without a UserIdentity is now
|
|
|
|
|
|
deprecated.
|
2021-09-16 02:13:04 +00:00
|
|
|
|
* User::getEditTokenObject(), ::getEditToken(), and ::matchEditToken() were each
|
|
|
|
|
|
deprecated. Use CsrfTokenRepository, which is available via IContextSource,
|
|
|
|
|
|
instead. ::matchEditTokenNoSuffix() was deprecated without replacement.
|
2021-06-02 22:13:53 +00:00
|
|
|
|
It was introduced to be able to provide custom error message if the token
|
|
|
|
|
|
was submitted, but ending slashes were stripped by some ASCII mangling proxy.
|
2021-09-16 02:13:04 +00:00
|
|
|
|
Use ::matchToken() instead, such proxies are much less common now and there's
|
2021-06-09 16:09:48 +00:00
|
|
|
|
not much benefit in customising the error message.
|
2021-09-16 02:13:04 +00:00
|
|
|
|
* ContentHandler::getForTitle(), deprecated since 1.35, now emits deprecation
|
|
|
|
|
|
warnings.
|
2021-05-07 11:24:43 +00:00
|
|
|
|
* User::listOptionKinds(), deprecated since 1.35, now emits deprecation
|
|
|
|
|
|
warnings.
|
2021-06-28 23:06:24 +00:00
|
|
|
|
* WikiPage::doEditContent(), deprecated since 1.32, now emits deprecation
|
|
|
|
|
|
warnings.
|
2021-09-16 02:13:04 +00:00
|
|
|
|
* CentralIdLookup::factory() and ::factoryNonLocal() now emit deprecation
|
|
|
|
|
|
warnings; obtain an instance from MediaWikiServices instead.
|
2020-01-13 16:24:36 +00:00
|
|
|
|
* The class RandomPage was renamed to SpecialRandomPage. The class RandomPage
|
|
|
|
|
|
is now deprecated.
|
2021-07-15 04:17:10 +00:00
|
|
|
|
* BotPassword::invalidateAllPasswordsForCentralId() was deprecated.
|
|
|
|
|
|
* BotPassword::removeAllPasswordsForCentralId() was deprecated.
|
2021-07-08 15:53:11 +00:00
|
|
|
|
* The Title class members: $mTextform, $mUrlform, $mDbkeyform, $mNamespace,
|
|
|
|
|
|
$mInterwiki, and $mFragment have been deprecated to not be used directly.
|
|
|
|
|
|
Instead, their corresponding accessor methods should be used.
|
2021-07-15 00:46:59 +00:00
|
|
|
|
* IDatabase::fetchObject(), ::fetchRow(), ::numRows(), ::numFields(),
|
|
|
|
|
|
::fieldName(), ::freeResult() and ::dataSeek() are deprecated. Use the
|
|
|
|
|
|
corresponding methods in IResultWrapper instead.
|
|
|
|
|
|
* ResultWrapper::unwrap(), DatabaseMysqlBase::fieldType() and
|
2021-09-16 02:13:04 +00:00
|
|
|
|
DatabasePostgres::fieldType() each now emit deprecation warnings.
|
|
|
|
|
|
* Sub-classes implementing Database::doQuery() should return either boolean or
|
|
|
|
|
|
an IResultWrapper. To do otherwise will now trigger a deprecation warning.
|
2021-07-18 21:08:25 +00:00
|
|
|
|
* User::getOptionKinds() and ::resetOptions(), both deprecated since 1.35,
|
|
|
|
|
|
now emit deprecation warnings.
|
2021-07-23 17:18:49 +00:00
|
|
|
|
* The following methods in MWNamespace, all deprecated since 1.34, now emit
|
|
|
|
|
|
deprecation warnings:
|
2021-09-16 02:13:04 +00:00
|
|
|
|
- ::isMovable()
|
|
|
|
|
|
- ::isSubject()
|
|
|
|
|
|
- ::getTalk()
|
|
|
|
|
|
- ::getSubject()
|
|
|
|
|
|
- ::getAssociated()
|
|
|
|
|
|
- ::equals()
|
|
|
|
|
|
- ::subjectEquals()
|
|
|
|
|
|
- ::hasTalkNamespace()
|
|
|
|
|
|
- ::wantSignatures()
|
|
|
|
|
|
- ::isWatchable()
|
|
|
|
|
|
- ::getSubjectNamespaces()
|
|
|
|
|
|
- ::getTalkNamespaces()
|
|
|
|
|
|
- ::isCapitalized()
|
|
|
|
|
|
- ::hasGenderDistinction()
|
|
|
|
|
|
- ::isNonincludable()
|
|
|
|
|
|
- ::getNamespaceContentModel()
|
|
|
|
|
|
- ::getRestrictionLevels()
|
|
|
|
|
|
- ::getCategoryLinkType()
|
2021-07-23 17:18:49 +00:00
|
|
|
|
* LogFormatter::styleRestricedElement() has been deprecated in favor of
|
|
|
|
|
|
LogFormatter::styleRestrictedElement()
|
2021-09-16 02:13:04 +00:00
|
|
|
|
* The following hooks related to user preferences were deprecated:
|
2021-07-13 21:05:10 +00:00
|
|
|
|
- UserLoadOptions: use LoadUserOptions instead.
|
|
|
|
|
|
- UserSaveOptions: use SaveUserOptions instead.
|
|
|
|
|
|
- UserResetAllOptions: no replacement was provided, the hook is not used.
|
2021-09-16 02:13:04 +00:00
|
|
|
|
* Title::isNamespaceProtected(), deprecated in 1.34, now emits deprecation
|
|
|
|
|
|
warnings.
|
|
|
|
|
|
* UserSelectQueryBuilder::userIds(), ::userNames(), and ::userNamePrefix() has
|
|
|
|
|
|
been deprecated in favor of ::whereUserIds(), ::whereUserNames(), and
|
|
|
|
|
|
::whereUserNamePrefix().
|
|
|
|
|
|
* Manually constructing a MovePage object, deprecated in 1.34, now emits
|
|
|
|
|
|
deprecation warnings. Use MovePageFactory instead.
|
|
|
|
|
|
* The userCan hook now emits deprecation warnings. Use the
|
|
|
|
|
|
getUserPermissionsErrors or getUserPermissionsErrorsExpensive hooks instead.
|
|
|
|
|
|
* Parser::$mUser public access, and the methods ParserOptions::getUser() and
|
|
|
|
|
|
Parser::getUser() each now emit deprecation warnings.
|
2021-07-26 13:24:22 +00:00
|
|
|
|
* The following methods in the Title class have been deprecated in favor of the
|
|
|
|
|
|
corresponding methods in the new RestrictionStore service (with different
|
|
|
|
|
|
names where indicated):
|
2021-09-16 02:13:04 +00:00
|
|
|
|
- ::areCascadeProtectionSourcesLoaded()
|
|
|
|
|
|
- ::areRestrictionsCascading()
|
|
|
|
|
|
- ::areRestrictionsLoaded()
|
|
|
|
|
|
- ::getAllRestrictions()
|
|
|
|
|
|
- ::getCascadeProtectionSources()
|
|
|
|
|
|
- ::getFilteredRestrictionTypes()
|
|
|
|
|
|
-> ::listAllRestrictionTypes()
|
|
|
|
|
|
- ::getRestrictionExpiry()
|
|
|
|
|
|
- ::getRestrictionTypes()
|
|
|
|
|
|
-> ::listApplicableRestrictionTypes()
|
|
|
|
|
|
- ::getRestrictions()
|
|
|
|
|
|
- ::isCascadeProtected()
|
|
|
|
|
|
- ::isProtected()
|
|
|
|
|
|
- ::isSemiProtected()
|
|
|
|
|
|
- ::loadRestrictionsFromRows()
|
2021-07-26 13:24:22 +00:00
|
|
|
|
* The following Title methods have been deprecated with no direct public
|
|
|
|
|
|
replacement:
|
2021-09-16 02:13:04 +00:00
|
|
|
|
- ::deleteTitleProtection()
|
|
|
|
|
|
- ::getTitleProtection()
|
|
|
|
|
|
- ::flushRestrictions()
|
|
|
|
|
|
- ::loadRestrictions()
|
|
|
|
|
|
* User::isAllowUsertalk() now emits deprecation warnings. Use User::getBlock()
|
|
|
|
|
|
and AbstractBlock::isUsertalkEditAllowed() instead.
|
2021-03-17 13:30:37 +00:00
|
|
|
|
* Classes used by Preprocessor_DOM have been merged with classes used by
|
|
|
|
|
|
Preprocessor_Hash, as Preprocessor_DOM was removed in 1.35.
|
|
|
|
|
|
- PPDPart has been merged into PPDPart_Hash
|
|
|
|
|
|
- PPDStack has been merged into PPDStack_Hash
|
|
|
|
|
|
- PPDStackElement has been merged into PPDStackElement_Hash
|
2021-09-04 19:19:47 +00:00
|
|
|
|
* By default, the global variable $wgUser is now an instance of the new class
|
|
|
|
|
|
StubGlobalUser rather than User, and the first time it is used it will emit
|
|
|
|
|
|
deprecation warnings (the $wgUser variable was deprecated in 1.35). For
|
|
|
|
|
|
extensions that read from this variable, please use a relevant ContextSource
|
|
|
|
|
|
instead, falling back to RequestContext::getMain() if none is available.
|
2021-09-16 02:13:04 +00:00
|
|
|
|
* Collation::singleton() and ::factory() were deprecated; obtain an instance of
|
|
|
|
|
|
the CollationFactory from MediaWikiServices instead.
|
|
|
|
|
|
* Title::getDefaultNamespace() has been deprecated to be removed because there
|
|
|
|
|
|
are no known callers/consumers.
|
|
|
|
|
|
* With removal of the stub threshold feature, the following methods now emit
|
|
|
|
|
|
deprecation warnings:
|
|
|
|
|
|
- LinkRenderer::setStubThreshold() and ::getStubThreshold() - no replacement.
|
|
|
|
|
|
- LinkRendererFactory::createForUser() - calling ::create() is now sufficient
|
|
|
|
|
|
- ParserOptions::setStubThreshold() and ::getStubThreshold() - no replacement.
|
|
|
|
|
|
- User::getStubThreshold() - no replacement.
|
2021-08-23 12:11:22 +00:00
|
|
|
|
* The ArticleDelete and ArticleDeleteComplete hooks were deprecated. Use
|
|
|
|
|
|
PageDelete and PageDeleteComplete instead.
|
2021-09-14 00:58:22 +00:00
|
|
|
|
* The following LESS mediawiki.mixins have been deprecated:
|
|
|
|
|
|
- .box-sizing()
|
|
|
|
|
|
- .transform()
|
|
|
|
|
|
- .transform-origin()
|
|
|
|
|
|
- .transition()
|
|
|
|
|
|
- .transition-transform()
|
2021-04-06 20:49:22 +00:00
|
|
|
|
|
|
|
|
|
|
=== Other changes in 1.37 ===
|
2021-09-16 02:13:04 +00:00
|
|
|
|
* WatchlistManager::addWatch() and WatchlistManager::addWatchIgnoringRights(),
|
2021-04-19 17:35:35 +00:00
|
|
|
|
which replace User::addWatch(), now call the WatchArticle and
|
|
|
|
|
|
WatchArticleComplete hooks.
|
2021-09-16 02:13:04 +00:00
|
|
|
|
* WatchlistManager::removeWatch() and
|
2021-04-19 17:35:35 +00:00
|
|
|
|
WatchlistManager::removeWatchIgnoringRights(), which replace
|
|
|
|
|
|
User::removeWatch(), now call the UnwatchArticle and UnwatchArticleComplete
|
|
|
|
|
|
hooks.
|
2021-04-16 13:17:10 +00:00
|
|
|
|
* The overridable postInitSetup() method was added to the
|
|
|
|
|
|
AbstractAuthenticationProvider class. A provider can override postInitSetup()
|
|
|
|
|
|
to do any custom post-initialization configuration.
|
2021-04-29 20:44:45 +00:00
|
|
|
|
* The overridable postInitSetup() method was added to the SessionProvider
|
|
|
|
|
|
class. A provider can override postInitSetup() to do any custom
|
|
|
|
|
|
post-initialization configuration.
|
|
|
|
|
|
* The protected getConfig() method was added to the SessionProvider class.
|
2021-09-16 02:13:04 +00:00
|
|
|
|
Use SessionProvider::getConfig() to get a config.
|
2021-04-30 09:10:48 +00:00
|
|
|
|
* The DBAccessBase class is deprecated. Classes that used to extend it
|
|
|
|
|
|
should get a load balancer (factory) injected in the constructor instead.
|
2021-09-16 02:13:04 +00:00
|
|
|
|
* ActorNormalization::acquireActorId() now requires IDatabase parameter.
|
2021-05-25 14:28:19 +00:00
|
|
|
|
Not providing one emitted deprecation warnings since 1.36.
|
2021-05-30 12:47:20 +00:00
|
|
|
|
* Anti-lock constants ALF_PRELOAD_LINK, ALF_NO_BLOCK_LOCK, ALF_NO_LINK_LOCK
|
|
|
|
|
|
and ALF_PRELOAD_EXISTENCE have been removed. They're unused since 1.25.
|
2021-09-16 02:13:04 +00:00
|
|
|
|
* (T278036) CSS class 'mw-htmlform-field-autoinfuse' used by some forms has been
|
|
|
|
|
|
renamed to 'mw-htmlform-autoinfuse'.
|
|
|
|
|
|
* User::newFromRow() does not accept pre-loaded user preferences under
|
Improvements to user preferences fetching/saving
== Status quo ==
When saving user preferences, we want to lock the rows to avoid
accidentally overriding a concurrent options update. So usually
what extensions do is:
$value = $mngr->getOption( 'option', ..., READ_LOCKING );
if ( $value !== 'new_value' ) {
$mngr->setOption( 'option', 'new_value' );
$mngr->saveOptions()
}
Previously for extra caution we've ignored all caches in options
manager if >= READ_LOCKING flags were passed. This resulted in
re-reading all the options multiple times. At worst, 3 times:
1. If READ_NORMAL read was made for update - that's once,
2. On setOption, one more read, forcefully from primary
3. On saveOptions, one more read from primary, non-locking,
to figure out which option keys need to be deleted.
Also, READ_LOCKING was not used where it clearly had to be used,
for example right before the update. This was trying to fix any
kind of error on part of the manager clients, unsuccessfully so.
== New approach ==
1. Cache modified user options separately from originals and merge
them on demand. This means when refetching originals with LOCKING
we don't wipe out all modifications made to the cache with setOption.
Extra bonus - we no longer need to load all options to set an option.
2. Split the originals cache into 2 layers - one for stuff that
comes from DB directly, and one with applied normalizations and
whatever hooks modify. This let's us avoid refetching DB options
after we save them, but still let's the hooks execute on newly set
options after they're saved.
3. Cache options with all query flags. This is a bit controversial, but
ideally LOCKING flags will be applied on options fetch right before
they are saved. We have to re-read options with LOCKING in saveOptions
to avoid races, but if the caller did 'getOption( ..., LOCKING),
setOption(), save()' we will not need to re-select with LOCKING again.
Bug: T280220
Change-Id: Ibed2789f5260b725fd806b4470631aa30d814ce6
2021-06-11 18:48:19 +00:00
|
|
|
|
$data['user_properties'] anymore. This optimization was not used.
|
2021-09-04 07:28:08 +00:00
|
|
|
|
* The following files change the letter case of the file names:
|
|
|
|
|
|
- SpecialRandompage.php -> SpecialRandomPage.php
|
|
|
|
|
|
- SpecialRandomredirect.php -> SpecialRandomRedirect.php
|
|
|
|
|
|
- SpecialRandomrootpage.php -> SpecialRandomRootPage.php
|
2021-09-16 02:13:04 +00:00
|
|
|
|
* Media files which are uploaded server side using the importImages.php
|
|
|
|
|
|
maintenance script will now have the "mw-server-side-upload" change tag.
|
|
|
|
|
|
* (T284917) The stub threshold feature has been removed.
|
|
|
|
|
|
* Skin::getPoweredBy() and Skin::getCopyrightIcon() have been deprecated as they
|
|
|
|
|
|
are only designed for use by skins extended BaseTemplate. You can move calls
|
|
|
|
|
|
to instead use BaseTemplate::getPoweredByHTML() and ::getCopyrightIconHTML()
|
2021-09-15 21:21:51 +00:00
|
|
|
|
respectively.
|
|
|
|
|
|
* The SkinGetPoweredBy hook is deprecated. No replacement is provided.
|
2021-09-14 10:49:37 +00:00
|
|
|
|
* HTMLTitleTextField didn't support interwiki titles well previously.
|
|
|
|
|
|
Starting with 1.37, HTMLTitleTextField has a new parameter, 'interwiki',
|
|
|
|
|
|
which can be used to control acceptance of interwiki titles. To provide
|
|
|
|
|
|
a transitional period, the default value ('interwiki' => null) ensures
|
|
|
|
|
|
MW will have the same behavior as before (logging a deprecation warning).
|
|
|
|
|
|
In 1.38, the default behavior will change to "interwiki links aren't allowed".
|
2021-04-06 20:49:22 +00:00
|
|
|
|
|
|
|
|
|
|
== Compatibility ==
|
|
|
|
|
|
|
|
|
|
|
|
MediaWiki 1.37 requires PHP 7.3.19 or later and the following PHP extensions:
|
|
|
|
|
|
|
|
|
|
|
|
* ctype
|
|
|
|
|
|
* dom
|
|
|
|
|
|
* fileinfo
|
|
|
|
|
|
* iconv
|
|
|
|
|
|
* intl
|
|
|
|
|
|
* json
|
|
|
|
|
|
* mbstring
|
|
|
|
|
|
* xml
|
|
|
|
|
|
|
|
|
|
|
|
MySQL/MariaDB is the recommended DBMS. PostgreSQL or SQLite can also be used,
|
|
|
|
|
|
but support for them is somewhat less mature.
|
|
|
|
|
|
|
|
|
|
|
|
The supported versions are:
|
|
|
|
|
|
|
|
|
|
|
|
* MySQL 5.5.8 or later
|
|
|
|
|
|
* PostgreSQL 9.4 or later
|
|
|
|
|
|
* SQLite 3.8.0 or later
|
|
|
|
|
|
|
|
|
|
|
|
== Online documentation ==
|
|
|
|
|
|
Documentation for both end-users and site administrators is available on
|
|
|
|
|
|
MediaWiki.org, and is covered under the GNU Free Documentation License (except
|
|
|
|
|
|
for pages that explicitly state that their contents are in the public domain):
|
|
|
|
|
|
|
|
|
|
|
|
https://www.mediawiki.org/wiki/Special:MyLanguage/Documentation
|
|
|
|
|
|
|
|
|
|
|
|
== Mailing list ==
|
|
|
|
|
|
A mailing list is available for MediaWiki user support and discussion:
|
|
|
|
|
|
|
|
|
|
|
|
https://lists.wikimedia.org/mailman/listinfo/mediawiki-l
|
|
|
|
|
|
|
|
|
|
|
|
A low-traffic announcements-only list is also available:
|
|
|
|
|
|
|
|
|
|
|
|
https://lists.wikimedia.org/mailman/listinfo/mediawiki-announce
|
|
|
|
|
|
|
|
|
|
|
|
It's highly recommended that you sign up for one of these lists if you're
|
|
|
|
|
|
going to run a public MediaWiki, so you can be notified of security fixes.
|
|
|
|
|
|
|
|
|
|
|
|
== IRC help ==
|
2021-05-20 20:57:48 +00:00
|
|
|
|
There's usually someone online in #mediawiki on irc.libera.chat.
|
