Compatibility

From MediaWiki.org
Jump to: navigation, search

Other languages:
English • ‎British English • ‎español • ‎français • ‎日本語 • ‎polski • ‎português do Brasil • ‎русский • ‎中文

MediaWiki strives to maintain broad compatibility between versions, and with a range of current and legacy software. At the same time, the constantly-evolving codebase and features of the latest MediaWiki development mean that it is not possible to maintain compatibility with legacy software indefinitely.

Browsers[edit | edit source]

This describes our practices around browser support.

Grade C[edit | edit source]

The base level support provides the core functionality of the MediaWiki platform. Our HTTP responses are compatible with these browsers (e.g. HTTP features we rely on, character encoding, and image formats used in the content; must work in these browsers). In the front-end this means content is presented in a readable manner, and to some extent user actions can be performed.

Browsers in this category are known and identified via a blacklist in the startup module.

The software provides these browsers a javascriptless environment. The environment may lack certain visual features and extra functionally. The core functionality for these browsers must be maintained via traditional client-server interaction with full GET/POST page loads. Problems users perceive in these browsers are addressed with high priority. Issue handling focusses mainly on ensuring provided functionality is not broken; if acceptable from a product perspective, this may result in the functionality (whether or not temporarily) no longer being provided for these browsers.

Grade A[edit | edit source]

This level represents the highest level of support. It takes advantage of capabilities in modern browsers, while allowing a graceful fallback for older browsers. All features provided by the software (whether or not in a degraded form) must work in these browsers.

Browsers in this category are known and actively tested against. Problems users perceive in these browsers are addressed with high priority.

Grade X[edit | edit source]

This level represents all other browsers. This includes browsers that are no longer developed or browsers not popular enough to justify the added maintenance overhead.

Browsers not included in any other grade belong to this category.

Treatment[edit | edit source]

The software treats these browsers the same as Grade A browsers and are thus assumed to be capable. This principle provides various important benefits:

  • Newly released versions of Grade A browsers may unexpectedly be considered Grade X if they are not yet tested against.
  • Users of upcoming browsers are given a chance to have a Grade A experience.
  • Users of less popular browsers based on or derived from browsers with the same capabilities are not negatively impacted (e.g. Iceweasel).

In practice the only difference between Grade X and Grade A browsers is that we don't actively test against Grade X browsers. And problems users perceive in these browsers only are not prioritised.

Browser support matrix[edit | edit source]

While the principles and different grades described above apply to MediaWiki core and extensions alike, the below browser support matrix applies to MediaWiki core only (and extensions that decide to follow it). Individual extensions may have their own support matrix distributing browsers among the different levels of support differently.

 Browsers: Chrome Internet Explorer Firefox Safari Opera iOS Android
Grade A Current and previous 7+[1] Current and previous 5.1+ 12.1+ 6.1+ 2.3,
4.0+
Grade C All versions 5+ 2.0+ 3.0+ 10.0+
A few mobile browsers are included here. However as noted earlier, this matrix is for MediaWiki core and its desktop skin. Mobile-specific skins and/or extensions especially for mobile devices may have a different support matrix.



Software required to run MediaWiki[edit | edit source]

PHP[edit | edit source]

1.2 1.3 1.4 1.5 1.6 1.7 1.8 1.9 1.10 1.11 1.12 1.13 1.14 1.15 1.16 1.17 1.18 1.19 1.20 1.21 1.22 1.23 master
  5.4.x
  5.3.2+
  5.2.3+  
  5.1.x  
  5.0.x  
4.x  
1.2 1.3 1.4 1.5 1.6 1.7 1.8 1.9 1.10 1.11 1.12 1.13 1.14 1.15 1.16 1.17 1.18 1.19 1.20 1.21 1.22 1.23 master

The latest version of MediaWiki runs on any version of PHP 5.3.2 to PHP 5.5. At this time, HHVM has unresolved issues and might cause some functions to break.

The latest versions of MediaWiki contain features which are not supported by PHP 5.0, 5.1 and 5.2; attempts to run with these versions will fail.

Database[edit | edit source]

1.2 1.3 1.4 1.5 1.6 1.7 1.8 1.9 1.10 1.11 1.12 1.13 1.14 1.15 1.16 1.17 1.18 1.19 1.20 1.21 1.22 1.23 master
MySQL 5
MySQL 4  
MySQL 3  
  SQLite 3+
  PostgreSQL 8.3+
  PostgreSQL 8.1  
1.2 1.3 1.4 1.5 1.6 1.7 1.8 1.9 1.10 1.11 1.12 1.13 1.14 1.15 1.16 1.17 1.18 1.19 1.20 1.21 1.22 1.23 master

MediaWiki is compatible with a variety of database servers, although support is strongest for MySQL. (MariaDB can also be used.)

Support for any other database software ranges from dubious to stable; architectures for which classes exist have at least some support. Anything other than MySQL or MariaDB is not recommended for production use at this point.


Web server[edit | edit source]

MediaWiki is broadly compatible with all major web servers that can invoke PHP. Apache is the most used and tested. So long as the webserver version supports the required PHP version based on the matrix outlined here.

Notes[edit | edit source]

  • Software marked in green is supported while software marked in red is not supported.
  1. As of MediaWiki 1.24, JavaScript support for Microsoft Internet Explorer 6 has been deprecated. The browser has been considered outdated and unsupported and contains several unpatched security vulnerabilities. Use of the browser is strongly discouraged by Microsoft.[1] [2] [3]

See also[edit | edit source]