From Meta

Manuel de MediaWiki : I. Lecteurs - II. Éditeurs - III. Administrateurs - IV. Développeurs Index | Guide pour le manuel | Principes éditoriaux | Autre aide | 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.

[edit] Comment installer un wiki chez soi?

[edit] Linux

Les points de départ sont :

1. MediaWiki
2. mw:How to become a MediaWiki hacker/fr

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 :

1. Chercher les sources à partir du lien donné sur mw:Download/fr ou directement à partir de SVN comme expliqué sur mw:Download from SVN.
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é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.
5. 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
6. 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)
7. 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.
8. 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";

[edit] Mac OS X

1. Activer le serveur Apache de Mac OS X : Préférences systèmes > Partage > Partage Web Personnel
2. Télécharger et installer MySQL : http://dev.mysql.com/downloads/mysql/5.0.html#Mac_OS_X_(package_format)
3. Télécharger et installer php : http://www.entropy.ch/software/macosx/php/#install
4. Télécharger MediaWiki : mw:Download/fr
5. Décompresser le fichier en double-cliquant dessus.
6. Placer le dossier MediaWiki dans votre dossier ~/Sites ou dans le dossier /Bibliothèque/WebServer/Documents
7. 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
8. 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.

[edit] Windows

[edit] 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 : mw:Download/fr
• 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 pour 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 !

[edit] Modifier certaines fonctionalités

Dans le fichier LocalSettings.php, afin d'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 !

[edit] 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";

[edit] 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.

[edit] 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");

[edit] Trouver des extensions

• mw:Category:Extensions
• MediaWiki: 1.5beta4 / EnotifWiki v3.48a from 2005-08-13 / FCKeditor 2.0

[edit] 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.

[edit] 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).

[edit] Voir Aussi

installer une base de données Wikimedia ( Wiktionnaire, Wikipédia,....) sous Ubuntu Linux

[edit] 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

[edit] 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.

[edit] Chez Free.fr

• Pour utiliser le php5 (nécessaire pour les installations récentes de Mediawiki), il vous suffit de 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), sinon voici le message d'erreur type rencontré : "PHP 5.0.x is buggy on your 64-bit system; you must upgrade to PHP 5.1.x or higher. ABORTING. (http://bugs.php.net/bug.php?id=34879 for details) "
• MediaWiki 1.12.0 :
  • même principe que pour la 1.11.0, sauf que les modifications dans le fichier config/index.php ne sont plus nécessaires (encore plus simple, donc).

L'ajout du .htaccess est en revanche toujours nécessaire à la racine du répertoire contenant le wiki.

