Mediawiki 1.31 LTS telepítése Debian-Apache-MySQL környezetben

Összefoglalás

A leírás a Mediawiki 1.31 LTS kiadásának telepítését mutatja be. A leírásban szereplő url-ek alverziónként változnak, ezeket módosítani kell.

A leírás Debian 9.11 operációs rendszeren készült. Az Apache http szervert, a Php futtatókörnyezet és a MySQL adatbázis szervert az operációs rendszer tárolójából telepítjük.

A parancsok root jogot feltételeznek. (állandó root jog: sudo -i)

Előfeltételek

Minimum követelmények

• PHP 7.0.0+
• MySQL 5.5.8+ / MariaDB 5.1+
• Debian 9+ (amennyiben a környezetet az operációs rendszer tárolójából telepítettük)

Webszerver, adatbáziszerver és Php futtatókörnyezet telepítése

apt -y install apache2 mysql-server php php-mysql php-mbstring php-xml php-pecl-http php-apcu php-intl

Adatbázis létrehozása

SQL futtatása: (Feltételezve, hogy a mysql root felhasználónak konzolból nincs jelszava - telepítés alapértelmezett)

• my_wiki: adatbázis neve
• wikiuser: adatbázis felhasználó neve
• password: adatbázis felhasználó jelszava

mysql -uroot -e "CREATE DATABASE my_wiki CHARACTER SET utf8;
CREATE USER 'wikiuser'@'%' IDENTIFIED BY 'password';
GRANT ALL PRIVILEGES ON my_wiki.* TO 'wikiuser'@'%';"

Webszerver konfigurálása

Az alábbi beállításokkal létre kell hozni az /etc/apache2/sites-available/mediawiki.conf Apache konfigurációt.

• ServerName: domain név, ami alatt a wiki elérhető lesz. (A domaint konfigurálni kell a kiszolgáló IP címéhez)
• ServerAlias: további domain nevek.
• ServerAdmin: webmester e-mail címe.
• DocumentRoot: A könyvtár, ahová a mediawiki motor telepítve lesz.
• VirtualHost: a *:443 a https, a *:80 a http konfiguráció, ha csak az egyik kell, a másik elhagyható
• https konfiguráció
  • SSLCertificateFile: tanúsítvány fájl
  • SSLCertificateKeyFile: privát kulcs file
  • Include (opcionális): tanúsítvány lánc fájl

<IfModule mod_ssl.c>
    <VirtualHost *:443>
        ServerName mydomain.com
        ServerAlias www.mydomain.com
        ServerAdmin webmaster@mydomain.com
        DocumentRoot [vhostdir]
        <Directory "/[vhostdir]/images">
            AllowOverride None
            AddType text/plain .html .htm .shtml .phtml
            php_admin_flag engine off
        </Directory>

        ErrorLog ${APACHE_LOG_DIR}/error.log
        CustomLog ${APACHE_LOG_DIR}/access.log combined

        SSLEngine on
        SSLCertificateFile  /etc/ssl/certs/ssl-cert-snakeoil.pem
        SSLCertificateKeyFile       /etc/ssl/private/ssl-cert-snakeoil.key
        #Include       /etc/ssl/certs/ssl-chain.conf
    </VirtualHost>
</IfModule>

<VirtualHost *:80>
    ServerName mydomain.com
    ServerAlias www.mydomain.com
    ServerAdmin webmaster@mydomain.com
    DocumentRoot [vhostdir]
    <Directory "[vhostdir]/images">
        AllowOverride None
        AddType text/plain .html .htm .shtml .phtml
        php_admin_flag engine off
    </Directory>
    
    ErrorLog ${APACHE_LOG_DIR}/error.log
    CustomLog ${APACHE_LOG_DIR}/access.log combined
</VirtualHost>

Apache konfiguráció érvényesítése:

ln -s /etc/apache2/sites-available/mediawiki.conf /etc/apache2/sites-enabled/mediawiki.conf
service apache2 restart

Mediawiki motor telepítése

A megfelelőMediawiki release letöltése és a fájl kogosultságok beállítása:

wget -qO- https://releases.wikimedia.org/mediawiki/1.31/mediawiki-1.31.X.tar.gz | tar -xzf - -C /tmp
mv /tmp/mediawiki-1.31.X [vhostdir]
chown -R www-data:www-data [vhostdir]

A mediawiki telepítése böngészőben, a beállított domain használatával folytatható. pl: https://mydomain.com

Wiki web install step 1

Wiki nyelvének kiválasztása

Wiki web install step 2

Környezet ellenőrzése

Wiki web install step 3

Adatbázis adatok megadása

Wiki web install step 4

Wiki web install step 5

Wiki név és admin user megadása

Wiki web install step 6

Wiki részletesebb konfigurálása

Wiki web install step 7

Telepítés indítása

Wiki web install step 8

Wiki web install step 9

Konfigurációs fájl mentése

Wiki web install step 10

A letöltött LocalSettings.php fájlt a /var/www/mediawiki/ könyvtárba kell másolni.

Hasznos beállítások

Natív html engedélyezése

A szerkesztőnek engedélyezni lehet, hogy html tartalmat illesszen az oldalba.

A /[vhostdir]/LocalSettings.php konfigurációs fájlba illesszük be a következőt:

$wgRawHtml = true;

A bekapcsoláskor a <html>...</html> tagek közé helyezett html kódot nem értelmezi, változatlanul hagyja.

Több információ

Feltölthető képméret növelése

A /[vhostdir]/LocalSettings.php konfigurációs fájlba illesszük be a következő konfigurációs elemet. Lehetséges értékek és információ A php fájlfeltöltés méretét is növelni kell a php.ini, ha az kisebb a beállított értéknél.

$wgMaxImageArea =

Kód kiemelés (code syntax highlighting) beállítása

A telepített verzióban installálva van a SyntaxHighlight bővítmény, de kell még pár beállítás, hogy működjön.

Pygments Python modul futtathatóságának beállítása:

chmod a+x /[vhostdir]/extensions/SyntaxHighlight_GeSHi/pygments/pygmentize

A /[vhostdir]/LocalSettings.php konfigurációs fájlba illesszük be a következő konfigurációs elemet.

$wgSyntaxHighlightModels[CONTENT_MODEL_SCRIBUNTO] = 'lua';

E-mail beállítások

A /[vhostdir]/LocalSettings.php konfigurációs fájlba illesszük be az alábbi konfigurációs elemeket. További információ

$wgEnableEmail = true;  // E-mail küldés engedélyezése
$wgSMTP = [
    'host'     => "mail.example.com", // SMTP server domain vagy IP cím
    'IDHost'   => "example.com",      // SMTP helo név, tipikusan a wiki domain név
    'port'     => 25,                 // SMTP server port
    'auth'     => true,               // SMTP authentikáció engedélyezése (true vagy false)
    'username' => "my_user_name",     // SMTP user név
    'password' => "my_password"       // SMTP jelszó
];
$wgPasswordSender = "noreply@mydomain.com";     // általános e-mail feladó
$wgEmergencyContact = "noreply@mydomain.com";   // rendszer riasztások e-mail feladó
$wgEmailAuthentication = true;                  // e-mail megerősítése szükséges, hogy a rendszer e-mail küldjön a regisztrált címre
$wgEmailConfirmToEdit = true;                   // e-mail megerősítése szükséges a wiki szerkesztéséhez

Egyéb funkciók

Rich text szövegszerkesztő (VisualEditor)

Active Directory integráció