LLI Wiki — My Digital Knowledge Base

MediaWiki : mise à jour, extensions et installation auto-hébergée

Mettre à jour MediaWiki avec rclone, ajouter des extensions, installer sur son serveur avec Nginx et certbot, et tâches de maintenance.

Cet article décrit comment mettre à jour un MediaWiki auto-hébergé en décompressant la nouvelle version à côté de l'ancienne, en ajoutant les extensions, en réutilisant LocalSettings.php et en synchronisant le résultat vers la racine web. Il couvre aussi une installation locale (base de données, permissions, HTTPS) et quelques tâches de maintenance.

Avant de commencer

Télécharger la version et les extensions

Travaillez dans un dossier temporaire.

cd ~/tmp
curl -o mediawiki.tar.gz https://releases.wikimedia.org/mediawiki/1.45/mediawiki-1.45.3.tar.gz
tar -xvf mediawiki.tar.gz

Les extensions correspondant à une branche donnée se téléchargent depuis Special:ExtensionDistributor. Choisissez l'extension et la branche correspondant à votre version de MediaWiki ; la page fournit l'URL de l'archive. Ensuite :

curl -o MobileFrontend.tar.gz "<URL fournie par ExtensionDistributor>"
tar xvf MobileFrontend.tar.gz -C mediawiki-1.45.3/extensions

Répétez pour chaque extension utilisée. Extensions de cette installation :

Extension Rôle
MobileFrontend affichage mobile
CategoryTree navigation par catégories
intersection (DynamicPageList) lister des pages par catégorie
UserMerge fusion de comptes utilisateurs
Babel, cldr, CleanChanges, Translate, UniversalLanguageSelector wiki multilingue (voir installation de Translate)

Réutiliser la configuration

cp /usr/share/webapps/wiki/LocalSettings.php ~/tmp/mediawiki-1.45.3/

Déployer la nouvelle version

Vérifiez d'abord ce qui changerait avec --dry-run, puis exécutez pour de bon et corrigez le propriétaire :

sudo rclone sync ~/tmp/mediawiki-1.45.3 /usr/share/webapps/wiki/ --dry-run --verbose
sudo rclone sync ~/tmp/mediawiki-1.45.3 /usr/share/webapps/wiki/ --verbose
sudo chown -R wiki:wiki /usr/share/webapps/wiki/*

Sur un hôte distant, la même synchronisation peut viser un remote :

rclone sync mediawiki-1.45.3 wiki:/public_html/ --progress --transfers 8 --checkers 16 --buffer-size 64M --multi-thread-streams 8

Autre approche : garder des dossiers versionnés et basculer un lien symbolique :

cd new
rm current
ln -s ./mediawiki-1.45.3 current

Lancer la mise à jour web

Ouvrez https://wiki.example.com/mw-config/ et saisissez la clé de mise à jour présente dans LocalSettings.php ($wgUpgradeKey). Suivez les pages jusqu'à la fin.

Pendant la vérification, l'installeur peut avertir que le répertoire de téléversement par défaut est vulnérable car il peut exécuter des scripts. MediaWiki contrôle les fichiers téléversés, mais il reste fortement recommandé de désactiver l'exécution de scripts dans ce répertoire avant d'activer les téléversements. La vérification de l'environnement indique aussi si l'extension PHP intl est utilisée pour la normalisation Unicode.

Déposez les fichiers du logo dans resources/assets (par exemple en SFTP), puis modifiez LocalSettings.php :

$wgLogos = [
    '1x' => "$wgResourceBasePath/resources/assets/mylogo.128.png",
    'icon' => "$wgResourceBasePath/resources/assets/mylogo.128.png",
];

Modifier la barre latérale

La barre latérale est la page wiki MediaWiki:Sidebar, modifiable via index.php?title=MediaWiki:Sidebar&action=edit.

Installer sur son propre serveur

Base de données

CREATE DATABASE dbwiki;
CREATE USER uwiki IDENTIFIED BY '<PASSWORD>';
GRANT ALL PRIVILEGES ON dbwiki.* TO 'uwiki'@'%';
FLUSH PRIVILEGES;

Paramètres correspondants dans LocalSettings.php :

$wgDBtype = "mysql";
$wgDBserver = "localhost";
$wgDBname = "dbwiki";
$wgDBuser = "uwiki";
$wgDBpassword = "<PASSWORD>";
$wgDBprefix = "";
$wgDBTableOptions = "ENGINE=InnoDB, DEFAULT CHARSET=binary";

Test de la connexion :

mysql -h localhost -u uwiki -p dbwiki

Dossiers et fichiers

sudo mkdir /var/lib/wiki
sudo chown wiki:wiki /var/lib/wiki

sudo mkdir /usr/share/webapps/wiki
sudo cp -r ~/tmp/mediawiki-1.45.3/* /usr/share/webapps/wiki/
sudo chown -R wiki:wiki /usr/share/webapps/wiki/*

Restaurer la base depuis une sauvegarde

zcat db_backup.sql.gz | mysql -u uwiki -p

HTTPS avec Nginx

sudo certbot --nginx --agree-tos --redirect --staple-ocsp --email admin@example.com -d wiki.example.com

Maintenance

Exécutez un script de maintenance avec l'utilisateur web (depuis MediaWiki 1.40, les scripts passent par run.php) :

sudo su wiki
/usr/bin/php /usr/share/webapps/wiki/maintenance/run.php refreshLinks

Purger le cache d'une page :

https://wiki.example.com/index.php/Home?action=purge

Monter le site distant en SSH

sshfs permet de parcourir le compte d'hébergement comme un dossier local :

sudo mkdir /mnt/wiki
sudo chmod 755 /mnt/wiki
sudo sshfs -o allow_other,default_permissions user@example.com:~/ /mnt/wiki

# démontage
sudo umount /mnt/wiki

Sans root : sshfs -o idmap=user,allow_other,default_permissions user@example.com:~/ mnt/wiki.

Remarques

Mastodon LLIMastodon SocialFosstodon