Installer SPIP

Configuration nécessaire

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 accès FTP pour installer les fichiers sur votre espace d’hébergement, que ce soit via une interface en ligne ou avec un logiciel de transfert FTP installé sur votre ordinateur [1].

Pour installer un site SPIP, il vous faudra un espace d’hébergement web ordinaire pourvu d’une base de données MySQL et capable d’exécuter du PHP. Mais soyez rassuré-e : aucune connaissance de PHP ou de MySQL n’est nécessaire pour administrer un site SPIP ! Il vous faudra juste vérifier que votre hébergeur le propose. Voir : « Hébergeurs acceptant SPIP ».

Munissez-vous de vos accès, identifiants et mots de passe FTP et MySQL. Ces éléments sont indispensables : si vous ne les connaissez pas, contactez votre hébergeur et demandez-lui de vous les rappeler.

Avant l’installation de SPIP, vous devez aussi 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

Installation automatique (« spip_loader »)

La procédure la plus facile et la plus rapide est l’installation automatique avec « spip_loader ». Ce petit fichier va télécharger SPIP et l’installer lui-même chez votre hébergeur. Attention : cette procédure ne fonctionne pas sur tous les serveurs. Si elle ne fonctionne pas (vous vous en rendrez compte immédiatement), passez directement à l’autre méthode.

1. Récupérez le fichier spip_loader.php (ou copiez juste son contenu),
2. Déposez ce fichier dans votre espace d’hébergement (par FTP ou par tout autre moyen que vous propose votre hébergeur).
3. Visitez votre site avec votre navigateur habituel et affichez-y le fichier que vous venez de déposer, en vous rendant à l’adresse du style : http://www.monsite.fr/spip_loader.php et suivez les indications.

Installation manuelle

Selon la configuration de votre hébergement, il peut arriver que l’installation automatique ne soit pas possible. Il vous faudra alors procéder à une installation manuelle, qui est à peine plus compliquée.

1. Récupérez le fichier de SPIP et décompactez-le sur votre ordinateur personnel. Vous obtenez un dossier « SPIP... » contenant l’ensemble des fichiers du système SPIP.
2. Placez le contenu de ce dossier (tous les fichiers et les sous-répertoires) sur votre site (par FTP ou par tout autre moyen que vous propose votre hébergeur), à l’endroit où vous voulez que le site géré par le système soit accessible au public : le plus souvent à la racine de votre site, mais ce n’est pas impératif.
3. Connectez-vous 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.

Terminer l’installation

Désormais tout se déroule en ligne. Il vous suffit d’aller « visiter » votre dossier « /ecrire » par le Web, à l’adresse du type : http://www.monsite.fr/ecrire.

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.

À chaque étape de la procédure d’installation, vous trouverez un lien vers l’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 :

• /config/connect.php
  (ou /ecrire/inc-connect.php ou php3 dans d’anciennes versions)
• .htacces, s’il existe
  (ou /ecrire/.htaccess dans d’anciennes versions)

La connexion suivante dans le dossier « ecrire » relancera alors la procédure de configuration (en réalité, c’est l’absence de fichier « connect.php » 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 « installation », ou en écrivant à spip@rezo.net (attention : dans les deux cas vos réponses seront publiées sur notre site, soit sur le forum, soit dans les archives de notre liste de discussion). 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).