Aide:Installation du logiciel MediaWiki

Un article de Wikipédia, l'encyclopédie libre.

Cette page a pour but d'expliquer comment installer Mediawiki.

Mediawiki vous permet de vous créer en quelques minutes un wiki personnalisable, soit pour une utilisation privée ou en réseau interne sur votre PC ou plusieurs PC, soit pour votre site.

Voir également Aide:Installation de MediaWiki sur méta.

b:Accueil

Wikibooks propose un ouvrage abordant ce sujet : MediaWiki pour débutants.

Sommaire

[modifier] Comment installer un wiki chez soi ?

[modifier] Linux

[modifier] Cas général

Les points de départ sont :

  1. en:Wikipedia:MediaWiki
  2. m:MediaWiki
  3. m:How to become a MediaWiki hacker
  4. http://wikipedia.sourceforge.net/


Les étapes :

  1. Chercher les sources à partir du lien donné sur http://wikipedia.sourceforge.net/ ou directement à partir de CVS comme expliqué sur sourceforge
  2. Décompresser ces sources dans un répertoire de travail (par exemple: /tmp/wikipedia
  3. Lire le fichier nommé INSTALL se trouvant dans les sources
  4. Il faudra installer Apache, php et MySQL. Les procédures détaillées sont décrites dans le fichier INSTALL. Apache aura besoin de mod_rewrite.
  5. Comme expliqué dans INSTALL, il faudra créer et configurer les fichiers LocalSettings.php et AdminSettings.php; notamment avec les mots de passe des utilisateurs de MySQL et les répertoires choisis dans la configuration de Apache (httpd.conf)
  6. L'installation du logiciel Wikipédia en lui-même se fera en lançant le fichier d'installation php install.php. Il copiera les fichiers php, créera la base de données et les tables.
  7. L'installation crée 2 utilisateurs, mais j'ignore le mot de passe. Mais il est facile d'utiliser MySQL pour donner les droits d'administrateur et/ou de développeur à un utilisateur USER.user_rights -> 'sysop, developer'

Pour les configurations, on peut utiliser :

  • apache: DocumentRoot "/usr/local/apache/htdocs"
  • Dans LocalSettings.php :
    • $IP = "/usr/local/apache/wiki-php";

[modifier] Distributions utilisant APT

Les distributions concernées sont Debian, Knoppix et Ubuntu.

  • Installez le paquet nommé "mediawiki"

(il faut que le serveur apache soit lancé!)  : cliquez sur setup

    • affichage de l'état de l'environnement (apache, php, mysql ...)
    • proposition de configuration du mediawiki : zones
      • site config
      • mail
      • Database

vous demande mot de passe mysql ...

cliquez sur install


  • Déplacez le fichier LocalSettings.php généré de /var/lib/mediawikiNN/config dans le répertoire /var/lib/mediawikiNN/
  • rechargez la page : le Wiki est prêt

[modifier] Distribution Gentoo

Les utilisateurs de Gentoo peuvent passer par portage pour installer Mediawiki : http://fr.gentoo-wiki.com/How-to_Mediawiki .

[modifier] Windows

[modifier] Installation de Mediawiki sur son PC

  • Télécharger et installer Easyphp : http://www.easyphp.org/ (20 août 2007: la version stable d'EasyPHP [1.8] ne prend pas en compte le PHP5 présent à partir de wiki 1.7, la version beta [2.0] le prend en charge) ou Wamp : http://www.wampserver.com/
  • Télécharger Mediawiki : http://sourceforge.net/projects/wikipedia
    • Il faut le décompresser deux fois. Si vous n'avez pas de compresseur pour les extensions gz et tar, vous pouvez télécharger par exemple 7-zip : http://www.7-zip.org/
  • Placer le dossier Mediawiki obtenu dans EasyPHP\www (vous pouvez renommer le dossier mediawiki, par exemple : wiki)
  • Lancer easyphp.
  • Lancer votre navigateur.
  • Tapez l'adresse : http://localhost/mediawiki-X.X/ (X étant le numéro de version du dossier Médiawiki), ou http://localhost/wiki par exemple, si vous avez renommé le dossier.
  • Suivez le processus d'installation :
    • définir une licence ;
    • donner un nom à votre wiki ;
    • choisir un pseudo et un mot de passe ;
    • choisir un mot de passe pour la base de données ;
    • il n'est pas nécessaire de remplir les autres cases ;
    • Avec Mediawiki 1.6xx, il peut être nécessaire de créer une base de données vide et de donner un mot de passe au login root avec phpmyadmin ; vous entrerez alors le nom de la base, le login root et le mot de passe de root dans la page d'installation de Mediawiki ; ensuite, vous devez ajouter votre mot de passe dans le fichier de configuration de phpmyadmin pour pouvoir y accéder.
  • Lancez l'installation en cliquant sur Install.
  • Une fois l'installation terminée, cliquer sur le lien qui s'affiche en bas à droite ;
  • déplacer le fichier LocalSettings.php qui se trouve dans le dossier mediawiki-X.X/Config vers le dossier supérieur : mediawiki-X.X.
  • Revenez à votre navigateur et cliquez sur OK dans la barre de navigation : votre wiki apparaît !

note importante : Ce que vous avez créé (serveur, mediawiki et contenu) peut être dupliqué sur d'autres PC sous Windows. Il suffit de copier/coller le répertoire créé "\Program Files\EasyPHP\"

[modifier] Installation de Mediawiki sur un serveur non-dédié

  • Télécharger et installer Easyphp : http://www.easyphp.org/ (la version actuelle d'EasyPHP ne prend pas en compte le PHP5 présent à partir de wiki 1.7) ou Wamp : http://www.wampserver.com/
  • Télécharger Mediawiki : http://sourceforge.net/projects/wikipedia
    • Il faut le décompresser deux fois. Si vous n'avez pas de compresseur pour les extensions gz et tar, vous pouvez télécharger par exemple 7-zip : http://www.7-zip.org/
  • Placer le contenu du dossier Mediawiki obtenu dans EasyPHP/www (vous devez pour cela supprimer le fichier "index.php contenu dans ce dossier. si vous comptez vous servir plus tard d'EasyPhp, archivez "index.php" dans un autre dossier que EasyPHP/www.)
  • Lancer easyphp.
  • Lancer dans easyphp : e - Configuration - PhpMyadmin. Aller dans "Privilèges" et cliquer sur la petite icône tout à droite de la colonne "root". Rentrer un mot de passe pour l'utilisateur.
  • Lancer votre navigateur.
  • Tapez l'adresse : http://localhost/.
  • Suivez le processus d'installation :
    • définir une licence ;
    • donner un nom à votre wiki ;
    • choisir un pseudo et un mot de passe ;
    • choisir un nom pour la base de données (noté dans la suite NomdelaBDD) ;
    • choisir un mot de passe pour la base de données (login et mot de passe de PHPMyAdmin) ;
    • il n'est pas nécessaire de remplir les autres cases.
  • Lancez l'installation en cliquant sur Install.
  • Une fois l'installation terminée :
    • Déplacer le fichier LocalSettings.php qui se trouve dans le dossier EasyPHP/www/Config/ vers le dossier supérieur : EasyPHP/www/.
    • Revenez à votre navigateur et cliquez sur OK dans la barre de navigation : votre wiki apparaît !


[modifier] Installation sur free.fr
  • Ensuite, les étapes à suivre sont les suivantes :
    • Transférez par ftp tout le contenu de EasyPHP/www/ sauf LocalSettings.php
    • Transférez les tables créées dans votre base de données. Il faut pour cela :
      • Accédez à votre base de données locale, en cliquant dans EasyPhp sur "administration" puis "BDD", ce qui vous amène à une page "PhpMyadmin"
      • Cliquez sur NomdelaBDD dans le volet de gauche : les tables créées par MediaWiki s'affichent dans le volet de droite. Cliquez sur "Exporter" en haut du volet de droite, puis sur "Tout sélectioner", ce qui sélectionne toutes les tables. Sélectionnez pour votre exportation "format zippé". Cliquez enfin sur "exécuter". Un fichier Zip s'enregistre alors sur votre ordinateur. Dézipez-le, vous obtenez un fichier texte nommé comme cela : NomdelaBDD.sql
      • Il faut maintenant transférer cela sur votre base de données free. Vous y accédez par http://sql.free.fr. Vous vous identifiez, puis vous cliquez à gauche sur "Votrelogin", puis sur l'icône marquée "SQL". Vous cliquez alors sur "parcourir" en-dessous de "emplacement du fichier texte", puis "exécuter". Vos tables sont maintenant transférées.
  • Il faut enfin modifier le fichier "LocalSettings.php". Ouvrez-le avec le bloc-notes. Puis :
Remplacez la ligne du genre $IP = "/var/www/mediawiki"; par la ligne $IP = ".";

ou alors :

Avant la ligne : if( defined( 'MW_INSTALL_PATH' ) ) { ... 
ajoutez la ligne suivante :
define( 'MW_INSTALL_PATH', $_SERVER['DOCUMENT_ROOT'].'/ mon répertoire d'installation' );
(sans oublier de remplacer '/ mon répertoire d'installation :) (source : http://faq.free.fr/adsl/5/9/3/10 )

puis :

Remplacez :  $wgArticlePath = "$wgScript/$1"; par :  #$wgArticlePath = "$wgScript/$1";
(Il suffit d'ajouter le #)

et enfin,

De même, remplacez :  #$wgArticlePath = "$wgScript?title=$1";  par : $wgArticlePath = "$wgScript?title=$1";
(Il suffit d'enlever le #)

Puis, le bloc suivant doit être rempli comme suit :

$wgDBserver         = "sql.free.fr";
$wgDBname           = "<nom de la base>";
$wgDBuser           = "<nom de l'utilisateur chez Free>";
$wgDBpassword       = "<mot de passe>";

Chez Free, le nom de la base est le même que celui de l'utilisateur et que l'adresse du site (sauf si le nom utilisateur contient un point (ex: "prenom.nom"). Dans ce cas, la base s'appelle "prenom_nom").

Enfin, ajoutez n'importe où dans le fichier la ligne suivante :

$wgUseDatabaseMessages = false;


  • Vous pouvez maintenant envoyer ce fichier à la racine de votre site web.
  • Enfin, créez un dossier "sessions" à la racine de votre site web.
  • Tapez dans votre navigateur l'adresse de votre site : votre wiki apparaît !

Attention tout ceci est valable pour la version 1.6.8 de mediawiki les versions 1.7.x et ultérieures tournant en php 5.x et free n'étant pas (septembre 2006) php 5 cela ne fonctionnera pas et il vous faudra utiliser la version 1.6.8 (php 4) de mediawiki.

FREE ET LE PHP5 : De nombreux utilisateurs des pages perso Free pensent que PHP 5 n'est pas disponible chez cet hébergeur gratuit. En réalité, pour des raisons de compatibilité avec d'anciens scripts, le choix est laissé entre PHP 4 et PHP 5 (et ce n'est pas une nouveauté !). Par défaut les fichiers portant l'extension ".php" sont interprêtés par PHP 4. Pour utiliser le moteur PHP 5, deux possibilités :

  • utiliser des fichiers avec l'extension ".php5" ;
  • ou plus simplement, créer (ou modifier si on n'en utilise déjà un pour d'autres raisons) un fichier ".htaccess" comportant simplement une ligne avec "php 1" (sans les guillemets).

[modifier] Mac OS X 10.4

Mac OS X dispose par défaut d'un serveur apache, pour l'activer il faut aller dans les préférences système (depuis le menu pomme) puis dans Partage et ensuite dans l'onglet Services sélectionner Partage Web personnel et cliquer ensuite sur le bouton activer à droite.

Apache ne dispose pas de PHP ni de MySQL par défaut, il faut donc les installer. Il existe entropy.ch qui propose un paquet pour installer PHP 5 (requis depuis MediaWiki 1.7). Les instruction d'installation sont disponible sur la page mentionnée ci-dessus. Il faudra redémarrer le serveur apache après l'installation. Pour télécharger MySQL, rendez-vous sur dev.mysql.com.

Il faut maintenant installer MediaWiki (téléchargeable sur Sourforge.net) puis le décompresser (le Finder doit arriver à décompresser ce fichier sans module externe). La racine du serveur Web se trouve par défaut à /Library/WebServer/Documents pour le trouver il faut aller dans Macintosh HD -> Bibliothèque -> WebServer -> Documents. Y déposer le dossier de MediaWiki, les est possible de le renommer en n'importe quel nom (exemple : wiki). La configuration se fait par l'interface web, il faut donc aller à l'adresse http://localhost/wiki/config (remplacer wiki par le nom du dossier de MediaWiki).

Attention : le sous-dossier config du répertoire de MediaWiki doit être accessible en écriture, il faut donc faire un pomme-i en ayant ce dossier sélectionné puis choisir Lecture et écriture pour Autres utilisateurs (la dernière boîte déroulante tout en bas).

Il faut suivre les instructions données par le programme d'installation de MediaWiki puis une fois l'installation terminée, il faut déplacer LocalSettings.php qui se trouve dans le dossier config dans le répertoire principal de MediaWiki. Par mesure de sécurité, il est recommandé de supprimer le dossier config (ou de le sauvegarder ailleurs sur l'ordinateur mais à un endroit non accessible depuis un navigateur internet (c'est-à-dire ailleurs que dans le répertoire WebServer ainsi que des sous-dossiers).

[modifier] Modifier certaines fonctionnalités

[modifier] Autoriser l'import d'images

Dans le fichier LocalSettings.php, pour activer l'importation de fichier son et image :

  • Ouvrir le fichier avec un éditeur de texte.
  • Trouver les lignes suivantes :
# To enable image uploads, make sure the 'images' directory
# is writable, then uncomment this:
# $wgEnableUploads              = true;
# $wgUseImageResize             = true;
# $wgUseImageMagick = true;
# $wgImageMagickConvertCommand = "/usr/bin/convert";

Supprimer les # :

## To enable image uploads, make sure the 'images' directory
## is writable, then uncomment this:
$wgEnableUploads                = true;
$wgUseImageResize               = true;
#$wgUseImageMagick = true;
#$wgImageMagickConvertCommand = "/usr/bin/convert";
  • Enregistrer. C'est fait !...

[modifier] Activer GD pour thumb et redimension des images

Sur Windows :

  • Lancer Easyphp
  • Cliquez sur le E en haut à gauche de la boîte de Easyphp pour avoir le menu, ou cliquez droit sur l'icône en bas à droite dans la barre Windows
  • Aller dans Configuration
  • Aller dans Extensions php
  • Faire défiler la liste jusqu'à Php_gd2
  • Cocher la case
  • Cliquer sur appliquer, puis fermer, et c'est fait

Cette activation peut être réalisée en éditant le fichier php.ini, dans le dossier Apache. Cherchez la ligne :

;extension=php_gd2.dll

supprimez le point virgule puis enregistrez.

[modifier] Installer des extensions

Pour installer une extension, enregistrer le fichier nomdel'extension.php dans votre dossier extensions, puis ajouter une ligne

require_once("extensions/nomsdel'extension.php");

dans le fichier LocalSettings.php.

Exemple :

grâce à la syntaxe suivante :

 <inputbox>
 type=box type
 parameter1=value
 parameter2=value
 </inputbox>
require_once("extensions/inputbox.php");

[modifier] Trouver des extensions

[modifier] Transférer une base de données

Si vous souhaitez installer une base de données vers une nouvelle installation de Mediawiki, il est possible d'exporter chaque table et de les recréer une à une par phpmyadmin :

  • Sélectionner une table ;
  • Tout cocher, puis exporter ;
  • Sélectionner sql dans le menu Exporter ;
  • Sélectionner : Insertions complètes, dans Données.
  • Exécuter ;
  • Copier le résultat ;
  • Aller dans phpmyadmin de la nouvelle base de données ;
  • Onglet SQL ;
  • Coller le résultat de l'exportation ;
  • Exécuter.

Afin de réduire le temps de recopie des tables, vous pouvez exporter ensemble et en même temps les tables les plus petites, et les exécuter en même temps également dans la nouvelle base de données.

[modifier] Installer une base de données (Wikipédia, Wikibooks, etc.)

Etant donné que les informations sont introuvables sur ce sujet, nous vous conseillons la prière ou de tenter divers rituels magiques.

  • Télécharger une base de données
  • Théoriquement, vous pouvez créer la base de données dans MySQL :
    • Dans MySQL, il faut taper les commandes suivantes : (cf. Requêtes SQL) :
 
Welcome to the MySQL monitor.  Commands end with ; or \g.
Your MySQL connection id is 16 to server version: 5.0.10-beta-log

Type 'help;' or '\h' for help. Type '\c' to clear the buffer.

mysql> CREATE DATABASE wikipedia;
Query OK, 1 row affected (0.37 sec)
mysql> USE wikipedia;
Database changed
mysql> SOURCE nom_du_fichier_wikimedia.sql;

La copie des informations dans les tables après avoir lancé SOURCE peut prendre plusieurs dizaines de minutes ou plusieurs heures suivant la taille de la base de données.

  • Installer Mediawiki :
    • Donner au site que vous installez le nom exact du site de la base de données : Wikipédia, Wikilivres, etc.
    • Remplacer le nom de la base de données par défaut (wikidb).

[modifier] Note

Le répertoire easyphp peut être ensuite copié/collé sur d'autres PC sous Windows, vous pouvez facilement donner Wikipédia (par contre il faudra l'updater grâce au dump dans MySQL

[modifier] Alternative

Eclipse est une plate-forme de développement qui peut très bien se déguiser en éditeur wiki WYSIWYG. Cette méthode évite d'avoir à installer MediaWiki pour ceux qui veulent juste modifier des articles localement tout en ayant une vue sur le résultat. Using Eclipse Wikipedia Editor

[modifier] Guide pour aller plus loin