/
RELEASE-NOTES-1.43
310 lines (249 loc) · 11.9 KB
/
RELEASE-NOTES-1.43
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
= MediaWiki 1.43 =
== MediaWiki 1.43.0-PRERELEASE ==
THIS IS NOT A RELEASE YET
MediaWiki 1.43 is an alpha-quality development branch, and is not recommended
for use in production.
== Upgrading notes for 1.43 ==
Don't forget to always back up your database before upgrading!
See the file UPGRADE for more detailed per-version upgrade instructions from the
oldest supported upgrading version, MediaWiki 1.35.
Some specific notes for MediaWiki 1.43 upgrades are below:
* It is now necessary that the OpenSSL PHP extension is installed.
* …
For notes on 1.42.x and older releases, see HISTORY.
=== Configuration changes for system administrators in 1.43 ===
* …
==== New configuration ====
* (T13555) $wgParserEnableLegacyHeadingDOM - Defaults to `true`, can be set to
`false` to enable new, more accessible HTML markup for wikitext headings.
Note that each skin must also use the 'supportsMwHeading' option to allow it.
More information: https://www.mediawiki.org/wiki/Heading_HTML_changes
In a future release the new markup will become the default,
and later this option will be removed.
* …
==== Changed configuration ====
* wgPageLinksSchemaMigrationStage – (T299947) This temporary setting, which
controls the database schema migration for the page links table, is now set
by default to write to both old and new data and read from the new data.
* …
==== Removed configuration ====
* wgSessionInsecureSecrets has been removed since OpenSSL is now a required
PHP extension.
* …
=== New user-facing features in 1.43 ===
* …
=== New features for sysadmins in 1.43 ===
* …
=== New developer features in 1.43 ===
* StatusValue class gained new method getMessages(): MessageSpecifier[],
allowing the errors to be inspected and displayed more easily, for example:
foreach ( $status->getMessages() as $msg ) {
if ( $msg->getKey() !== 'ignored-message' ) {
$this->getOutput()->addWikiMsg( $msg );
}
}
* (T13555) Skins can enable the 'supportsMwHeading' option for new, more
accessible HTML markup for wikitext headings. MediaWiki's own styles and
scripts have been updated to support it, but your skin may also need updates.
More information: https://www.mediawiki.org/wiki/Heading_HTML_changes
A future release will emit deprecation warnings for skins with
'supportsMwHeading' set to false.
* (T219397) New `Language::formatDurationBetweenTimestamps()` function added
which takes two timestamps and a precision in order to calculate a more
accurate text representation of duration.
* …
=== External library changes in 1.43 ===
* The OOjs Router library has been merged into core and will be archived
upstream.
==== New external libraries ====
* …
===== New development-only external libraries =====
* …
==== Changed external libraries ====
* Updated codex, codex-design-tokens and codex-icons
from v1.3.6 to v1.5.0.
* Updated guzzlehttp/guzzle from 7.7.1 to 7.8.1.
* Updated pear/net_smtp from 1.11.1 to 1.12.1.
* Updated monolog/monolog from 2.9.2 to 2.9.3.
* Updated symfony/yaml from 5.4.35 to 5.4.39.
* …
===== Changed development-only external libraries =====
* Upgraded eslint-config-wikimedia from 0.26.0 to 0.27.0.
* Updated seld/jsonlint from 1.10.1 to 1.10.2.
* Updated doctrine/dbal from 3.7.2 to 3.8.4.
* Updated phpunit/phpunit from 9.6.16 to 9.6.19.
* …
==== Removed external libraries ====
* …
=== Bug fixes in 1.43 ===
* …
=== Action API changes in 1.43 ===
* APIQueryUserInfo now returns null in the field registrationdate for users
created before December 2005 (their registration date was not recorded).
* …
=== Action API internal changes in 1.43 ===
* …
=== Languages updated in 1.43 ===
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.
* (T290657) Added language support for Levantine Arabic (apc).
* (T364291) Added language support for Musi, also known as Palembang (mui).
* …
=== Breaking changes in 1.43 ===
* ErrorPageError public properties 'msg' and 'title' may now contain
any MessageSpecifier object, not just Message.
* Reset button functionality suppressReset() and $mShowReset from HTMLForm
was removed without replacement.
* UserGroupMembership::getGroupName(), deprecated in 1.38, and
UserGroupMembership::getGroupMemberName(), deprecated in 1.40, have
been removed.
* SerializedValueContainer::isUnified(), deprecated in 1.42, has been
removed.
* Parser::getFreshParser(), deprecated in 1.39, has been removed.
* ConfigFactory::getDefaultInstance(), deprecated since 1.27, has been
removed.
* IReadableDatabase::getReplicaPos() has been removed without deprecation
as it's not used anywhere.
* ILoadBalancer::laggedReplicaUsed() has been moved to ILoadBalancerForOwner::
effectively making it internal.
* Overriding MWException::getHTML(), ::getText(), ::getPageTitle(), and
::reportHTML() in order to display custom exception messages is no
longer supported.
* TablePager::getBody(), final and deprecated since 1.24, has been removed.
Use ::getBodyOutput() or ::getFullOutput() instead.
* ImportableUploadRevisionImporter::downloadSource(), deprecated in 1.31, is now
private. Its only known external caller was removed in 1.40.
* The following methods in the User class have been removed:
* Deprecated in 1.33:
* User::isBlockedFrom()
* Deprecated in 1.34:
* User::isBlocked()
* Deprecated in 1.35:
* User::addGroup()
* User::getAllGroups()
* User::getGroups()
* User::getGroupMemberships()
* User::getImplicitGroups()
* User::getOption()
* User::removeGroup()
* Deprecated in 1.37:
* User::isBlockedFromCreateAccount()
* BotPassword::invalidateAllPasswordsForCentralId() and
BotPassword::removeAllPasswordsForCentralId(), deprecated in 1.37,
have been removed.
* Title::getBrokenLinksFrom(), deprecated in 1.42, has been removed.
* The $type parameter to Skin::getCopyright(), deprecated in 1.40, has been
removed.
* Skin::footerLink(), deprecated in 1.40, has been removed.
* Skin::getAction(), deprecated in 1.39, has been removed.
* Title::getCdnUrls() and Title::purgeSquid(), deprecated in 1.35, have been
removed.
* Constructing MWHttpRequest objects now requires timeout and connectTimeout to
be set; this was deprecated in 1.35.
* DatabaseBlock::purgeExpired, deprecated since 1.38, has been removed.
* AbstractBlock::getPermissionsError, deprecated since 1.35, has been removed.
* WikiPage::doDeleteArticleBatched, hard deprecated since 1.37, has been
removed.
* SpecialEmailUser::submit, deprecated since 1.41, has been removed.
* SpecialEmailUser::validateTarget, deprecated since 1.41, has been removed.
* SpecialEmailUser::getPermissionsError, deprecated since 1.41 has been
removed.
* SpecialBlock::getTargetAndType, deprecated since 1.36, has been removed.
* …
=== Deprecations in 1.43 ===
* The methods StatusValue::getErrors() and StatusValue::getErrorsByType(),
as well as Status::getErrorsArray() and Status::getWarningsArray(), have
been deprecated in favor of new method StatusValue::getMessages().
* SearchEngineConfig::getConfig() has been deprecated, use DI with
ServiceOptions to inject the required options.
* Using the "post" source in parameter declarations returned from
Handler::getParamSettings() is deprecated, use "body" instead.
* IMaintainableDatabase::textFieldSize() is now deprecated.
* ISQLPlatform::tableNamesN() is now deprecated.
* The implementation in SQLPlatform of ISQLPlatform::tableNames(), deprecated in
MediaWiki 1.39, now emits deprecation warnings.
* The following methods, previously deprecated, now emit deprecation warnings:
- ContentHandler::getDefaultModelFor(), deprecated since 1.33
- ContentHandler::getAllContentFormats(), deprecated since 1.35
- ContentHandler::getContentModels(), deprecated since 1.35
- ContentHandler::getForContent(), deprecated since 1.35
- ContentHandler::getForModelID(), deprecated since 1.35
- ContentHandler::getContentText(), deprecated since 1.37
* OutputPage::showFatalError() is deprecated, use showErrorPage() instead.
* LoadBalancer::getConnectionRef(), deprecated since 1.39, now emits deprecation
warnings. Use ::getConnection() instead.
* DBAccessObjectUtils::getDBOptions() is deprecated, use
SelectQueryBuilder::recency() instead.
* IDatabase::lockForUpdate is deprecated, use
SelectQueryBuilder::acquireRowLocks instead.
* wfGetUrlUtils() is deprecated; instead, get a UrlUtils from services.
* DerivedPageDataUpdater::getPreparedEdit(), provided for back-compatibility, is
now deprecated; use the getters directly, instead.
* AuthManager::forcePrimaryAuthenticationProviders(), provided for back-
compatibility, is now deprecated.
* WikiPage::hasDifferencesOutsideMainSlot(), provided as a stop-gap before
refactoring to support MCR, is now deprecated.
* ChangesList::getTimestamp() has been deprecated; use ::revDateLink() instead.
* SiteConfig::variants() has been deprecated; use ::variantsFor().
* ObjectCache::$instances and ::getInstance() have been deprecated; instead, use
ObjectCacheFactory::getInstance().
* ApiTestCase::setExpectedApiException() has been deprecated; instead, use
::expectApiErrorCode() to test error codes instead of messages.
* User::isBlockedGlobally(), deprecated since 1.40, now emits deprecation
warnings.
* User::isBlockedFromEmailuser() and User::canSendEmail(), deprecated since
1.41, now emit deprecation warnings.
* StatusValue will emit deprecation warnings when an error is given as
a MessageSpecifier combined with a parameters array, which is usually
a mistake, as the parameters have always been ignored.
* In StatusValue::replaceMessage(), ::hasMessage() and ::hasMessagesExcept()
passing MessageSpecifier or MessageValue as $source has been deprecated.
* …
=== Other changes in 1.43 ===
* Class aliases to support the old PHPUnit 4 style un-namespaced `PHPUnit_`
classes (such as PHPUnit_Framework_Error) have been removed.
* [Temporary accounts] If $wgAutoCreateTempUser is enabled, then MediaWiki
will create a temporary account and log the user in for unsuccessful edit
attempts and null edits, in addition to edits that change content. This is
a change from the previous paradigm, where temporary accounts were created
only for successful edits. This change is done to support better logging
support and moderation, to ensure that hooks run in a pre-save context have
a user object to associate log entries and other actions with.
* Several entries have been removed from the default list of interwikis used
when installing new wikis. This does not affect existing wikis.
* User auto-creations are now performed as the target user instead of
anonymous IP user.
* …
== Compatibility ==
MediaWiki 1.43 requires PHP 8.1.0 or later and the following PHP extensions:
* ctype
* dom
* fileinfo
* iconv
* intl
* json
* mbstring
* openssl
* xml
MariaDB is the recommended database software. MySQL, PostgreSQL, or SQLite can
be used instead, but support for them is somewhat less mature.
The supported versions are:
* MariaDB 10.3 or higher
* MySQL 5.7.0 or higher
* PostgreSQL 10 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/postorius/lists/mediawiki-l.lists.wikimedia.org/>
A low-traffic announcements-only list is also available:
<https://lists.wikimedia.org/postorius/lists/mediawiki-announce.lists.wikimedia.org/>
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 ==
There's usually someone online in #mediawiki on irc.libera.chat.