Manuel de MediaWiki : I. Lecteurs – II. Éditeurs – III. Administrateurs

Index | Guide pour le manuel | Principes éditoriaux | MediaWiki | +/-

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.

Comment installer un wiki chez soi?

File:Noia 64 apps linuxconf.png Linux

Les points de départ sont :

nb: les utilisateurs de Gentoo peuvent passer par portage pour installer Mediawiki [1] comme décrit ici. Les utilisateurs de Mandriva peuvent l'installer avec urpmi en configurant la source contrib ( packagées).

Les étapes :

Chercher les sources à partir du lien donné sur http://wikipedia.sourceforge.net/ ou directement à partir de CVS comme expliqué sur sourceforge.
Décompresser ces sources dans un répertoire de travail (par exemple: /tmp/wikipedia).
Lire le fichier nommé INSTALL se trouvant dans les sources.
Il faudra installer Apache, php et MySQL. Les procédure détaillées sont décrites dans le fichier INSTALL. Il est souhaitable d'activer mod_rewrite lors de l'installation d'Apache, afin de permettre à Mediawiki d'utiliser des adresses url plus lisibles.
Quand php sera installé, il faudra mettre register_globals = on (dans la version 1.5.0 j'ai ce message:" #Warning: PHP's register_globals option is enabled. MediaWiki will work correctly, but this setting increases your exposure to potential security vulnerabilities in PHP-based software running on your server. You should disable it if you are able"). dans le fichier php.ini
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)
L'installation du logiciel Wikipedia 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.
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'admin et/ou de développeur à un utilisateur USER.user_rights -> 'sysop,developer'

Pour les configs, on peut utiliser:

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

Mac OS X

