DOCUMENTATION POUR L'INSTALLATION DE TYPO3 ajoly@e-magineurs.com Ingénieur en développement 45 rue du Vivier 69007 Lyon Tel : 04 37 37 88 00 www.e-magineurs.com Donnez de l e-magination à votre communication multimédia! E-magineurs Page 1 19/01/2007
Sommaire 1. INTRODUCTION... 3 2. LES PRES-REQUIS... 3 2.1 Outils et Librairies nécessaires du côté serveur...3 2.2 Outil utilisateur...4 3. ACCES SERVEUR... 4 4. CONFIGURATION... 5 4.1 PHP...5 4.2 Librairies graphiques...5 4.3 Autres librairies...5 5. PRESENTATION DE TYPO3... 6 5.1 Les fichiers sources...6 5.2 L arborescence de TYPO3...6 5.2 Installation...6 E-magineurs Page 2 19/01/2007
1. INTRODUCTION Ce document a pour but de présenter la mise en place et la configuration des outils nécessaires au bon fonctionnement de TYPO3, gestionnaire de contenu de sites Internet. (Site officiel : http://www.typo3.org) 2. LES PRES-REQUIS 2.1 Outils et Librairies nécessaires du côté serveur Pour TYPO3 version 4.0 nous préconisons les choix suivants : - Configuration matérielle : Processeur Intel P4 3.06 GHz 80 Go disque dur IDE 1024 Mo SDRAM DDR 100 Mps Carte ethernet Bande passante : 30 Mps Trafic illimité Monitoring 24h/24 7j/7 Reboot à distance du serveur 24h/24 7j/7 Intervention humaine 24h/24 7j/7 Système «rescue» Back up hebdomadaire Option sécurité totale - Au niveau logiciel, il faut tout d'abord un Web Serveur, qui est une application qui va répondre aux requêtes d'un navigateur (Internet Explorer, Firefox...). Pour Typo3, c'est Apache qui est utilisé en version 1.3.x ou supérieure. (Note : Microsoft IIS peut être également utilisé mais l est moins). TYPO3 utilise une base de données MySQL ainsi que PHP pour accéder à cette base de données, exécuter les scripts, effectuer des opérations classiques comme l envoie d e-mail, la gestion des fichiers MySQL et PHP peuvent tourner sur n importe quelle plateforme (Unix ex : Linux, Windows, Mac ). TYPO3 requiert une version 4.3.x ou supérieure de PHP (la version 5.x reste à éviter pour le moment) et une version 3.23.x ou supérieure de MySQL. Notre configuration habituelle de ces différents outils est Apache 1.3.34, PHP 4.4.2, MySQL 3.23.49 sur une plateforme de type Linux. Voici les liens vers les sites officiels où l on peut télécharger ces outils : Apache : http://httpd.apache.org/download.cgi MySQL : http://dev.mysql.com/downloads/ PHP : http://www.php.net/downloads.php E-magineurs Page 3 19/01/2007
- Il est conseillé d installer des bibliothèques graphiques comme Gdlib, Freetype et Image Magick qui permettent une gestion avancée de l affichage et des manipulations graphiques. Gdlib permet la génération d image au format GIF, PNG et JPEG depuis PHP. Freetype permet d inclure du texte dans les images. Image Magick permet l édition d images notamment en ligne de commande. Les versions recommandées de ces bibliothèques graphiques pour Linux sont disponibles ici : Gdlib : http://www.boutell.com/gd/http/gd-2.0.33.tar.gz Freetype : http://sourceforge.net/project/showfiles.php?group_id=3157 (en version 2.1.10) Image Magick : http://typo3.sunsite.dk/software/linux/imagemagick-4.2.9_i386-static-3.tar.gz - Pour extraire des informations de fichiers.doc,.xls,.ppt, la librairie catdoc est nécessaire. Elle se trouve à l adresse suivante : http://www.45.free.net/~vitus/software/catdoc/ en version 0.94.2. - Pour lire les fichiers.pdf notamment pour l indexation des fichiers pour une recherche sur le site, la librairie Xpdf doit être installée. Xpdf est disponible ici : http://www.foolabs.com/xpdf/download.html en version 3.01. - Un site sous TYPO3 ne nécessite pas d avoir un serveur dédié mais est fortement conseillé pour les problèmes de configuration. Si vous possédez un serveur qui a d autre usage, TYPO3 pourra en toute logique tourner dessus. Le choix d un serveur mutualisé (partagé avec d autres utilisateurs) est donc envisageable si les conditions nécessaires au bon fonctionnement de TYPO3 sont réunies (voir 4.1 Configuration PHP). 2.2 Outil utilisateur Pour les utilisateurs de TYPO3, que ce soit le créateur du site, l administrateur du site ou un contributeur qui met à jour le contenu, il faut comme navigateur web Microsoft Internet Explorer 6.x. ou Mozilla Firefox (mis à jour). 3. ACCES SERVEUR - Avoir un accès FTP à la racine du site, dans le but de déposer des fichiers ainsi que les scripts TYPO3 nécessaires au site. Il est important aussi de pouvoir modifier les droits de lecture, écriture de certains répertoires ou de fichiers pour le bon fonctionnement de TYPO3. - Avoir un accès SSH au serveur, pour régler les problèmes liés à la configuration système. L idéal serait un accès de type ROOT, dans la cas contraire il faut prévoir un accès sur le fichier de configuration PHP : php.ini (généralement dans /usr/local/lib/) pour des modifications liées au développement sur TYPO3. E-magineurs Page 4 19/01/2007
4. CONFIGURATION 4.1 PHP TYPO3 a besoin d une configuration particulière de PHP pour qu il puisse fonctionner correctement. Plusieurs paramètres sont à modifier dans la configuration PHP, par l intermédiaire du fichier php.ini, (généralement dans /usr/local/lib/). Certains paramètres peuvent être amener à être changés pendant le développement sur TYPO3. Voici les principaux paramètres à modifier avec les valeurs suivantes : - «max_execution_time = 120» C est le temps maximum d exécution d un script. TYPO3 a besoin de temps pour gérer la structure d un site et son contenu lors de modifications de ces derniers. - «max_input_time = 60» Temps maximum alloué à un script pour rechercher les données. - «memory_limit = 16M» Mémoire maximum allouée à l'exécution d'un script. Les scripts TYPO3 moins gourmands en mémoire on besoin d un minimum de 8M, certains scripts en demande plus. En fixant la limite à 16M, TYPO3 peut tourné correctement. - il est conseillé de désactiver les lignes suivantes (en mettant «;» devant) comme suit : «; allow_call_time_pass_reference = Off» «; register_globals = Off» «; register_argc_argv = Off» «; magic_quotes_gpc = Off» «; variables_order = "GPCS"» - «file_uploads = On» Permet l upload de fichier sur le serveur. - «upload_max_filesize = 10M» Taille maximale autorisée pour un fichier uploadé sur le serveur. Une fois ces paramètres modifiés ne pas oublier de redémarrer votre «Web Serveur» pour qu ils soient pris en compte. 4.2 Librairies graphiques Si Image Magick est déjà installé veuillez nous communiquer son emplacement sur le serveur (chemin complet), ce chemin sera intégré dans la configuration de TYPO3 par la suite. Dans le cas contraire Image Magick sera installé par nos soins à la racine du site. Pour l installation de gdlib et Freetype, veuillez vous reporter au tutorial suivant : http://www.gphp.net/install,5.php 4.3 Autres librairies Les procédures d installation de catdoc et de Xpdf se trouvent dans leurs archives respectives. E-magineurs Page 5 19/01/2007
5. PRESENTATION DE TYPO3 Cette partie à pour but de présenter TYPO3 et son installation. 5.1 Les fichiers sources La version la plus récente de TYPO3 est la version 4.0. Il existe plusieurs types d installations comme le «QuickStart package» qui contient un mini site et quelques extensions TYPO3 pré installées, le «Dummy package» qui permet de commencer un nouveau projet avec une base de données vide... Pour plus d informations sur ces différentes versions voici l adresse de la page des packages : http://typo3.org/download/packages/ 5.2 L arborescence de TYPO3 TYPO3 est constitué de plusieurs scripts PHP. Selon les versions de TYPO3 des fichiers peuvent changer mais l arborescence de base se présente comme suit : /filedamin : Espace Disque médiathèque /media : les médias de l'interface detypo3 /misc : divers pour compatibilité et vérification /t3lib : code library de TYPO3 en relation avec Php4 /tslib : code en relation avec Php4 et /t3lib /TYPO3 : Code TYPO3 et Extensions globales /typo3conf : configuration et Extensions locales /typo3temp : fichiers temporaires /uploads : l'espace «upload» et images intégrées dans les modules «auteur» 5.2 Installation Le contenu du package TYPO3 téléchargé doit être transféré sur le serveur par FTP dans le répertoire partagé pour le web «www». L installation de TYPO3 est exécutée par un script (qui se trouve dans /typo3/install) et se fait par interface web. On y configure principalement l accès à la base de données. Les autres configurations viennent par la suite comme par exemple la liaison TYPO3 et Image Magick E-magineurs Page 6 19/01/2007