racine uZine

Dans la même rubrique
Installation
 
vendredi 1er juin 2001

Installer SPIP

par l’équipe de SPIP

L’installation de SPIP est très simple : il n’y a pas, en particulier, de fichier à modifier « à la main » avec des variables ésotériques. La procédure est très simple (elle est détaillée ci-après) :
- 1. Récupérer le fichier de SPIP sur notre serveur, et le décompacter sur votre ordinateur personnel. Vous obtenez un dossier « SPIP... » contenant l’ensemble des fichiers du système SPIP.
- 2. Installer le contenu de ce dossier sur votre site (par FTP, comme vous le faites habituellement pour installer vos pages sur votre site).
- 3. Vous connecter avec votre navigateur sur votre site, dans un dossier intitulé « ecrire », où SPIP vous proposera une interface graphique vous permettant de configurer le système. Une fois ces quelques informations de configuration fournies, SPIP sera totalement installé et vous pourrez commencer à travailler sur votre site.

image 400 x 400

Configuration nécessaire

Vous devez disposer d’un hébergement Web avec :

- un accès FTP pour l’installation des fichiers ;
- le support de PHP3 ;
- un accès à une base de données MySQL.

Avant l’installation, vous devez avoir une base mySQL disponible. Sur de
très nombreux hébergements, il faut soit demander l’activation d’une base
mySQL à l’administrateur, soit suivre une procédure automatique en ligne (dans tous les cas, l’activation de la base mySQL n’a rien à voir avec SPIP ; si vous avez des difficultés, seul votre hébergeur peut vous fournir les mots de passe nécessaire et vous expliquer comment activer votre compte mySQL).

Vous devez connaître les données de votre connexion MySQL (fournies par
l’hébergeur) :

- l’adresse de la base MySQL : par exemple sql.free.fr, ou localhost, ou
vide ;
- votre login MySQL : souvent le même login que votre compte Web ;
- votre password MySQL : souvent le même que le compte Web ;
lors de l’installation, une fois ces informations indiquées, il faudra aussi préciser :
- le nom de la base de données : souvent le même login que votre compte Web - il est possible que le serveur vous offre la possibilité de créer vous même cette base.

