Debian 软件包

This page is a translated version of the page Debian packages and the translation is 50% complete.

一群来自 MediaWiki 与 Debian 社区的开发者负责维护 Debian 和 Ubuntu 上的 MediaWiki 软件包。这些软件包遵循 LTS 生命周期，并会随维护版和安全更新而保持最新。对于想要快速搭建标准 MediaWiki 安装且无需担心维护的人来说，这些软件包是理想的选择。它们既遵循发行版的规范，也符合 MediaWiki 的最佳实践。 In addition, we are also maintaining and updating other MediaWiki related packages like wikidiff2 and luasandbox.

Supported operating systems

MediaWiki 1.43

Debian 13 Trixie (details)
Ubuntu 26.04 Resolute (details)

MediaWiki 1.39

Debian 12 Bookworm (details)
Debian 11 Bullseye backports (details)
Ubuntu 24.04 Noble (details)

MediaWiki 1.35

Debian 11 Bullseye (details)
Ubuntu 22.04 Jammy (details)
Ubuntu 20.04 Focal via a PPA (details)

The package is also available in modern Ubuntu releases, starting with Yakkety Yak. These are supported for as long as the release is, and whatever Ubuntu themselves provides. For the best experience on Ubuntu, you should use the PPA instead of the official archives.

Installation

$ sudo apt-get install mediawiki

Easy right? This will install MediaWiki, PHP, a webserver (if necessary), and maybe a database server.

If you don't have a webserver installed, Apache will be installed, and automatically configure the wiki to be served at http://localhost/mediawiki/.

Note, the default Apache configuration uses mod_php. Ubuntu users will need to manually install it via the libapache2-mod-php package.

MediaWiki supports different database engines, in order of preference they are: MariaDB, MySQL, SQLite, and PostgreSQL. The package is compatible with any of them, but will recommend you install the default-mysql-server (MariaDB).

If you are going to enable short urls, the rewrite module of apache needs to be enabled. This can be done with

$ sudo a2enmod rewrite
$ sudo systemctl restart apache2

You should then follow the steps in the web installer to set up MediaWiki. See the installation guide for more details.

Extra extensions and skins

The following extra extensions and skins are packaged and can be installed separately:

Extension:CodeMirror, mediawiki-extension-codemirror
Extension:YouTube, mediawiki-extension-youtube
Skin:GreyStuff, mediawiki-skin-greystuff

You can install all of them at once with:

$ sudo apt install mediawiki-extension-* mediawiki-skin-*

Upgrading

When the package is upgraded, it will not automatically run update.php. It only updates the changed files in the package, which is usually enough for security releases. For major version upgrades, you should read through the upgrade guide.

Support

If you need help with MediaWiki, please see the support desk. You should also mention that you are using the Debian/Ubuntu package, and the version of the package that is installed.

If you have found a bug in MediaWiki that is not specific to the packaged version, please report a bug against the relevant MediaWiki component.

If you believe you have found a bug specific to the package or in the packaging itself, please file a bug in the MediaWiki-Debian Phabricator project. Bugs experienced on Debian may also be reported in the Debian bug tracker.

If you have other questions/concerns/suggestions, feel free to file a bug, leave a note on the talk page, or find us on #mediawiki on IRC.

Filesystem

Typically, MediaWiki, extensions, and configuration are all located in one folder. However, we try and follow the Filesystem Hierarchy Standard (FHS), and as a result, it is split into 3 main locations:

/usr/share/mediawiki - MediaWiki core files
/etc/mediawiki/LocalSettings.php - expected location of LocalSettings.php. You can also put other configuration files in this directory.
/var/lib/mediawiki - Main directory that the webserver will read from. Most core files from /usr/share/mediawiki are symlinked into this directory, and the LocalSettings.php file as well.

Some additional paths that you may want to be aware of:

/var/lib/mediawiki/extensions - Extensions are read from this directory. Non-packaged extensions can be installed here as well.
/var/log/mediawiki - Errors, exceptions and fatals are logged by default to this directory. MW 1.35+
/var/cache/mediawiki - Set as $wgCacheDirectory . MW 1.35+
/etc/mediawiki-extensions - Legacy system to enable/disable extensions and should not be used. No longer supported. MW 1.??-1.31

Development

Interested in helping out?

Thanks

A lot of different people have helped make this project a reality. In roughly chronological order:

Kunal Mehta (lead)
Luke Faraone
Faidon Liambotis
Moritz Mühlenhoff
Max Semenik
Chad Horohoe
Antoine Musso
Isarra
Taavi
A few users who tried out the package while it was still unstable and provided feedback over email
...you? More contributors are always welcome :)