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
- Faites d'abord une sauvegarde complète des fichiers et de la base (par exemple avec votre propre
backup_wiki.sh). - Vérifiez la version installée sur la page
Special:Versiondu wiki. - Gardez une copie du
LocalSettings.phpactuel.
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.
Changer le logo
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
- Ne publiez jamais la clé de mise à jour, le mot de passe de la base ni celui du SMTP ; ils se trouvent dans
LocalSettings.php. - Lancez toujours
rclone sync --dry-rund'abord :syncsupprime les fichiers de destination absents de la source. - Mettez à jour version par version si les notes de version n'autorisent pas de sauter plusieurs versions.