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 szerver és a Php futtatókörnyezet az operációs rendszer tárolójából telepítettü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
A pédában Apache-Debian alapértelmezés, a /var/www/ könyvtár és a www-data user lesz használva.
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 /var/www/mediawiki
<Directory "/var/www/mediawiki/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 /var/www/mediawiki
<Directory "/var/www/mediawiki/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
wget -qO- https://releases.wikimedia.org/mediawiki/1.31/mediawiki-1.31.X.tar.gz | tar -xzf - -C /var/www/
mv /var/www/mediawiki-1.31.X /var/www/mediawiki
chown -R www-data:www-data /var/www/mediawiki/
A mediawiki telepítése böngészőben, a beállított domain használatával folytatható. pl: https://mydomain.com
Wiki nyelvének kiválasztása
Környezet ellenőrzése
Adatbázis adatok megadása
Wiki név és admin user megadása
Wiki részletesebb konfigurálása
Telepítés indítása
Konfigurációs fájl mentése
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 /var/www/mediawiki/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.
Feltölthető képméret növelése
A /var/www/mediawiki/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 /var/www/mediawiki-1.31.5/extensions/SyntaxHighlight_GeSHi/pygments/pygmentize
A /var/www/mediawiki/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 /var/www/mediawiki/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