Exemple : si vous disposez d’un compte nommé « monsite » chez Free (adresse http://monsite.free.fr), l’adresse de la base mySQL est « sql.free.fr », le nom de la base de données est « monsite », votre login est « monsite » et le mot de passe est celui de votre compte. Il vous suffit d’activer votre base de données pour php

Ces éléments sont indispensables : si vous ne les connaissez pas, contactez
votre hébergeur et demandez-lui de vous les rappeler.

Aucune configuration spéciale n’est nécessaire sur votre ordinateur personnel, SPIP se gère entièrement sur le Web. Tout ce dont vous avez besoin, c’est d’un
navigateur Web (n’importe lequel), et d’un logiciel de transfert FTP pour
installer les fichiers sur votre compte.

Installation automatique (« spip_loader »)

Il existe pour SPIP une procédure d’installation ultra-simplifiée : un fichier à télécharger
sur votre serveur et ça s’installe. Attention : cette procédure ne fonctionne pas sur tous les serveurs. Si elle ne fonctionne pas (vous vous en rendrez compte immédiatement), passez à l’étape 1 ci-dessous.

Récupérez le fichier spip_loader.php3 à l’adresse ci-dessous (si le fichier
s’affiche dans votre navigateur, faites « Enregistrer sous... ») :
- http://rezo.net/spip-dev/INSTALL

et téléchargez-le tel quel sur votre serveur (chez votre hébergeur) par FTP. « Visitez » cette page avec votre butineur Web habituel (à l’adresse du style : http://www.moncompte.com/spip_loader.php3) et suivez la procédure indiquée.

Si la procédure fonctionne, ce petit fichier (7 Ko) va récupérer SPIP sur
notre propre serveur et l’installer chez votre hébergeur. Ensuite la
procédure de configuration démarre automatiquement (étape 3
ci-dessous).

1. Récupérer SPIP

SPIP est disponible en téléchargement par le Web à l’adresse :
- http://rezo.net/spip-dev/DISTRIB

Ce dossier contient plusieurs fichiers, vous devez récupérer celui qui correspond à votre propre système d’exploitation :
- spip.zip ou spip.tar.gz si vous tournez sous Windows ou Linux ;
- spip.sit si vous êtes sous Macintosh (vous avez alors besoin de Stuffit
Expander
pour décompacter).

Décompactez l’archive sur votre ordinateur dans le répertoire de votre choix, puis installez les fichiers chez votre hébergeur via FTP.

2. Installer les fichiers

Installez l’ensemble des fichiers de SPIP sur votre site, à l’endroit où
vous voulez que le site géré par le script soit accessible au public : le
plus souvent à la racine de votre site, mais ce n’est pas impératif.

La structure est la suivante :

  • répertoire racine
    • squelettes .html
    • nombreux fichiers .php3
    • dossier /CACHE (vide)
    • dossier /IMG (vide)
    • dossier /NAVPICS
    • dossier /ecrire (le plus important)
      • nombreux fichiers .php3
      • dossier /AIDE
      • dossier /IMG2
      • dossier /data (vide)

3. Procédure de configuration

Désormais tout se déroule en ligne. Il vous
suffit d’aller « visiter » votre dossier « /ecrire » par le Web.

Exemple : selon notre exemple précédent, il s’agirait de l’adresse http://monsite.free.fr/ecrire.
image 317 x 280

Lors de la première connection à cette adresse, une procédure d’installation
pas-à-pas démarre. L’interface est très simple, il suffit d’entrer les
informations demandées (essentiellement les informations concernant la base de données mySQL indiquées au début). Une fois que c’est terminé, le système vous demande l’identification que vous avez indiquée et vous pouvez commencer à gérer votre site. Par la suite, c’est toujours dans ce dossier « /ecrire » que vous irez travailler, muni de vos codes d’identification.

image 400 x 341

À chaque étape de la procédure d’installation, vous trouverez un lien [AIDE], qui
provoque l’affichage d’une aide en ligne expliquant chaque détail de l’utilisation de SPIP.
(La seule opération un peu complexe apparaît sur certains serveurs : il vous
faudra peut-être modifier les « droits d’accès » de certains dossiers ;
l’opération n’est pas bien méchante, et l’aide en ligne vous fournit
tous les détails nécessaires.)

Si tout s’est bien déroulé jusqu’ici, la procédure d’installation est terminée, et vous pouvez créer et gérer votre site sans aucune autre manipulation ésotérique...

En cas de grosse erreur (du genre : vous avez oublié votre propre accès au site - fréquent au début...), pour « relancer » cette procédure d’installation, il faut utiliser votre logiciel FTP et effacer les fichiers suivants :

- /ecrire/inc-connect.php3
- /ecrire/.htaccess (s’il existe)

La connexion suivante dans le dossier « ecrire » relancera alors la procédure de configuration (en réalité, c’est l’absence de fichier « inc-connect.php3 » qui provoque le lancement de cette procédure).

Votre témoignage

Afin de nous aider à améliorer cette procédure d’installation, merci de faire part de votre expérience dans le forum ci-dessous ou en écrivant à spip@rezo.net. Si vous effectuez l’installation vous-même, veuillez indiquer :

- le nom de votre hébergeur (important, ça, qu’on ait une idée des
différents hébergeurs compatibles, notamment les gratuits) ;

- les éventuelles difficultés rencontrées (y compris les difficultés
d’interface et de compréhension du processus d’intallation, histoire qu’on puisse améliorer l’interface ou la documentation) ;

- même si votre installation s’est déroulée sans aucune difficulté, merci de
l’indiquer (c’est une info intéressante).

 
 
l’équipe de SPIP
Imprimer
format impression
l’équipe de SPIP
16 mai 2001
14 mai 2001
3 mai 2001
 
SPIP
Web indépendant