Créer un site avec MediaWiki
MediaWiki est un logiciel wiki libre qui permet de créer une encyclopédie, un guide, une base de connaissances interne, un magazine en ligne ou un site thématique à édition collaborative. Le logiciel est gratuit, mais un fonctionnement stable demande une configuration correcte du serveur, des mises à jour régulières, des sauvegardes et une gestion claire des droits.
Cet article explique comment installer, configurer et maintenir un site fondé sur MediaWiki. Les questions, compléments et remarques peuvent être laissés sur la page de discussion.
Présentation de MediaWiki
MediaWiki est un logiciel libre principalement écrit en PHP. Il met en place un environnement wiki hypertexte et a été développé à l'origine pour Wikipédia. Il est aujourd'hui utilisé par les projets de la Wikimedia Foundation et par de nombreux sites indépendants.[1]
MediaWiki convient particulièrement aux sites structurés autour d'articles et de pages d'information, car il prend en charge l'historique des versions, les catégories, les espaces de noms, les modèles, les fichiers téléversés, les droits des utilisateurs et un système d'extensions. Son interface est traduite dans de nombreuses langues, ce qui permet aussi de bâtir des projets multilingues.
MediaWiki n'est pas un simple générateur de pages statiques. C'est une plateforme wiki complète pour les projets dont les pages sont enrichies, liées, classées et améliorées au fil du temps par un ou plusieurs auteurs.
Installation de MediaWiki
Avant l'installation, il faut définir le type de site à créer : encyclopédie publique, base de connaissances fermée, projet multilingue, dépôt de fichiers ou guide thématique compact. Ce choix influence les droits des utilisateurs, les extensions, la stratégie de sauvegarde et les exigences d'hébergement.
Une installation courante nécessite Apache ou Nginx, PHP, une base de données comme MariaDB/MySQL, PostgreSQL ou SQLite, ainsi qu'un accès aux fichiers du site et à la base de données. Avant l'installation, il faut toujours vérifier les prérequis de la version choisie, car les exigences relatives à PHP et aux extensions PHP changent selon les versions.[2]
Étapes principales :
- vérifier les prérequis officiels ;
- télécharger une version stable depuis la page officielle de téléchargement ;
- créer une base de données et un utilisateur de base de données ;
- téléverser les fichiers MediaWiki sur le serveur par FTP/SFTP ou SSH ;
- ouvrir le site dans le navigateur et lancer l'assistant d'installation ;
- enregistrer le fichier `LocalSettings.php` généré et le placer dans le dossier principal de MediaWiki ;
- tester la page d'accueil, la connexion, la création de pages et le téléversement de fichiers.
Installation avec l'assistant web
Après le téléversement des fichiers, il faut ouvrir le domaine du site dans le navigateur. Si MediaWiki n'est pas encore configuré, un lien vers l'installation apparaît. L'assistant vérifie l'environnement, demande la langue de l'interface, se connecte à la base de données, définit le nom du site, crée le compte administrateur et propose les paramètres de base.[3]
Pour la connexion à la base, il faut indiquer le type de base de données, son nom, l'utilisateur et le mot de passe. Ces données sont généralement créées à l'avance dans le panneau d'hébergement, dans phpMyAdmin ou depuis le terminal. Si l'assistant affiche une erreur de connexion, la cause est souvent un nom de base incorrect, des droits insuffisants, un hôte de base de données erroné ou une extension PHP manquante.
À la fin de l'installation, MediaWiki propose de télécharger `LocalSettings.php`. C'est le fichier principal de configuration du site : il contient la connexion à la base, le nom du site, l'habillage, les extensions activées, les droits et d'autres réglages. Ce fichier doit être placé dans le dossier où se trouve `index.php` de MediaWiki.
- Installation de MediaWiki
-
Vérification de compatibilité -
Connexion à la base de données -
Paramètres de la base de données -
Paramètres du site et de l'administrateur -
MediaWiki installé avec succès
Après l'installation, on peut commencer à créer des pages et des articles.
Configuration de base après l'installation
Les principaux réglages du site se trouvent dans `LocalSettings.php`. Avant toute modification, il est préférable d'en faire une copie, car une erreur dans le code PHP peut rendre le site temporairement indisponible.
Après l'installation, on configure souvent les éléments suivants :
- nom du site et adresses publiques ;
- téléversement de fichiers et types autorisés ;
- droits des visiteurs anonymes et des utilisateurs enregistrés ;
- envoi des courriels ;
- habillage par défaut ;
- URL courtes ;
- cache et performance ;
- sauvegarde des fichiers et de la base de données.
Exemple d'activation du téléversement de fichiers :
$wgEnableUploads = true;
Exemple de choix de l'habillage par défaut :
$wgDefaultSkin = "vector-2022";
Habillages MediaWiki
Dans MediaWiki, le thème visuel s'appelle un skin ou habillage. L'habillage moderne par défaut est Vector 2022. On peut aussi utiliser Vector legacy, MonoBook, Timeless, MinervaNeue pour l'affichage mobile et d'autres habillages.[4]
Un habillage est généralement installé dans le dossier `skins`, puis chargé dans `LocalSettings.php`. La page de chaque habillage sur MediaWiki.org contient ses propres instructions d'installation et de compatibilité.
Exemple de chargement d'un habillage :
wfLoadSkin( 'Vector' );
$wgDefaultSkin = 'vector-2022';
Si l'habillage n'apparaît pas, il faut vérifier le nom du dossier, la ligne de chargement, les droits des fichiers et la compatibilité avec la version de MediaWiki installée.
-
Vector 2022 -
Timeless
Extensions MediaWiki
Les extensions ajoutent des fonctions à MediaWiki : éditeur visuel, cartes, fonctions de parser, protection antispam, formulaires, forums, outils pour fichiers, données sémantiques et autres possibilités.[5]
Avant d'installer une extension, il faut vérifier sa compatibilité avec la version de MediaWiki, les dépendances PHP, les droits d'accès et les instructions de configuration. Certaines extensions se limitent à une ligne dans `LocalSettings.php`, tandis que d'autres nécessitent une mise à jour de la base de données ou des réglages supplémentaires.
Exemple de chargement d'une extension :
wfLoadExtension( 'ParserFunctions' );
Après l'installation ou la mise à jour de certaines extensions, il faut lancer le script de mise à jour de la base :
php maintenance/run.php update
Les extensions installées peuvent être vérifiées sur la page spéciale `Special:Version`.
URL courtes
Par défaut, les pages peuvent avoir des adresses du type `/index.php?title=Titre_de_page`. Pour un site public, les URL de type `/wiki/Titre_de_page` sont plus pratiques, plus lisibles et plus faciles à partager. Leur configuration dépend à la fois de MediaWiki et du serveur web.[6]
Exemple de réglages dans `LocalSettings.php` :
$wgScriptPath = "/w-wiki";
$wgArticlePath = "/wiki/$1";
$wgUsePathInfo = true;
Il faut ensuite ajouter les règles de réécriture dans Apache ou Nginx. Une erreur dans ces règles peut provoquer des redirections incorrectes, des erreurs 404 ou l'impossibilité d'ouvrir les pages spéciales.
Sécurité et droits
Pour un site public, il est important de limiter les risques de spam et de modifications non désirées. Les réglages de droits dépendent du projet : certains wikis autorisent l'édition anonyme, d'autres ne permettent l'édition qu'aux utilisateurs enregistrés ou à un groupe restreint.
Exemple d'interdiction de modification par les visiteurs anonymes :
$wgGroupPermissions['*']['edit'] = false;
$wgGroupPermissions['*']['createaccount'] = false;
Il faut aussi suivre les mises à jour de MediaWiki, des extensions et de PHP. Les sauvegardes régulières de la base de données et du dossier `images` sont indispensables, car c'est là que se trouvent les contenus et les fichiers du site.
Mise à jour de MediaWiki
MediaWiki doit être mis à jour régulièrement pour recevoir les correctifs de sécurité, les corrections de bugs et la compatibilité avec les versions récentes de PHP. Avant une mise à jour, il faut lire les notes de version et les instructions de mise à niveau de la branche utilisée.[7]
Avant toute mise à jour, il faut sauvegarder :
- la base de données ;
- `LocalSettings.php` ;
- le dossier `images` ;
- les extensions et habillages ajoutés ;
- les fichiers personnalisés du serveur.
Sur certains hébergements, on peut lancer la mise à jour depuis le navigateur. Après le remplacement des fichiers par une nouvelle version compatible, MediaWiki peut proposer une page de mise à jour. Cette méthode est simple, mais elle dépend fortement des limites de l'hébergement : temps d'exécution PHP, mémoire disponible, droits sur les fichiers et taille de la base.
Pour un petit site, la mise à jour par navigateur peut suffire. Pour un projet plus important, il vaut mieux utiliser SSH et les scripts de maintenance.
Mise à jour via SSH
La méthode la plus fiable consiste à mettre à jour le site depuis le terminal. Elle donne plus de contrôle et permet de voir les erreurs immédiatement.
Exemple général :
# passer dans le dossier du site
cd /chemin/vers/mediawiki
# sauvegarder la base avec les outils du SGBD
mysqldump -u db_user -p db_name > backup.sql
# sauvegarder les fichiers
cd ..
tar -czf mediawiki-files-backup.tar.gz mediawiki
# télécharger et décompresser la nouvelle version de MediaWiki
wget https://releases.wikimedia.org/mediawiki/1.43/mediawiki-1.43.5.tar.gz
tar -xzf mediawiki-1.43.5.tar.gz
# transférer LocalSettings.php, images et les fichiers personnalisés nécessaires
cp mediawiki/LocalSettings.php mediawiki-1.43.5/
rsync -a mediawiki/images/ mediawiki-1.43.5/images/
# après préparation du nouveau dossier, mettre à jour la base
cd mediawiki-1.43.5
php maintenance/run.php update
Dans les anciens guides MediaWiki, on rencontre souvent `php maintenance/update.php`; dans les versions récentes, il est préférable de lancer les scripts de maintenance avec `maintenance/run.php`. Avant d'exécuter les commandes, il faut toujours vérifier les instructions correspondant à la version installée.
Mise à jour des extensions
Les extensions et les habillages doivent correspondre à la version de MediaWiki. Après la mise à jour du noyau, il faut aussi mettre à jour les extensions, sinon le site peut devenir instable ou afficher des erreurs internes.
Si une extension a été installée avec Git, on met généralement à jour la branche correspondant à la version de MediaWiki. Si elle a été installée sous forme d'archive, il faut télécharger une nouvelle archive compatible depuis la page de l'extension. Après la mise à jour des extensions, il est souvent nécessaire de relancer :
php maintenance/run.php update
La page `Special:Version` permet ensuite de vérifier la version de MediaWiki, les extensions installées, les habillages et les informations principales sur l'environnement.
Note de l'auteur
MediaWiki est l'une des plateformes les plus pratiques pour créer des sites d'information structurés. L'installation de base est relativement simple, mais un projet stable demande un entretien régulier : mises à jour, sauvegardes, contrôle des extensions et attention aux droits des utilisateurs. Les questions sur l'installation, la mise à jour ou l'utilisation de MediaWiki peuvent être posées sur la page de discussion.
Voir aussi
Références
- ↑ MediaWiki. MediaWiki.org.
- ↑ Installation requirements. MediaWiki.org.
- ↑ Installing MediaWiki. MediaWiki.org.
- ↑ All skins. MediaWiki.org.
- ↑ Extensions. MediaWiki.org.
- ↑ Short URL. MediaWiki.org.
- ↑ Upgrading. MediaWiki.org.