Kézikönyv:Telepítési követelmények

A MediaWiki szoftver megléte mellett a MediaWikihez az alábbiak szükségesek:

• A lapok böngészőben való megjelenítéséhez szükséges egy webszerverszoftver.
• A szoftver futtatásához PHP szükséges.
• A lapok és adatok tárolásához egy adatbázisszerverre van szükség.

A fentieken kívül egyes haladó funkcióknak további függőségei lehetnek (lásd alább).

Ha nem rendelkezel teljes hozzáféréssel a webszerverhez, a szükséges csomagok meglétének ellenőrzéséhez vedd fel a kapcsolatot a rendszergazdával vagy a tárhelyszolgáltatóval.

A MediaWiki karbantartó szkriptek futtatásához parancssori hozzáférésre van szükséged.

Egyletöltéses telepítés

Linux használata esetén javasolt az Apache webszerver, a PHP és a MariaDB adatbázisszerver csomagkezelővel történő telepítése. Debian és Ubuntu használata esetén használd az alábbi parancsot.

sudo apt-get install apache2 mariadb-server php php-intl php-mbstring php-apcu php-curl php-mysql php-xml

Szoftvercsomagok

Más operációs rendszerek esetén használd a https://www.apachefriends.org weboldalról letölthető szoftvercsomagot, mint amilyen az XAMPP, amely tartalmazza az Apache-webszervert, a PHP-t és a MariaDB-t is. A szoftver Linux, Windows és Mac rendszerekhez érhető el. Jelenleg (2025. május) a XAMPP legfrissebb verziója PHP 8.2-ot használ (a MediaWiki telepítéséhez a 8.1.0 vagy újabb változat szükséges).

Apple-rendszereken használhatod a XAMPP-pal megegyező MAMP-ot is. A MAMP-pal jelenleg az Apache-szerver és MySQL-adatbázisok használhatóak. A szoftver Windows és Mac alá is elérhető, de főleg az utóbbin használatos.

Webszerver

Ahhoz, hogy a lapok a böngészőkben megjelenhessenek, a MediaWikinek szüksége van egy ezt lehetővé tevő szoftverre. Ebben gyakran nincs választásod – a tárhelyszolgáltatód által biztosított programot kell használnod.

A MediaWiki minden olyan szerverrel kompatibilis, amely képes a szükséges PHP-verzió futtatására. A legtöbb telepítés az Apache HTTPD webszervert használja. A Nginx (konfigurációs példa) is jó választás.

PHP

A MediaWiki PHP-ben íródott; a szoftver futtatásához ennek megléte szükséges.

• A legutóbbi MediaWiki-verzióhoz a PHP PHP 8.1.0 vagy újabb verziója szükséges. További információkért lásd a Kompatibilitás lapot.
• A következő PHP-alap kiterjesztések szükségesek (ezek általában a PHP részeként kerülnek lefordításra): calendar, ctype, dom, fileinfo, iconv, json, openssl, xml, xmlreader. Ellenőrizd a(z) php -m kimenetét, hogy megtudd, mely kiterjesztések vannak jelenleg engedélyezve a te esetedben.
• A következő PHP-alap kiterjesztések szintén kötelezőek:
  • intl - az MW 1.36 verzió óta kötelező
  • mbstring - az MW 1.27 verzió óta kötelező
  • bcmath vagy gmp - 32 bites rendszereken szükséges
• A kötelezőeken felül a következő kiterjesztések ajánlottak:
  • apcu
  • curl
• A MediaWiki csak olyan PHP-kiterjesztéseket igényel, amelyek alapértelmezetten engedélyezve vannak a PHP-ben. Ha a tárhelyszolgáltatód egy alap LAMP-környezetet biztosít ezek nélkül, előfordulhat, hogy manuálisan kell telepítened vagy engedélyezned őket.
  • Debian/Ubuntu rendszeren a következő parancs telepíti a fent felsorolt összes ajánlott PHP-kiterjesztést:

    sudo apt-get install php php-intl php-mbstring php-apcu php-curl

• Az olyan tárhelyszolgáltatóknál, ahol vezérlőpanel (például cPanel) érhető el, gyakran használhatod a „Select PHP Version” (PHP Selector) funkciót ezeknek a kiterjesztéseknek az engedélyezéséhez.

(Például, ha a következő üzenet jelenik meg: „Hiányzik egy, a MediaWiki futásához szükséges PHP-kiterjesztés. Telepítsd: intl”)

• A legtöbb Debian/Ubuntu-alapú disztribúción a MediaWiki MySQL-használatához szükség van a(z) php-mysql csomagra.
• A MediaWiki egyes funkcióihoz szükség lehet külső folyamatokat futtató PHP-függvényekre (például a képek bélyegképeinek előállításához), amelyeket egyes olcsó tárhelyszolgáltatók gyakran letiltanak. Kérlek, vedd ezt figyelembe, ha a MediaWiki telepítését megosztott tárhelyen tervezed.
• A MediaWiki-kiterjesztések további PHP-funkciókat igényelhetnek, például a(z) VisualEditor igényli a libcurl támogatást (Debian/Ubuntu-alapú disztribúciókon: php-curl).

Ha a PHP-t forrásból kell lefordítanod, lásd: PHP-beállítás – a MediaWikire hatással lévő fordítási opciókért.

Adatbázisszerver

A MediaWiki minden szöveget és adatot (tartalmi oldalakat, felhasználói adatokat, rendszerüzeneteket stb.) egy adatbázisban tárol, amelyet más webes alkalmazásokkal (például phpBB) is képes megosztani. A MediaWiki legújabb verziójának futtatásához a következő adatbázis-szerverek közül egyre lesz szükséged:

• MariaDB 10.3.0+ vagy MySQL 5.7.0+
• PostgreSQL 10.0+
• SQLite 3.24.0+

A MariaDB vagy a MySQL használata ajánlott, mivel a Wikimédia is MariaDB-t használ. Bármely más adatbázis-szerver kevésbé tesztelt, és nagy valószínűséggel hibákba ütközhetsz.

Az Oracle és a Microsoft SQL Server támogatása a MediaWiki 1.34-ben megszűnt.

Egyes felhasználók hasznosnak találják további vezérlőpult szoftverek telepítését, például a phpMyAdmin-t (MySQL/MariaDB) vagy a phpPgAdmin-t (PostgreSQL), amelyek segítik az adatbázis-szerver adminisztrációját. Néhány hosting services szintén biztosít ilyen szoftvereket.

Hardverigény

Az ajánlott minimális szükségletek 256 MB memória egy számítógépes weboldalhoz és 85 MB tárhely, azonban ez nem elég egy forgalmas nyilvános webhelyen vagy feltöltést engedélyező webhelyen. Néhány felhasználó állítólag sikeresen futtatta a MediaWikit 48 MB memóriával rendelkező számítógépeken.

Opcionális függőségek

• Az ImageMagick vagy a GD szükséges a képek bélyegképeinek előállításához.

.

• A(z) shell-hozzáférés szükséges a(z) Karbantartószkriptek futtatásához; enélkül a MediaWiki frissítése nehezebb lehet.
• A e-mail értesítések küldése közvetlenül a szerveren keresztül egy üzenettovábbító ügynököt (MTA) igényel.
• A GNU diff3 használható az ütközések automatikus feloldására.
• A memcached használható objektum-gyorsítótárazásra.

Lásd még

• Kompatibilitás – információ arról, hogyan változhatnak a MediaWiki telepítési követelményei a jövőben
• Kézikönyv:Rendszerspecifikus útmutatók