15fac8e487
Also, let's keep the PHP version in the documentation correct for the branch release, not what the actual code says for master. This is much less confusing and needs fewer fixes when making back-port changes. Change-Id: I162f14ffaeeebab197a8fa48f6edde28df23eb9c
95 lines
3.5 KiB
Text
95 lines
3.5 KiB
Text
---
|
|
Installing MediaWiki
|
|
---
|
|
|
|
Starting with MediaWiki 1.2.0, it's possible to install and configure the wiki
|
|
"in-place", as long as you have the necessary prerequisites available.
|
|
|
|
Required software as of MediaWiki 1.36.0:
|
|
|
|
* Web server with PHP 7.3.19 or higher, plus the following extensions:
|
|
** ctype
|
|
** dom
|
|
** fileinfo
|
|
** iconv
|
|
** intl
|
|
** json
|
|
** libxml
|
|
** mbstring
|
|
** xml
|
|
** xmlreader
|
|
* A SQL server, the following types are supported
|
|
** MySQL 5.5.8 or higher
|
|
** PostgreSQL 9.4 or higher
|
|
** SQLite 3.8.0 or higher
|
|
|
|
MediaWiki is developed and tested mainly on Unix/Linux platforms, but should
|
|
work on Windows as well.
|
|
|
|
Support for specialised content requires installing the relevant extension. For
|
|
formulæ, see https://www.mediawiki.org/wiki/Special:MyLanguage/Extension:Math
|
|
|
|
Don't forget to check the RELEASE-NOTES file...
|
|
|
|
|
|
Additional documentation is available online, which may include more detailed
|
|
notes on particular operating systems and workarounds for difficult hosting
|
|
environments:
|
|
|
|
https://www.mediawiki.org/wiki/Special:MyLanguage/Manual:Installation_guide
|
|
|
|
|
|
******************* WARNING *******************
|
|
|
|
REMEMBER: ALWAYS BACK UP YOUR DATABASE BEFORE
|
|
ATTEMPTING TO INSTALL OR UPGRADE!!!
|
|
|
|
******************* WARNING *******************
|
|
|
|
----
|
|
In-place web install
|
|
----
|
|
|
|
Decompress the MediaWiki installation archive either on your server, or on your
|
|
local machine and upload the directory tree. Rename it from "mediawiki-1.x.x" to
|
|
something nice, like "wiki", since it will be appearing in your URL,
|
|
ie. /wiki/index.php/Article.
|
|
|
|
+--------------------------------------------------------------------------+
|
|
| Note: If you plan to use a fancy URL-rewriting scheme to prettify your |
|
|
| URLs, such as http://www.example.com/wiki/Article, you should put the |
|
|
| files in a *different* directory from the virtual path where page names |
|
|
| will appear. It is common in this case to use w as the folder name and |
|
|
| /wiki/ as the virtual article path where your articles pretend to be. |
|
|
| |
|
|
| See: https://www.mediawiki.org/wiki/Special:MyLanguage/Manual:Short_URL |
|
|
+--------------------------------------------------------------------------+
|
|
|
|
Hop into your browser and surf into the wiki directory. It'll direct you into
|
|
the config script. Fill out the form... remember you're probably not on an
|
|
encrypted connection.
|
|
Gaaah! :)
|
|
|
|
If all goes well, you should soon be told that it's set up your wiki database
|
|
and generated a configuration file. There is now a copy of "LocalSettings.php"
|
|
available to download from the installer. Download this now, there is not a
|
|
way (yet) to get it after you exit the installer. Place it in the main wiki
|
|
directory, and the wiki should now be working.
|
|
|
|
Once the wiki is set up, you should remove the mw-config directory (though it
|
|
will refuse to config again if the wiki is set up).
|
|
|
|
----
|
|
|
|
Don't forget that this is free software under development! Chances are good
|
|
there's a crucial step that hasn't made it into the documentation. You should
|
|
probably sign up for the MediaWiki developers' mailing list; you can ask for
|
|
help (please provide enough information to work with, and preferably be aware of
|
|
what you're doing!) and keep track of major changes to the software, including
|
|
performance improvements and security patches.
|
|
|
|
https://lists.wikimedia.org/mailman/listinfo/mediawiki-announce (low traffic)
|
|
|
|
https://lists.wikimedia.org/mailman/listinfo/mediawiki-l (site admin support)
|
|
|
|
https://lists.wikimedia.org/mailman/listinfo/wikitech-l (development)
|