Guide d'installation de TYPO3¶

Pré requis Logicielspour TYPO3¶

TYPO3 ne s'exécute pas comme un programme. C'est une application qui pour fonctionner, a besoin de sa couche logicielle. Ceci inclut tous les programmes indispensables que vous devez préalablement installer et configurer afin de faire «tourner» TYPO3 dessus. (voir aussi les (pré requis) «system requirements» à cette adresse : http://typo3.org/1275.0.html (11/2003). Ce qui suit est donc indispensable pour «faire fonctionner» TYPO3 («must have ..) :

Web Server qui peut être IIS ou Apache – permet à des clients sur «Browser» d'accéder à votre site TYPO3

DBS Mysql, Serveur de base de données qui stocke principalement les contenus HTML et les paramètres de configuration de TYPO3. Les images et PDF se trouvent sur le disque du serveur.

PHP et GD/Freetype dont TYPO3 utilisera les fonctionnalités pouraccèderau DBS mais aussi pour ses fonctions graphiques d'affichage (bibliothèque GD/Freetype) et bien d'autres (email, fichiers, fonctions systèmes, ..)

Graphic imaging (outils graphiques) qui sont ImageMagick etGhostscriptutilisés par TYPO3 pour vous fournir des fonctions de manipulation graphique très puissantes

Dés lors que vous disposez de ces «pré requis logiciels», il vous suffit d'un « package» TYPO3 que nous allons installer avant de démarrer TYPO3.

Que faire si vous rencontrez une difficulté ?¶

(ce chapitre est issu des règles d'utilisation des listes de distribution TYPO3. http://typo3.org/ )

TYPO3 est une application professionnelle puissante et complexe. Si vous êtes tenté de court-circuiterce document, il y aura ultérieurement pour vous beaucoup de choses que vous ne comprendrez pas, ou qui n'auront pas de sens.

Il y a une «liste d'expédition» (mailing list) largement utilisée (pour plus d'information, voir www.typo3.com & typo3.org ) où beaucoup d'utilisateurs et de développeurs expérimentés sévissent… ils sont toujours disposés à aider, si vous suiviez ces étapes AVANT que vous ne posiez votre question:

Lire toute la documentation disponible soigneusement

Lire toute la documentation disponible encore

Rechercher les archives des «mailing list» soigneusement

Si vous ne trouvez toujours pas de rèponse, alors demandez de l'aide dans la liste… respectez les directives suivantes…

• Être poli
• Incluez toujours la référence à la version de TYPO3 et les informations d'environnementdu serveur (phpinfo())…Ceci est disponible dans le menu du «TYPO3 Install Tool»l
• Être aussi spécifique et clair que possible - les questions comme "mon installation TYPO3 ne fonctionne pas – Ouestce que je peuxfaire?" seront ignorées. Bien que l'anglais puisse ne pas être votre première langue, si ceux qui lisent votre «post» ne peuvent pas la comprendre, vous n'obtiendrez pas l'aide dont vous avez besoin
• Si vous passez un moment vraimentdifficile pour obtenir quelque chose qui fonctionne, restez «cool» et ne critiquez pas. Les problèmes sont normalement la conséquence d'un manque de recherches dans la documentation, une erreur de compréhension, plus que de bogues. Soyez logique dans l'approche de votre résolution de problèmes, et vous y arriverez

Si vous avez identifié un «vrai» nouveau bogue, le rapportez auprès de bugs@typo3.com .. et ne pas faire de «post» le concernant à la «liste» le temps de son traitement

Veuillez être conscient du fait que si vous posez les questions qui ont une réponse dans la documentation disponible, vous ne pouvez pas vous attendre à obtenir une réponse, ou n'importe quelle aide des réalisateurs ou tous les utilisateurs expérimentés!

Nous nous rendons compte qu'il reste un certain travail à faire sur la documentation, et la plate forme pour l'assistance aux utilisateurs… pardonnez-nous pour ne pas avoir encore corrigé toutes ces lacunes. Si vous estimez que de l'information manque, est difficile à trouver ou est totalement déphasée ou fausse, ou encore si vous avez une suggestion pour améliorer TYPO3 ou les "services de support", svp faites le nous connaître de sorte que nous puissions faire ce qui est nécessaire. Vous pourriez également offrir de nous aider pour ce travail!

Étapes de l'installation¶

Nous vous rappelons que vous disposez de :

«Guide de TYPO3 avec Windows – installer TYPO3» décrit l'installation de TYPO3 dès lors que les «pré requis logiciels» sont installés et fonctionnent.

«Guide de TYPO3 avec Windows – pré requis logiciels» décrit les choix possibles et l'installation des «pré requis logiciels» indispensables et optionnels pour faire «tourner» TYPO3

Voilà un synopsis de la procédure d'installation que nous vous proposons :

GS ( Ghostscript)¶

IM (ImageMagick)¶

Vérifier le Path créé par imagemagick par exemple en relançant¶

Si vous avez des soucis avec ce test, reportez-vous au «Guide de TYPO3 avec Windows – pré requis logiciels»

Pour vérifier que Php fonctionne :¶

Configuration de «php.ini» pour TYPO3¶

C'est une étape importante et délicate, mais tout à fait abordable et importante à connaître. Nous y reviendrons pour valider certains paramètres nécessaire à TYPO3 et il y aura peut être redondance avec le présent chapitre. Vous vous souvenez que «php.ini» créé par le programme “winmysqladmin” ou par vous même se trouve dans le répertoire «c:windows» ou «c:winnt»selon votre OS. Faites une sauvegarde du fichier avant de le modifier manuellement avec un éditeur de texte.

Vérification de la configuration de PHP - phpinfo()¶

Une dernière vérification est utile qui va nous permettre d'obtenir le stratus de PHP mais aussi de de vérifier que l'ensemble Php/Mysql et «Web server» fonctionnent correctement ensemble. Procédons de la manière suivante :

• créer un fichier appelé «info.php» avec un éditeur de texte, par

Voilà ce que l'on doit obtenir et on va quelques points très importants et qui vont revenir par la suite .

• pour certaines versions, on obtiendra : **Server API = CGI**
• pour la version ISAPI, on obtiendra : **Server API = ISAPI**
• pour Apache on peut aussi obtenir : **Server = APACHE**
• La version de Php v4.34 est bien celle installée et cela fonctionne, la preuve
• «Server Api» indique «CGI/FastCGI» ou «ISAPI», cela à l'air de rien et pourtant, avec TYPO3, il faudra procéder à quelques modifications.
• Php.ini – la référence au répertoire est cohérente avec ce que nous avons prévu
• Vous verrez en faisant défiler le rapport des options qui nous intéresserons pour TYPO3,par exemple («magic_quotes_gpc», «post_max_size = 8M», «Sendmail_from, SMTP, smtp_port». Vous notez «mysql» et leparamètre «Client API version = 3.23.49» indique que PHP reconnaît bien Mysql. Par contre la Section «Additional Modules» ne contient rien et cela va nécessiter que nous intervenions avant l'installation de TYPO3.

Section «Environnement» & «Php Variables» nous donne des informations qui confirment ce que nous savons sur la configuration du serveur IIS reconnu avec le paramètre «SERVER_SOFTWARE Microsoft- IIS/5.1» A noter plusieurs paramètres sur lesquels nous reviendrons :

• ComSpec C:WINDOWSsystem32cmd.exe permet d'exécuter une commande Dos et TYPO3 en aura besoin et nous verrons que l'user IUSR n'a pas forcément les droits pour cmd.exe
• TMP et TEMP = C:WINDOWSTEMP - là aussi une restriction de droits pour IUSR nous posera des soucis pour des opérations sur les fichiers des bibliothèques d'images qu'il faut manipuler en passant par ce répertoire

Puis la bibliothèque GD2

et l'ensemble des paramètres que nous avons vu et que vous pouvez vérifier une dernière fois.

Quelques raisons habituelles pour lesquelles PHP ne fonctionnent pas :

• Les permissions sur les fichiers et les répertoires de vos scripts php «.php»,du programme pour IIS-CGI «php.exe», les DLL «php4ts.dll», ou encore le «php.ini» et les autres extensions dans le répertoire «c:phpextensions» ou d'autres auxquels vous vous référez et que l'user anonyme ISUR_<machinename> tente d'atteindre et de Lire.
• Le fichier de script n'existe pas .. ou il n'est pas où vous pensez le trouver ... (attention aux chemins relatifs et absolus). Nous avons configuré IIS-Isapi (pas fait pour IIS-CGI) pour valider leurs présences. «404 error»
• "Security Alert! The PHP CGI cannot be accessed directly." Depuis PHP v4.1.2, dans le php.ini le paramètre «cgi.force_redirect = 1» est par défaut à «1» et donc ne fonctionnera pas avec IIS-CGI, donc absolument mettre «cgi.force_redirect = 0»

Télécharger le Package TESTSITE¶

Le package «Testsite» est tout à fait idéal pour commencer. Il contient un site déjà réalisé et un grand nombre d'exemples illustrant ce que TYPO3 est capable de vous proposer. **Télécharger le «Testite Package»**

• Site = http://typo3.org/1233.0.html
• Nom = «testsite-3.5.0.zip» Taille : 12.730 kb - (c'est un fichier compressé au format ZIP)
• Lien = http://typo3.org/1274.0.html - `http://prdownloads.sourceforge.net/typo3/testsite-3.5.0.zip?download <http://prdownloads.sourceforge.net/typo3/testsite-3.5.0.zip?download> `_ (11/2003)
• Le fichier «Testsite» a fini d'être téléchargé, et une fois «décompressé» (option «exctract here» : un répertoire «testsite-3.5.0» est créé ) , le répertoire fait à présent 25MO et se présente de cette manière :

Installez le Package TESTSITE¶

Il va falloir maintenant copier le «contenu» du répertoire «..testsite-3.5.0» dans votre «répertoire Web» et cela dépend de votre WebServerIIS ou Apache et de vos choix.

Dans tous les cas, il faut éviter impérativement de créer un répertoire contenant des espaces (par exemple «mon site Testsite» ou des caractères spéciaux mais plutôt «monsitetestsite»

Permissions Windows sur les fichiers et répertoires¶

Pour terminer, attribuez les droits Windows NTFS sur les bons répertoires et fichiers pour l'utilisateur «WebUser». Ceci concerne les WebUser des WebServer installés en tant que Services-Nt tel que IIS (IUSR_nommachine) ou bien Apache dans le cas où il fonctionne en mode Services-Nt et où vous lui avez attribué un «compte d'utilisateur» (par exemple «apache»). Cela vous concerne, ou plutôt votre «compte d'utilisateur» avec lequel vous avez ouvert une session dans le cas ou vous lancer «apache.exe» comme un programme et votre compte d'utilisateur doit disposer de ces droits pour que «apache.exe» puisse en «profiter» (voir le guide «Guide de TYPO3 avec Windows – pré requis logiciels») .

Ces informations figurent notamment sur la documentation intitulée «INSTALL.txt» dans le package Testsite. (note – cocher l'option «modification» dans l'onglet «Sécurité» des propriétés Ntfs entraîne les droits suivants : (modification / Lecture & Exécution / Affichage / Lecture / Écriture). D'autre part, sauf si spécifiquement indiqué, les droits s'affectent aux sous-répertoires et aux fichiers contenus.

Remplacez la valeur du sapi_name = «cgi-fcgi»¶

Ce qui se passe est simple, le code de TYPO3 attend la valeur «cgi» et votre PHP lui renvoie «cgi-fcgi» (pour IIS-CGI et Apache v2. Cgi). Ce cas ne se présente pas pour «IIS-Isapi» ou pour «Apache 1.3» Vérifions la valeur de PHP.

Traiter le remplacement de la valeur «is_execute»...¶

Pour éviter ceci :« Fatal error: Call to undefined function: is_executable() PHP functionis_executable()»qui est une erreur connue de PHP v4,x, lacune qui est réglée avec la future version Php v5 en version béta, une modification du code est à effectuer ... Une FAQ existe à ce sujet sur TYPO3 Faq "is_executable" Vous devez donc modifier les deux fichiers suivants .

¶

**Quelques erreurs habituelles :**

Si vous obtenez le message : «Cannot find configuration. This file is probably executed from the wrong location». .. Traitez le remplacement de la valeur "cgi" par la valeur réelle de «php_sapi_name», vous l'avez oublié et allez regarder sur typo3.org la FAQ suivante http://typo3.org/1422+M54defb70332.0.html

Vous obtenez soit d'abord le «Message 1», puis le «Message 2», soit (veinard) le seul «Message 2». Ci-dessous, vous avez les solutions ..

Message N°1¶

Message N°2¶

ET voilà Bravo !!!!

(contrairement à la première impression, c'est bon, cette fenêtre étant un message d'information)

TYPO3 : Install Tool - «1.2.3 mode»¶

Menu «TYPO3 Install Tool»¶

Menu «TYPO3 Install Tool- 1:Basic Configuration»¶

Menu «TYPO3 Install Tool- 2:Database Analyzer»¶

Menu «TYPO3 Install Tool- 3:Image Processing» validation des fonctions graphiques¶

Paramètres [GFX] du Menu Général «4:All configuration»¶

Menu «TYPO3 Install Tool- 5: - 6: -7:»¶

Sécurité de TYPO3 et de vos sites¶

Voici quelques informations pour améliorer la sécurité de votre site.

Supprimez le répertoire "/install" car des malveillants pourraient lancer la procédure d'installation et mettre un user/password d'administrateur, ou enlever au moins les fichier «.php» et au minimum protéger le répertoire avec les droits NTFS, par exemple en retirant les droits à tous le monde sauf à l'administrateur sur ce répertoire et dépendants. Et, changer le mot de passe ' :underline:`**joh316**` ' connu par tout le monde !!

Il est aussi conseillé de retire le répertoire "/dev" ou de retirer les droits NTFS

Choisir un mot de passe du BE qui soit pas trop simple .... et mieux créez un nouvel utilisateur administrateur et un mot de passe «introuvable» en allant sur le Menu Général «2: Database Analyser»

D'autres protections plus poussées sont encore possibles, selon une note d'analyse de sécurité (reportez vous au site TYPO3)

«showpic.php et thumbs.php» doivent être modifiés

Enlevez les répertoires de démonstration et protégez au maximum avec NTFS "/fileadmin" et "/typo3conf"

Accès au FE 'Wellcome to the TYPO3 testsite) et au BE (Administration Login)¶

L'installation es désormais terminée, vous êtes prêt à entamer la phase d'utilisation de TYPO3 et à apprendre la manière d'élaborer un site.

Pour l'instant, ce qui est important est de savoir comment accéder au «BE» (BackEnd), soit l'interface d'administration et de conception, mais également le moyen d'accéder aux procédures de configuration et de mise à jour.

Vous allez aussi pouvoir profiter du FE (Front End) et comme un des futurs utilisateurs de votre futur site, admirez le résultat du travail de conception et d''auteur que vous permet TYPO3. Les différents modes d'accès sont donc :

BE , l'adresse sur votre navigateur est (http://[nom.machine]/[nom.répertoire]/typo3/index.phph) et dans notre cas http://localhost/typo3testsite/typo3/index.php - Cet accès est protégé par une demande d'identification qui est par défaut (username=admin, password=password)

• FE , l'adresse sur votre navigateur est (http://[nom.machine]/[nom.répertoire]/) et dans notre cas http://localhost/typo3testsite/
• INSTALL , si il se révélait nécessaire de repartir sur la procédure d'installation, l'adresse est (http://[nom.machine]/[nom.répertoire]/typo3/install/) Le «mot de passe» est « joh316» .... à moins que ... vous ayez bien tout lu et au premier écran vous ayez saisi l'opportunité de changer ce «mot de passe», vous devriez vous en souvenir alors ..

Créer votre site – notions de «site, application, database et package»¶

Le mieux pour comprendre, c'est de s'appuyer sur notre expérience récente..

Nous avons «téléchargé» un « package » parmi ceux proposé, dans notre cas «Testsite»

Nous avons créé une « application » dès lors où nous avons créé un répertoire (dans notre cas, «C:Inetpubwwwroot/typo3testsite/» et y avons mis le package dedans et nous avons paramétré cette application en sauvant les informations de paramétrage dans le fameux «localconf.php» Au lancement de la configuration, nous avons dû (autrement TYPO3 ne peut fonctionner», créer une «database» , ici «TYPO3_testsite»

Dans l'application (associée à une database) nous allons avoir autant de sites que nous voulons et dans l'exemple de Testsite, il y a plusieurs sites qui sont dèja montrés.. Vous pouvez créé des sites pour vous faire la main dans l'application que nous avons installée (typo3testsite)

Conclusion – à une application, on associe une database et une seule, soit en choisissant une database existante ou en créant une nouvelle qui est sur Mysql et qui contient la définition de nos sites et les contenus hors média (graphiques ..)

**Pour créer votre site, vous avez donc plusieurs manières de procéder :**

La première en partant de l'application typo3testsite que nous avons installer, dans l'application «typo2testsite» où, vous verrez il est aisé d'ajouter des sites rattachés à un domaine internet (une adresse de domaine). L'avantage est de pouvoir se servir du matériel (template, image, etc ..) disponible pour progresser tranquillement.

La seconde en créant une nouvelle application avec par exemple «montypo3» en créant un répertoire et en y copiant .... quoi alors?, quel package?

**Choix du Package –** comme pour Testsite, les packages TYPO3 se trouvent ici - http://typo3.org/1274.0.html

• QuickStart package : pour démarrez avecTYPO3 et disposer d'un excellent tutorial ( PDF ) qui vous propose de nombreuses heures d'entraînement et la connaissance pour le «minimum vital»
• Testsite package - vous connaissez les bases deTYPO3 et voulez en voir plus sur les fonctionnalités avancées
• "Dummy" package - Si vous voulez commencer un projet nouveau avec le minimum, «Dummy» offre une base de données vide avec seulement un utilisateur simple d'administration configuré(user: "admin", PW: "password").
• Freesite package - Ce package est pour les utilisateurs experts (!) pour en savoir plus "freesite"extension, et permet dans une approche type «ISP» de permettre à des clients de créer leu Database en un instant More info

Extension Manager (EM)¶

Le «Guide d'utilisation des Extensions TYPO3» est en cours d'élaboration et en attendant, quelques points essentiels pour commencer.

Depuis le version 3.5 de TYPO3, l'architecture du système à été changée. Précédemment, tous les modules et composants étaient intégrés au système, et chaque installation incluait tout…, que vous en ayez eu besoin ou pas!

TYPO3 est maintenant distribué sous forme d'une installation de fichiers et de dossiers concernant le noyau, et des Extensions globales qui sont en usage permanent. Les fonctionnalités additionnelles sont fournies par le téléchargement, puis l'installation d'autres Extensions, écrites par Kasper lui-même, ou par d'autres développeurs et utilisateurs. Les Extensions sont gérées dans un dépôt en ligne (online repository) sur typo3.org .

Dans le BE, si vous cliquez sur le module «Tools>Ext Manager» vous accédez sur le «Extension Manager». C'est l'outil que vous emploierez pour regarder, télécharger, installer, désinstaller, créer et télécharger des Extensions. Utilisez le menu déroulant se situant en Haut à gauche de la fenêtre de EM pour choisir ce que vous voulez voir.

Pour télécharger et installer une Extension, faites ceci…

Choisir la page “Import extensions from the online repository” et cliquer le bouton «Connect»

Les Extensions seront listées en deux groupes : celles qui sont disponibles et celles qui ne le sont pas déjà sur votre système (voir icône dans la colonne de gauche)… cliquez sur cette icône pour télécharger l'Extension sur votre serveur. L'Extension est sur votre serveur mais pas encore installée.

Sélectionnez “Available extensions to install” dans le menu déroulant, cherchez et sélectionnez l'Extension que vous voulez installer dans la liste et cliquez le bouton « + » à gauche. Si des mises à jour de votre base de données sont exigées, il vous sera demandé d'exécuter cette procédure

Videz le «Cache», déconnectez (log out) et revenez, et la nouvelle prolongation sera prête à l'emploi (notez que se déconnecter et se reconnecter n'est pas exigée pour toutes les Extensions)

Pour un premier essai, «Connectez-vous»… et téléchargez l'Extension «Help>Welcome» et installez la. Après s'être déconnecté et être reconnecté, vous verrez le nouveau module dans le BE sous «you guessed..» Help>Welcome! Cliquez dessus pour voir une introduction sur la façon d'employer certaines des fonctionnalités de TYPO3.

Templates¶

TYPO3 est un système simple pour l'édition des contenus et pour les auteurs et contributions, mais il est complexe pour des réalisateurs, et n'est pas forcément rapide d'apprentissage. Cependant, si vous consacrez assez de temps à sa prise en mains, vous trouverez TYPO3 agréable et efficace à employer. En particulier, vous avez besoin de prendre en mains TypoScript (lisez les documents TSref et TypoScript by Example ) ...c'est le langage «script» de définition développé par Kasper, avec lequel vous mettez au point vos Templates (gabarits) et qui permet de configurer les nombreuses fonctions de TYPO3.

TYPO3 est un des meilleurs, tout en étant très largement documenté, parmi les produits «opensource» que vous pouvez trouver. Servez-vous de ces ressources pour vous informer sur le système, et comprendre ce que vous pouvez en obtenir. . Cette documentation extensive est fournie sur documentation page ( typo3.org ), et ceci inclut des tutoriaux et des manuels techniques et de référence..

il est fortement recommandé que vous joigniez la liste de diffusion (mailing list) sur le site officiel de TYPO3. Sur la liste vous trouverez beaucoup de membres expérimentés de la communauté qui sont disposés à vous aider sur des problèmes que vous pouvez avoir, ou vous conseiller sur la façon dont vous pouvez accomplir une tâche particulière. Vous pouvez également souhaiter joindre une des autres listes d'expédition qui sont consacrées à TYPO3 à mailing list page sur typo3.org ou typo3.fr pour y obtenir plus d'informations.

Étapes et Tutoriaux pour continuer¶

Voilà les prochaines étapes que l'on peut vous conseiller

• Prenez le temps de parcourir, de découvrir et de naviguer sur Testsite et de regardez le BE
• Puis, installez le package «Quickstart» que vous trouvez à cette adresse http://typo3.org/1274.0.html (11/03),ce qui vous permettra de vous habituer aux installations et d'aller plus loin dans la découverte
• Un tutorial très complet existe pour le package «Quickstart» qui vous permet de vraiment prendre en mains le BE et la gestion d'application TYPO3 et de sites. Voir ce lien (11/03 http://typo3.org/doc.0.html?&t x_extrepmgm_pi1[extUid]=491&cHash=9241ee54f7
• Marlies Cohen a mis à disposition de TYPO3 un très bon manuel «TYPO3 Tutorial» disponible à cette adresse http://typo3.org/doc.0.html?&en cryptionKey=&tx_extrepmgm_pi1[extUid]=608&tx_extrepmgm_pi1[tocEl]= 1846&cHash=348e4cfcc8 qui vous permet de vous familiariser dans l'utilisation du BE et FE de TYPO3 d'un point de vue «utilisateur concepteur». Son manuel repose sur un exemple disponible sur son site Mcuniverse © Marlies Cohen mc(AT)mcuniverse.com. Il y a sur ce site d'autres tutoriaux intéressants.
• Après tout cela, vous serez prêt et impatient de commencer votre site et l'étape suivante la plus adéquate est d'apprendre à fabriquer son «Template» (gabarit), en fait son Template et CSS pour obtenir le Design que vous souhaitez. Pour votre site. Vous pourrez alors regarder le «Tutorial: Golive Template integration» et le «Typoscript by example».
• le nombre de documents est impressionnant, vous en trouvez une liste exhaustive ici : http://typo3.org/1421.0.html
• N'oubliez pas non plus la vidéothèque assez impressionnante, fait rare, et qui vous permettra d'améliorer votre niveau de compréhension de l'anglais, voir même de l'allemand ou du danois... Vous verrez que ces vidéos sont fort utiles. .. Voyez à cette adresse : http://typo3.org/1407.0.html