Cette article est la première mouture d’une contribution publiée sur "Spikini". Si vous souhaitez le modifier, où voir les mises à jour, rendez vous à cette adresse

Introduction

Installer SPIP sur votre machine pour travailler en local peut ne pas être simple, selon votre culture, votre système d’exploitation (MacOS, Window, Linux...) et aussi votre configuration. Le but de cet article est de vous indiquer quelques repères et points clé pour frayer le chemin juqu’à la page d’accueil.

Pourquoi ?

 Parce que ça va faciliter votre vie de Webmestre et rendre votre site plus stable.
 cela évite de fausser vos statistiques de visites.

De quoi a-t-on besoin ?

 une base de donnée (mySQL)
 un serveur Web (Apache)
 PHP

Tout ceci ne va pas de soi, surtout pour Linux. Par exemple sur Knoppix, tout est déjà installé (ouf) sauf que rien n’est démarré. Sur une Mandrake, SQL n’est pas installé par défaut.

Sous MacOS, la situation est un peu comme sous Linux puisque le noyau de MacOS est un Unix, mais il y a beaucoup moins de variété ce qui simplifie la vie. Reportez vous à cette contribution qui traite des particularités de MacOS. Installer spip sur Mac OS X

Le cas le plus simple est Windows. Rien n’est installé, mais procurez vous EasyPHP, qui est gratuit, à cette addresse http://www.easyphp.org et vous aurez alors tout ce qu’il vous faut pour travailler (logiciels et documentation). De plus, il existe une contribution très détaillée à ce sujet sur SPIP-contrib : "Utiliser SPIP en local avec EasyPHP

Ce qui suit s’adresse donc plutôt aux utilisateurs Linux ou Unix, même si certaines choses restent valables pour tous les OS. A noter cet article pour installer avec Mandrake 10.0

Hypothèse

Vous avez tenté une installation locale de SPIP et quelque chose ne marche pas... Ou alors, vous avez quelques questions avant de vous lancer.

Vérifier les services

Une méthode de vérification du serveur Apache se fait via le navigateur avec l’URL de Loopback : http://127.0.0.1 (ou encore http://localhost) qui est toujours celle de votre machine en mode Local. Si Apache est là, il vous servira une page (même la page d’erreur 404 est une page servie).

Sous Shell, vous avez cette possibilité :

ou encore (RH et Mandrake)

Une méthode de vérification plus efficace pour mySQL est de tenter la création de votre base de donnée sous root (si vous avez le package client de MySQL) :

En supposant que test soit le nom que vous voulez donner à votre base. (vous pourrez toujours faire suivre par mysqladmin drop test).

Vérifier les packages

Il faut ces packages (à contrôler sous Kpackage avec KDE) :

Mandrake 9.0	Knoppix 3.4 (Debian)
MySQL	MySQL-server
php-mysql	php4-mysql
php	php4
mod_php
php-common
apache	apache
apache-common	apache-common
apache-modules

La récupération de package manquant sort largement du cadre de cette contribution. Il vous faut utiliser l’outil (voire les outils) qui est propre à votre distribution Linux pour installer le package récupéré sur Internet ou votre CD.

Démarrer les serveurs

Il y a 2 serveurs à démarrer. Soit vous les lancez directement à la main :

soit vous les faites lancer au démarrage. Dans ce dernier cas, le plus simple est de passer par l’outil graphique que vous propose très probablement votre distribution (Sous Knoppix, on peut utiliser l’éditeur d’Init Système V). Personellement j’utilise ces commandes sous RH et Mandrake :

Et, encore mieux, pour lancer au démarrage de Linux :

ou encore :

Après quoi on est débarassé de la corvée de démarrage :-)

mySQL	Knoppix	Mandrake 9.0
à la demande	# mysqld&	#service mysql start
permanent		# /sbin/chkconfig —add mysql
		ou # /sbin/chkconfig —level 123456 mysql on

Installer SPIP

 le répertoire d’installation de SPIP, appelons le ’spip’, doit s’installer sous le répertoire racine d’Apache. Celui-ci est défini dans un fichier de configuration httpd.conf (sous /etc/httpd/conf). C’est souvent "DocumentRoot /var/www" ou "DocumentRoot /var/www/html".

 vous devrez changer les droits des répertoires et fichiers de l’aborescence SPIP (chmod 777 spip, chmod 777 spip/* etc)

Vous pouvez alors appliquer la procédure d’installation officielle de SPIP avec votre navigateur en notant bien que les champs à remplir dans le premier formulaire sont les suivants :

"localhost", "root" et laisser vide le dernier champs.

Si vous tombez sur une fonction non définie (connect_sql ou quelque chose d’approchant) c’est que le module php-mysql n’a pas été installé. Vous repartez dans la recherche de package.