• MediaWiki 1.11.0 :
  • Installation sur free directement. Au fur et à mesure des versions, cela devient de plus en plus facile :
    • pour ceux qui le désirent (fainéants, pressés, néophytes...), il y a une archive complète version free ici [2] et juste les fichiers changés ou ajoutés ici [3] : il faut donc décompresser cette dernière archive dans la version 1.11.0 récupérée depuis mediawiki
    • Pour les autres, il y a 4 lignes à changer dans le fichier config/index.php (la procédure d'installation)

ligne 517

       if( file_exists( $im ) ) {

se remplace par

       if( @file_exists( $im ) ) {

pour éviter des messages de warnings intempestifs

ligne 1794

       if (file_exists($command)) {

remplacé par

        if (@file_exists($command)) {

et, comble du raffinement, pour ne pas modifier le LocalSettings.php : ligne 1583, après

    \$wgScriptPath       = \"{$slconf['ScriptPath']}\";
    \$wgScriptExtension  = \"{$slconf['ScriptExtension']}\";

on rajoute

    \$wgArticlePath = \"/wiki/index.php/\$1\";
    \$wgUsePathInfo = true;

• • • Attention : Si vous installez Mediawiki dans un répertoire qui ne s'appelle pas "wiki" (ce qui est tout à fait possible) il faut changer le chemin ci-dessus en remplaçant "/wiki/index.php/" par "[nomdevotrerepertoiremediawiki]/index.php".
    • il faut rajouter un fichier htaccess pour rediriger le serveur free sur PHP5, comme indiqué au-dessus
    • il ne faut pas oublier de remplacer les points éventuels (.) dans le nom de la base de données par des underscores (_).
    • il faut ajouter un répertoire sessions à la racine du site

Attention au transfert FTP sur free, 2 connexions au maximum et regardez bien la log de votre transfert, il y a de longs fichiers dans Mediawiki qui ne passent pas forcément du premier coup ! FileZilla semble efficace sur tout système d'exploitation pour effectuer ce transfert et en particulier reprendre facilement le transfert des fichiers pour lesquels ça n'a pas marché du premier coup.

• MediaWiki 1.10.1 :
  • Procédure d'installation sur free.fr à partir d'une installation locale. Cette installation demande plus de manipulations mais ne nécessite presque aucune modification du code.

• • l'update 1.7.1 en 1.10.1 fonctionne sur Free (Marc Quinton, aout 2007).
  • Cécile MONAURY : en suivant les instructions c1-dessous pour la version 1.10.0, j'installe sans problème la 1.10.1. par contre, ne pas faire les modifications sur le fichier /maintenance/tables.sql, et ne pas oublier de créer un répertoire vide nommé "sessions" sur la racine de votre site Web. Sans cela, les droits d'écriture et d'administration ne fonctionneront pas pour les utilisateurs identifiés et pour le WikiSysop.

• MediaWiki 1.10.0 : Une procédure d'installation de MediaWiki chez free.fr n'utilisant que de très légères modifications du programme d'installation.

• 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. Apporte une solution au problème de login (noms de site avec un compte contenant un .)

• MediaWiki 1.6.8 : (Télécharger la version 1.6.8 pré-modifiée et testée), ou sinon suivez les instructions sur la page suivante : Installation de Mediawiki 1.6.8 sur free.fr

[edit] 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 renvoie 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. ^^

Note : Ouvaton fonctionne actuellement avec php4. La mise à jour vers php5 est prévue d'ici fin 2006, ce qui devrait permettre l'utilisation normale des dernières versions de Mediawiki.

[edit] 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.

[edit] Chez 1&1 (1and1.fr)

Pour Mediawiki 1.7, il faut :

1. Renommer le dossier config en dossier configuration
2. Placer un fichier .htaccess avec la ligne : AddType x-mapp-php5 .php

1. 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

Si une erreur survient lors de l'installation :

Creating tables... using MySQL 4 table defs... Warning: fopen(../maintenance/tables.sql) [function.fopen]: failed to open stream: No such file or directory in /xxxxxxxx/htdocs/xxxxxxxxxx/includes/Database.php on line 1866

Notice: Undefined variable: fname in /xxxxxxxxx/htdocs/xxxxxxx/includes/Database.php on line 1868 Could not open "".

il suffit d'informer ces deux champs tout à la fin du formulaire : Superuser account: nom de l'utilisateur de la base de données (le même que renseigné plus haut) Superuser password: mot de passe de l'utilisateur de la base de données (le même que renseigné plus haut)

A partir de la version 1.7.3 Après avoir renommé le dossier configuration en config, il faut créer un nouveau dosser config vide, l'installation se déroulera alors sans problème.

[edit] Mediawiki 1.7.2 et Pack Premium

Ce pack permet une connexion ssh que nous allons utiliser. On a besoin de deux répertoires distincts chargement et installation (chargement ∩ installation = ø).

• Se connecter en ssh.
• Récupérer dans chargement, décompresser puis copier dans installation et faire le ménage dans chargement :

cd chargement
wget http://downloads.sourceforge.net/wikipedia/mediawiki-1.7.2.tar.gz?big_mirror=0 
tar -xvzf mediawiki-1.7.2.tar.gz
cd installation
mv chargement/mediawiki-1.7.2/* .
rm -Rf chargement/mediawiki-1.7.2*

• Modifier les sources dans installation :

mv config configuration
vi index.php
   :%s/config\//configuration\//g => 4 substitutions on 4 lines
   :wq
vi configuration/index.php
   :%s/\.\.\/maintenance/$conf->IP\/maintenance/g => 8 substitutions on 8 lines
   : wq
vi includes/Database.php 
   :1868s/$fname/$filename/
   :wq

• Spécifier l'utilisation de php5 :

echo "AddType x-mapp-php5 .php" >> .htaccess

• Lancer le navigateur, entrer l'URL du wiki.
• Suivre la procédure d'installation standard en tenant compte du fait que le LocalSettings.php est créé directement dans le répertoire d'installation, inutile de chercher à le déplacer.
• Le wiki est installé.

Des détails et un script sont disponibles sur http://linformalibre.f2lt.fr.

[edit] Voir Aussi

• Discussion Wikipédia:Installation du logiciel MediaWiki

Langues: Български (bg) English (en) Français (fr) 日本語 (ja) 한국어 (ko) Русский (ru) Українська (uk) +/-