MediaWiki pour débutants/Installer MediaWiki

Un livre de Wikilivres.
Aller à : navigation, rechercher
Introduction Installer Utiliser Naviguer Configurer Extensions Fonctions Maintenance Sécuriser Ressources


Étapes du processus de production d'un wiki avec MediaWiki

Cette page décrit la procédure d'installation de MediaWiki. Il est bon cependant de se poser quelques questions avant de commencer.

Pourquoi utiliser MediaWiki ?[modifier | modifier le wikicode]

MediaWiki est-il le mieux adapté à vos projets ?

Quelle sera l'utilité de votre wiki : qu'allez-vous en faire ? Voulez-vous en faire un usage personnel sur votre ordinateur seulement, ou s'agit-il de créer un wiki sur internet ? Sous quelle licence les modifications de votre wiki seront-elles placées ? Tous les internautes pourront-ils modifier votre wiki, ou seulement les personnes inscrites ?

Comment installer Mediawiki ?[modifier | modifier le wikicode]

Nous allons commencer par apprendre à installer MediaWiki sur un ordinateur (installation locale). Outre l'usage personnel que vous pourrez en faire, ou l'utilisation intranet, cette installation vous permet d'apprendre à vous servir de MediaWiki : vous pouvez ainsi faire des tests sans risquer de perdre vos données. Même si vous installez un wiki chez un hébergeur, il peut être utile d'essayer des manipulations sur une installation locale, avant de les faire sur votre site.

MediaWiki peut être téléchargé sur http://www.mediawiki.org/wiki/Download puis installé sur un ordinateur, par exemple pour un usage personnel, sans être connecté à l'Internet. Vous pouvez donc disposer d'un site comme Wikibooks, mais pour votre travail, pour recopier du contenu de Wikibooks, etc. Cela nécessite d'utiliser Apache.

Apache pour Windows[modifier | modifier le wikicode]

Tout-en-un[modifier le wikicode]

Des logiciels tout-en-un (serveur Web, base de donnée MySQL, et PHP) permettent de s'affranchir d'une installation fastidieuse et rédhibitoire pour le débutant :

  1. EasyPHPtéléchargement : n'a pas vocation à être installé pour de la production, mais pour le développement. Il stocke les bases de données dans C:\Program Files (x86)\EasyPHP\binaries\mysql\data.
  2. WAMPtéléchargement : est du même type qu'EasyPHP : ce logiciel installe facilement un serveur Web Apache, une base de données MySQL et PHP 4 et 5. Il a l'avantage de permettre de passer facilement de PHP 4 à PHP 5, sans avoir à refaire une installation ou une compilation. Tout comme EasyPHP, c'est un environnement de développement, et non un environnement de production. Attention : la résolution des noms d'hôtes se réalise séparément. Les installations WAMP servent à tester en local sur votre PC. Dans la plupart des cas, il suffit d'utiliser le fichier Hosts local, comme on le ferait sur une machine Linux, afin de lier des noms aux adresses IP. Dans Windows XP, Vista et 7, ce fichier se trouve dans le répertoire systemroot\System32\Drivers\Etc. Il peut se faire que le service ait déjà été configuré. Lorsque vous vous en doutez, contactez votre administrateur réseau. Remarque : vous trouverez une liste des possibilités de résolution de noms avec MS Windows sur Microsoft.com.
  3. XAMPPtéléchargement : est du même type qu'EasyPHP ou WAMP, le deuxième P étant pour Perl. Son usage est recommandé avec PHPEclipse, et il fournit aussi un serveur Apache Tomcat par défaut.
  4. The Uniform Servertéléchargement : en anglais seulement avec Apache2, Perl5, PHP5, MySQL5, phpMyAdmin.
link={{{link}}}Attention !

Sur Windows 10 pro, le serveur IIS est installé par défaut, et oblige Apache à changer de port (888 au lieu de 80) lors de l'installation. Pour résoudre cela il suffit de décocher Internet Information Services dans Programmes et fonctionnalités, Activer ou désactiver des fonctionnalités Windows.

