Installation du CMS TYPO3 4.0 sur un hébergement mutualisé

Date de publication : 02/07/2006 , Date de mise à jour : 02/06/2006

Par Olivier Van Hoof (ovh) (Mes autres articles)

Cet article décrit l'installation du CMS open source TYPO3 sur un hébergement mutualisé PHP/MySQL. Nous prendrons l'exemple d'un hébergement chez OVH, mais les manipulations sont semblables chez d'autres hébergeurs.

1. Introduction
2. Installation des fichiers dans l'espace web
3. Configuration pré-installation
4. Les étapes de l'installation
4.1. Configuration de base
4.1.1. Les répertoires
4.1.2. L'environnement graphique
4.1.3. La base de données
4.2. Initialisation de la base de données
4.3. Configuration des compatibilités de version
5. Test de l'installation
6. Conclusion

1. Introduction

Avant de commencer, rappelons brièvement ce qu'est TYPO3. Il s'agit d'un CMS (Content Management System ou système de gestion de contenu), c'est-à-dire une application écrite ici en PHP/MySQL qui permet de concevoir un site web de A à Z via une interface graphique hébergée sur le serveur. Le système permet de placer tout type de contenu sur les pages web, d'y associer des templates de mise en page, gérer l'aspect multi-lingue, la publication des pages, optimiser le site par un système de cache, etc. Extensible à l'infini via un système de plug-ins, TYPO3 permet également de greffer des fonctionnalités complexes comme l'intégration de divers systèmes de vente en ligne, par exemple.

La difficulté d'installer un outil comme TYPO3, en particulier sur un hébergement mutualisé où par définition on n'a que peu de possibilités de configuration, tient en plusieurs éléments :

L'application doit écrire elle-même des fichiers bruts sur le serveur, et non seulement dans la base de données. Ces fichiers sont les gabarits des pages, les fichiers de cache, etc. ll faut donc donner la permission au serveur web d'écrire en certains endroits, ce qui est souvent désactivé par défaut pour des raisons évidentes de sécurité. C'est de loin le problème principal.
TYPO3 nécessite la présence d'autres briques logicielles pour fonctionner, et la compatibilité avec les différentes versions de ces outils est variable... Il faut donc trouver un hébergeur qui possède les outils nécessaires et dans des versions acceptées par le CMS.
L'étendue immense des fonctionalités de TYPO3 en fait un logiciel assez complexe, et l'installation n'est pas spécialement intuitive.

Pourquoi avoir choisi l'hébergeur OVH ? Tout simplement parce que je disposais déjà d'un hébergement mutualisé chez eux, l'offre "60gp", l'abonnement de base qui est, comme nous le verrons, tout à fait satisfaisant pour ce type d'application.

2. Installation des fichiers dans l'espace web

Les fichiers d'installation sont disponibles en 2 versions, selon que vous disposez ou non d'un serveur web. Ici nous avons bien entendu un serveur web, nous prendrons donc les packages correspondants, disponibles sur le site web de TYPO3.

TYPO3 se décompose en 2 parties :

le coeur du programme, commun à tout le système : package typo3_src-4.0 (pour la version 4.0)
un dossier vierge initial pour chaque site web : package dummy-4.0

Deux formats d'archives sont disponibles : zip et tar.gz. La version .tar.gz est l'idéale car elle contient des liens symboliques vers les sources, pour éviter de dupliquer des fichiers. Mais ces liens symboliques n'étant pas supportés par tous les hébergeurs, ou impossible à transférer online, TYPO3 propose aussi un format zip qui contient tous les fichiers, sans liens.

On trouve souvent comme conseil sur internet de travailler avec la version zip dans le cas d'un hébergement mutualisé, mais nous allons quand même opter pour la version .tar.gz, ce qui sera beaucoup plus efficace. ;)
Le problème des packages se situe au niveau de la décompression. Comme on ne dispose pas d'un accès shell sur la plupart des hébergements mutualisés, il est impossible de lancer une commande pour décompresser les fichiers une fois uploadés ! Heureusement chez OVH les fonctions exec() sont activées en PHP, et nous allons nous en servir pour faire décompresser les fichiers directement par le serveur. Nous pourrions bien sûr décompresser les archives en local sur un poste de travail et uploader le tout par après, mais cela prend un temps fou car il faut envoyer des milliers de petits fichiers par FTP, tandis qu'envoyer une grosse archive va beaucoup plus vite.

Il suffit donc d'uploader un mini-fichier PHP avec le code suivant, en plus des 2 archives .tar.gz :

Source PHP pour décompresser les archives TYPO3

<?
system("tar -xzvf typo3_src-4.0.tar.gz");
system("tar -xzvf dummy-4.0.tar.gz");
?>

Connectez-vous sur votre site http://www.monsite.fr/unzip.php et vous verrez la liste de tous les fichiers décompressés s'afficher (comptez tout de même quelques dizaines de seconde de délai, car l'archive est lourde à traiter). Une fois terminé, connectez-vous sur votre espace en FTP et vous verrez 2 répertoires : typo3_src-4.0 et dummy-4.0. Renommez ce dernier comme bon vous semble, ou déplacez son contenu à la racine de votre hébergement (répertoire "www" ou "public_html") si vous ne voulez qu'un seul site. Ceci fait, vous pouvez accéder aux URL suivantes :

http://www.monsite.fr/typo3/install/ (ou http://www.monsite.fr/siteN/typo3/install/) : interface d'installation
http://www.monsite.fr/typo3/ (ou http://www.monsite.fr/siteN/typo3/install/): interface d'administration

3. Configuration pré-installation

In the source distribution of TYPO3, the install script is disabled by a die() function call.
Fix: Open the file typo3/install/index.php and remove/out-comment the line that outputs this message!

typo3/install/index.php

// This checks for my own IP at home. You can just remove the if-statement.
if (1==0 || (substr($_SERVER['REMOTE_ADDR'],0,7)!='192.168' && $_SERVER['REMOTE_ADDR']!='127.0.0.1'))	{
	die("In the source distribution of TYPO3, the install script is disabled by a die() function call.<br/>
	<b>Fix:</b> Open the file typo3/install/index.php and remove/out-comment the line that outputs this message!");
}

4. Les étapes de l'installation

4.1. Configuration de base

4.1.1. Les répertoires

4.1.2. L'environnement graphique

4.1.3. La base de données

4.2. Initialisation de la base de données

4.3. Configuration des compatibilités de version

5. Test de l'installation

6. Conclusion

(...)

Copyright (c) 2006 Olivier Van Hoof. Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.2 or any later version published by the Free Software Foundation; with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. Read the full license here : http://www.gnu.org/licenses/fdl.txt