Activer le serveur Apache de Mac OS X : Préférences systèmes > Partage > Partage Web Personnel
Télécharger et installer MySQL : http://dev.mysql.com/downloads/mysql/5.0.html#Mac_OS_X
Télécharger et installer php : http://www.entropy.ch/software/macosx/php/#install
Télécharger MediaWiki : http://www.mediawiki.org/wiki/Download/fr
Décompresser le fichier en double-cliquant dessus.
Placer le dossier MediaWiki dans votre dossier ~/Sites ou dans le dossier /Bibliothèque/WebServer/Documents
Lancer votre navigateur et aller à l'adresse :
- http://localhost/votrenomdesession/mediawiki-X.X/ si vous avez mis mediawiki dans votre dossier Sites
- http://localhost/mediawiki-X.X/ si vous avez mis mediawiki dans le dossier WebServeur du disque dur
Suivre la procedure d'installation. Par défaut, il n'y a pas de mot de passe root pour mysql. Pour modifier la configuration de MySQL, télécharger Phpmyadmin (https://sourceforge.net/project/showfiles.php?group_id=23067) et placer le dans votre dossier Sites ou le dossier WebServer. L'accès à Phpmyadmin se fait de la même manière que Mediawiki en tapant http://localhost/votrenomdesession/phpmyadmin-X.X/ ou http://localhost/phpmyadmin-X.X/ dans votre naviguateur.

Windows

Installation de Mediawiki sur son PC

Télécharger et installer EasyPHP: http://www.easyphp.org/ (la version actuelle d'EasyPHP ne prend pas en compte le PHP5) ou Wamp (nécessaire à partir de Mediawiki 1.7) : http://www.wampserver.com/
Télécharger MediaWiki : http://www.mediawiki.org/wiki/MediaWiki/Versions_and_Download
- 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ée.
- Si le compte root(mysql) posséde un mot de passe, il faut le rentrer pour autoriser la création de la base de donnée du wiki. Sinon il faut mettre le mot de passe du root à vide(situation par défaut)(Si ce n'est pas vide, effacer!!).
- Avec Mediawiki 1.6xx, il peut être nécessaire de créer une base de données vide et un mot de passe root avec phpmyadmin ; vous entrerez alors le nom de la base et le mot de passe root dans la page d'installation de Mediawiki ; ensuite, vous devez ajouter votre mot de passe dans le fichier de configuration de phpmyadmin pou pouvoir y accéder.
- il n'est pas nécessaire de remplir les autres cases.
Lancez l'installation en cliquant sur Install.
Une fois l'instalation 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 !

Modifier certaines fonctionalités

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

Ouvrir le fichier avec Wordpad.
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 !

Supprimer index.php de l'adresse url

La page en anglais est ici : Eliminating index.php from the url.

Pour Mediawiki 1.6xx, une méthode possible est la suivante :

Fichier .htaccess :

RewriteEngine on
# Verifying if user forgot to put trailling slash. If so, we'll rewrite to Main_Page
RewriteCond %{REQUEST_URI} ^/$
RewriteRule ^(.*) /index.php?title=Accueil [L]

# Don't rewrite requests for files in MediaWiki subdirectories,
# MediaWiki PHP files, HTTP error documents, favicon.ico, or robots.txt
RewriteCond %{REQUEST_URI} !^/skins/
RewriteCond %{REQUEST_URI} !^/(redirect|texvc|index).php
RewriteCond %{REQUEST_URI} !^/error/(40(1|3|4)|500).html
RewriteCond %{REQUEST_URI} !^/favicon.ico
RewriteCond %{REQUEST_URI} !^/robots.txt
RewriteCond %{REQUEST_URI} !^/images/

# Make sure there is no query string (Unless user is making a search)
RewriteCond %{QUERY_STRING} ^$ [OR] RewriteCond %{REQUEST_URI} ^/Special:Search

# Rewrite http://wiki.___domain.tld/article properly, this is the main rule
RewriteRule ^/?(.*)$ /index.php?title=$1 [L,QSA]

Fichier LocalSetting.php :

$wgArticlePath      = "$wgScriptPath/$1";
#$wgArticlePath      = "$wgScript?title=$1";

Activer GD pour thumb et redimension des images

Lancer Easyphp
Cliquez sur le E en haut à gauche de la boite 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.

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 :

pour pouvoir créer des boites de ce type (Informations sur cette extension) :

grâce à la syntaxe suivante :

 <inputbox>
 type=box type
 parameter1=value
 parameter2=value
 </inputbox>

Copier coller dans un nouveau fichier sous Wordpad le fichier http://cvs.sourceforge.net/viewcvs.py/wikipedia/extensions/inputbox/ et enregistrer le dans votre dossier extension sous le nom inputbox.php.
Ajouter la ligne dans le fichier LocalSettings.php en l'éditant avec Wordpad :

require_once("extensions/inputbox.php");

Trouver des extensions

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.

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
- Les bases de données wikipédia, wikibooks, wiktionary sont disponibles :
- http://download.wikipedia.org/
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).

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

Comment installer chez son hébergeur ?

Installer et faire tourner Mediawiki correctement chez son hébergeur préféré n'est pas de tout repos, voici quelques conseils utiles.

Chez Free.fr

MediaWiki 1.4.x ne fonctionne pas directement sur des hébergeurs tels que Free (http://free.fr). Mais ce site tourne sous MediaWiki (http://wikipedia.sf.net) ET est hébergé par Free (http://free.fr) ! Pour cela, il faut légèrement modifier le code source de MediaWiki : ~~http://j.portalier.free.fr/wiki/index.php?title=MediaWiki#Corrections_pour_la_version_1.4.4_de_MediaWiki~~

Par contre, MediaWiki 1.5.7 s'installe bien sur free. Mais il ne semble pas possible de pouvoir modifier le menu de navigation. Les changements de MediaWiki:SideBar ne sont pas pris en compte.

MediaWiki 1.7.1 : voici une procédure d'installation assez simple : http://php.classes.free.fr/wiki/index.php5?title=MediaWikiChezFree; fonctionne bien en septembre 2006. Corrige le problème de login (noms de site avec un comte contenant un .)

Avec MediaWiki 1.6.7: (Télécharger la version 1.6.8 pré-modifiée et testée) Problèmes: impossibilité de connexion de l'utilisateur. test ici: http://archi.wiki.free.fr/wikimedia/index.php?title=Accueil

En rouge ce qui est enlevé
En vert ce qui est rajouté/modifié

/config/index.php: Ligne 40

require_once( "../includes/Defines.php" );
require_once( "../includes/DefaultSettings.php" );
require_once( "../includes/MagicWord.php" );
require_once( "../includes/Namespace.php" );

/config/index.php: Ligne 172

require_once( "../install-utils.inc" );
 require_once( "../maintenance/updaters.inc" );

/config/index.php: Ligne 359

foreach( $imcheck as $dir ) {
	$im = "$dir/convert";
	if( false file_exists( $im ) ) {

/config/index.php: Ligne 495

require_once(MW_INSTALL_PATH ."/includes/$dbclass.php");

/config/index.php: Ligne 502

require_once( MW_INSTALL_PATH ."/includes/Setup.php" );
chdir( "config" );

require_once( "../maintenance/InitialiseMessages.inc" );

/config/index.php: Ligne 816

$list = getLanguageList();
foreach( $list as $code => $name ) {
	$sel = ($code == $conf->LanguageCode) ? 'selected="selected"' : '';
	echo "\t\t<option value=\"$code\" $sel>$name</option>";
}
echo "\t\t<option value=\"fr\" selected>Français</option>";

/config/index.php: Ligne 1406

function locate_executable($loc, $names, $versioninfo = false) {
	if (!is_array($names))
		$names = array($names);

	foreach ($names as $name) {
		$command = "$loc".DIRECTORY_SEPARATOR."$name";
		if (file_exists($command)) {
			if (!$versioninfo)
				return $command;

			$file = str_replace('$1', $command, $versioninfo[0]);
			if (strstr(`$file`, $versioninfo[1]) !== false)
				return $command;
		}
	}
	return false;
}

/includes/DefaultSetting.php: Ligne 31

require_once( dirname( dirname( __FILE__ ) ) .'/includes/SiteConfiguration.php' );

/includes/DefaultSetting.php: Ligne 1064 ( MediaWiki Version 1.6.8 )

$wgDisableCookieCheck = falsetrue;

/maintenance/InitialiseMessages.inc: Ligne 55

require_once(MW_INSTALL_PATH .'/languages/Names.php');

/install-utils.inc: Ligne 29

@set_time_limit( 0 );

note : si vous rencontrez des problèmes de redirection après avoir fait ces changements, essayez d'intervertir les commentaires de ces deux lignes comme suit :

/LocalSettings.php: ligne 45

#$wgArticlePath      = "$wgScript/$1";
#$wgArticlePath      = "$wgScript?title=$1";

Chez Ouvaton.coop

La procédure d'installation automatique fonctionne tres bien. Seul probleme, pour les version 1.5 et 1.6 l'option Copier sur le serveur ne fonctionne pas et renvoi ce message d'erreur :

Fatal error: mime_magic could not be initialized, magic file is not available in /data/www/e/x/emple.ouvaton.org/html/wiki/includes/MimeMagic.php on line 504

Une bidouille pour faire fonctionner l'envoi de fichiers sur le serveur consiste à rajouter la ligne de code suivante dans le fichier LocalSettings.php:

$wgMimeDetectorCommand = "file -bi";

Le message d'erreur suivant apparait alors:

Warning: shell_exec(): Cannot execute using backquotes in Safe Mode in /data/www/e/x/emple.ouvaton.org/html/wiki/includes/MimeMagic.php on line 470

mais le transfert de fichier fonctionne. ^^

Chez OVH

L'installation de Mediawiki est la même que sur son PC sauf pour les informations suivantes (fournies par OVH):

le nom du serveur hôte SQL,
le nom de la base de donnée,
le mot de passe de la base de donnée.

Le préfixe de la table est obligatoire si la base de donnée SQL gère plusieurs processus. Le nom et le mot de passe du superutilisateur peuvent être configuré par défaut (root et -).

Pour Mediawiki 1.7 et supérieur (Php 5 requis), OVH ne supportant que la version 4 par défaut (pour le moment le basculement complet vers Php5 n'est pas prêvu), il faut utiliser l'astuce suivante:

Placer un fichier .htaccess à la racine du site (répertoire "www"), avec la ligne : SetEnv PHP_VER 5

Ceci permet d'installer Mediawiki sans problème.

Aujourd'hui de nouvelles offres avec PHP 5.1.4 en mutualisé et dédiés rendent les choses plus simples.

Chez 1&1 (1and1.fr)

Pour Mediawiki 1.7, il faut :

Renommer le dossier config en dossier configuration
Placer un fichier .htaccess avec la ligne : AddType x-mapp-php5 .php
Commencer l'installation en allant à l'adresse qui permet de lancer le fichier index.php présent dans le fichier configuration du type : http://monsite.com/dossierMediaWiki/configuration

Chez 1&1, il n'y a rien à faire, l'installation se fait normalement.

Voir Aussi

Discussion Wikipédia:Installation du logiciel MediaWiki

[ link title]

Template:H:f2

Help:Installation/fr

Contents