De même, le port MySQL est susceptible de passer de 3306 à 3388.

link={{{link}}}Attention !

Sur Windows 10, EasyPHP development server (alias Devserver, la version rouge) ne fonctionne pas (il manque MSVCR110.dll), mais EasyPHP hosting server (alias Webserver, la bleue) tourne normalement. Or, elle se lance automatiquement à chaque démarrage, ce qui le ralentit significativement. Pour éviter cela, exécuter services.msc, puis passer les trois services ci-dessous en démarrage manuel. Ensuite pour les lancer à souhait (en tant qu'administrateur), créer un script MySQL.cmd contenant les lignes suivantes :

net start ews-dbserver
net start ews-httpserver
net start ews-dashboard
pause
net stop ews-dashboard
net stop ews-httpserver
net stop ews-dbserver

Message d'erreur relatif à SSL[modifier le wikicode]

Pour l'instant, WAMP ne supporte pas encore le Secure Socket Layer (SSL). L'installation se finit par un message qui vous informe de ce fait. Afin de pouvoir travailler sans problèmes, éditez le fichier c:\windows\php.ini. Cherchez dans ce fichier la ligne qui commence avec extension=php_openssl.dll. Commentez cette ligne en la faisant précéder d'un point-virgule :

;extensions=php_openssl.dll

Si tout se passe bien, vous pouvez ouvrir la page de test dans votre navigateur.

Installation manuelle[modifier le wikicode]

Installer Apache[modifier le wikicode]

Pour installer Apache, double-cliquez sur le fichier exécutable, et suivez les instructions d'installation automatique.

Si vous installez Apache sur un ordinateur de développement, renseignez le champ "nom de domaine" avec la valeur localhost.

Si vous installez un serveur de production et que vous disposez d'un nom de domaine, vous devriez disposer des informations nécessaires concernant votre nom de domaine, fournies par le registrar.

Une fois l'installation terminée, il faut encore indiquer à Apache qu'il doit fonctionner conjointement avec PHP, car il ne sait pas les traiter par défaut. Pour cela, il faut modifier les informations de configuration d'Apache, contenues dans le fichier httpd.conf, qui se trouve dans le dossier d'installation d'Apache, dans le sous-dossier conf.

Installer PHP[modifier le wikicode]

Une fois l'archive téléchargée, décompressez-la à la racine de votre disque dur et renommez le dossier en 'PHP'. Dans le dossier PHP, vous trouverez deux fichiers: php.ini-dist et php.ini-recommended. Copiez php.ini-recommended dans votre dossier C:\Windows ou C:\winnt (le nom du dossier dépend de la version de votre système.
renommez-le en php.ini.

Ce fichier est le fichier de configuration qui contrôle les options dont vous disposerez.

MySQL[modifier le wikicode]

Télécharger et installer le .msi sur http://dev.mysql.com/downloads/gui-tools/5.0.html.

Pour arrêter, démarrer, démarrer automatiquement le serveur MySQL vous devez aller dans la gestion des services (Démarrer/Exécuter/services.msc).


Apache pour Linux[modifier | modifier le wikicode]

LAMP[modifier le wikicode]

Logiciel tout-en-un pour Linux (Apache + MySQL + PHP), comme WAMP pour Windows.

commande nécessitant les privilèges root

# tasksel install lamp-server

Installation manuelle[modifier le wikicode]

Apache sur Debian / Ubuntu[modifier le wikicode]

commande nécessitant les privilèges root

# apt-get install apache2

Le service peut ne pas être lancé par défaut, mais même s'il l'est on peut quand-même essayer de l'activer avec :

commande nécessitant les privilèges root

# /etc/init.d/apache2 start

On peut ensuite tester le serveur, pour voir si une page s'affiche ou s'il refuse la connexion :

commande

$ lynx http://localhost/

Cette adresse est la boucle locale, elle peut aussi être rentrée directement dans tout navigateur web.

Si Apache était déjà installé vérifier le fichier pour indiquer le démarrage automatique d'Apache 2 /etc/default/apache2 :

 # vi /etc/default/apache2
 ...
 NO_START=0
PHP5[modifier le wikicode]

PHP peut-être installé avec toutes les déclinaisons de la distribution Debian (stable, testing, unstable). Il suffit pour cela d'insérer vos lignes préférées dans le fichier /etc/apt/sources.list :

deb http://ftp.fr.debian.org/debian/ stable main non-free contrib
deb-src http://ftp.fr.debian.org/debian/ stable main non-free contrib

Ce qui suit suppose que vous ayez déjà installé votre serveur WEB (cf manuels pour l'installation d’Apache sous Debian). Par la suite, exécutez en tant que "root" les commandes suivantes :

apt-get update && apt-get install php5

Une fois ces commandes exécutées, vous devez redémarrer votre serveur WEB. Dans le cas d'Apache cela s'effectue avec la commande suivante :

/etc/init.d/apache restart

Si tout s'est bien passé, vous disposez maintenant d'un serveur WEB qui a la capacité d'exécuter des scripts PHP version 5 dans votre navigateur.

PHP4[modifier le wikicode]
commande nécessitant les privilèges root

# apt-get install php4

Et ensuite le module PHP pour apache

commande nécessitant les privilèges root

# apt-get install libapache2-mod-php4

Redémarrer apache

commande nécessitant les privilèges root

# /etc/init.d/apache2 restart

Créons un fichier contenant un script php minimal qui nous permettra de faire un test

commande

$ echo "<?php phpinfo(); ?>" > /var/www/test.php

Testons :

commande

$ lynx http://localhost/test.php

Pour débugger, il suffit de lire le error.log.

Apache sur Gentoo[modifier le wikicode]

Premièrement il faut installer Apache si ce n'est pas déjà fait :

emerge apache

Ensuite, il faut installer PHP :

emerge dev-lang/php

Puis il faut qu'apache utilise PHP dans sa configuration.

Code: Configuration de apache
# nano -w /etc/conf.d/apache2
APACHE2_OPTS="-D PHP5"

MySQL seul[modifier le wikicode]

MySQL est disponible sur http://dev.mysql.com/downloads/gui-tools/5.0.html au format :

  1. .msi (Windows)
  2. .dmg (Mac)
  3. .rpm (Linux)
  4. .tar

En l'absence de gestionnaire de paquets, utiliser le .tar ainsi :

shell> groupadd mysql
shell> useradd -r -g mysql mysql
shell> cd /usr/local
shell> tar zxvf /path/to/mysql-VERSION-OS.tar.gz
shell> ln -s full-path-to-mysql-VERSION-OS mysql
shell> cd mysql
shell> chown -R mysql .
shell> chgrp -R mysql .
shell> scripts/mysql_install_db --user=mysql
shell> chown -R root .
shell> chown -R mysql data
shell> bin/mysqld_safe --user=mysql &

APT[modifier le wikicode]

# apt-get install mysql-server mysql_secure_installation

Puis, modifier PHP pour qu'il supporte MySQL :

# apt-get install php4-mysql

Sur Gentoo[modifier le wikicode]

 emerge mysql


Installer PhpMyAdmin[modifier le wikicode]

Depuis un tout-en-un :

sudo ln -s /usr/share/phpmyadmin /var/www/phpmyadmin

Sinon :

sudo apt-get install phpmyadmin php5

Extensions[modifier le wikicode]

Pour activer des modules complémentaires :

a2enmod Nom_du_module # passe dans /etc/apache2/mods-enabled/

Pour les désactiver :

a2dismod Nom_du_module # passe dans /etc/apache2/mods-available/

Pour activer des sites :

a2ensite Nom_du_site # passe dans /etc/apache2/sites-enabled/

Pour les désactiver :

a2dissite Nom_du_site # passe dans /etc/apache2/sites-available/

Lancement du site[modifier | modifier le wikicode]

Il faut décompresser deux fois le fichier mediawiki. Pour cela, vous pouvez utiliser 7-zip : http://www.7-zip.org/

Placer le dossier Mediawiki obtenu dans le répertoire du serveur Web installé (ex : C:\Wamp\www, C:\Program Files (x86)\EasyPHP-5.3.6.0\www, /var/www ou ou /home).

Vous pouvez renommer le dossier mediawiki, par exemple : wiki (ou n'importe quel nom).

Lancer un navigateur (ex : Firefox, Google Chrome ou Internet Explorer).

Taper l'adresse : http://localhost/mediawiki-X.X/ (X étant le numéro de version du dossier MediaWiki), ou http://localhost/wiki par exemple, si vous avez renommé le dossier.

Suivre le processus d'installation :

  1. définir une licence : ceci doit être fait impérativement en premier, mais vous pouvez aussi ne pas la définir et il sera possible de l'ajouter par la suite (bien que ce ne soit pas le plus pratique).
  2. donner un nom à votre wiki : ce nom sera utilisé par le programme, par exemple pour l'espace méta de votre wiki. Il ne doit pas contenir certains caractères (pas d'accent).
  3. choisir un pseudo et un mot de passe ;
  4. Dans PhpMyAdmin (que vous trouverez sous Windows en cliquant gauche sur l’icône Wampserver, ou bien dans Administration de EasyPHP) créez une base de données nommée wikidb (c'est le nom par défaut proposé par MediaWiki, mais vous pouvez le changer).
  5. Créez un utilisateur avec mot de passe, en cliquant sur Privileges, Add a New User, toujours dans PhpMyAdmin, en donnant tous les droits à cet utilisateur et en choisissant Local comme Host.
  6. Revenez dans la page d'installation, et entrez le nom de base, le nom de l'utilisateur et le mot de passe créés dans PhpMyAdmin.
  7. Lancez l'installation en cliquant sur Install.

Une fois l'installation terminée, cliquez sur le lien qui s'affiche en bas à droite ; puis déplacez le fichier LocalSettings.php qui se trouve dans le dossier mediawiki-X.X/Config vers le dossier supérieur : mediawiki-X.X.

Revenir au navigateur et cliquer sur OK dans la barre de navigation : le wiki apparaît.

Installation chez un hébergeur[modifier | modifier le wikicode]

La première chose est d'avoir un compte chez un hébergeur. À partir de là, il vous faut uniquement MediaWiki (voir ci-dessus pour le télécharger et le décompresser), que vous devrez copier dans la racine avec par exemple FileZilla. Si vous ne savez pas ce qu'est un hébergeur ou n'en avez pas encore : reportez-vous à la page héberger un site.

Attention : les dernières versions de MediaWiki nécessitent PHP5. Certains hébergeurs ne permettent pas l'utilisation par défaut de cette version. Pour 1et1 par exemple, il faut créer un fichier .htaccess contenant :

AddType x-mapp-php5 .php
AddHandler x-mapp-php5 .php

Comment copier le contenu du dossier Mediawiki chez votre hébergeur ?

FileZ.jpg

Après avoir installé FileZilla et l'avoir lancé, vous devez remplir les cases :

  • Hôte
  • Nom d'utilisateur
  • Mot de passe

Toutes ces données vous sont fournies par votre hébergeur lors de votre inscription.

Cliquer ensuite sur Connexion rapide. Quand la connexion est établie, aller dans la boîte de gauche, et chercher votre dossier MediaWiki que vous avez enregistré sur votre disque dur :

FileZa.jpg


Sélectionner tout le contenu du dossier MediaWiki, puis faite un clic droit et sélectionner Envoyer. Les fichiers et les dossiers sont alors copiées chez votre hébergeur.

Rendez-vous maintenant sur la page Web de votre site ; le logo de MediaWiki doit apparaître, et le reste de l'installation est identique à ce qui a été expliqué ci-dessus.

Installation avec une base de données déjà existante[modifier | modifier le wikicode]

Il faut dans ce cas connaître l'adresse de l'hôte de votre base de données, le nom de celle-ci, avoir un nom d'utilisateur avec des privilèges d'accès et le mot de passe de cet utilisateur. Toutes ces données sont simplement à fournir dans la page d'installation de MediaWiki.

Pour aller plus loin[modifier | modifier le wikicode]