Ins­truc­tions étape par étape pour installer TYPO3

TYPO3 est un système de gestion de contenu open source, puissant et gratuit, qui peut être utilisé sur toutes les pla­te­formes. Grâce à ses in­nom­brables ex­ten­sions et modèles, TYPO3 offre des pos­si­bi­li­tés de con­cep­tion flexibles aussi bien pour les petits sites Web que pour les grands projets mul­ti­lingues. Toutefois, l’ins­tal­la­tion de TYPO3 et son adap­ta­tion à vos besoins spé­ci­fiques re­quiè­rent gé­né­ra­le­ment l’in­ter­ven­tion d’un pres­ta­taire de services TYPO3 certifié. Vous souhaitez installer TYPO3 vous-même et avez besoin d’ins­truc­tions dé­tail­lées ? Suivez notre tutoriel étape par étape.

Con­di­tions requises pour l’ins­tal­la­tion de TYPO3

Pour installer TYPO3, aucun logiciel spé­ci­fique n’est requis, mais un client FTP peut être né­ces­saire pour le transfert de fichiers, même si de nombreux hé­ber­geurs préins­tal­lent TYPO3 sur leur serveur. Enfin, vous devez disposer d’un na­vi­ga­teur Web avec Ja­vaS­cript activé et d’un serveur Web (Apache, NGINX ou IIS).

Ac­tuel­le­ment, l’équipe de dé­ve­lop­pe­ment supporte deux versions : TYPO3 13 et TYPO3 12 LTS. Voici la con­fi­gu­ra­tion minimale requise pour les versions sé­cu­ri­sées actuelles :

• un serveur Web avec PHP à partir de la version 8.1, 8.2 ou 8.3 (TYPO3 12) ou PHP 8.2 et supérieur (TYPO3 13)
• une base de données basée sur SQL com­pa­tible avec la Doctrine DBAL, comme MySQL à partir de la version 8.0.17, MariaDB à partir de la version 10.3 ou plus récente, Post­greSQL 10.0+ ou SQLite 3.8.3+
• au moins 256 Mo de RAM (ou plus selon la taille du site Web)
• une con­fi­gu­ra­tion PHP avec au moins 128 Mo de limite de mémoire (Apache, IIS, NGINX)
• pour le trai­te­ment des images, l’équipe re­com­mande les bi­blio­thèques Gra­phics­Ma­gick et Ima­ge­Ma­gick.

Étape par étape : ins­truc­tions pour l’ins­tal­la­tion de TYPO3

TYPO3 est dis­po­nible en open source. Il existe par ailleurs des four­nis­seurs qui préins­tal­lent TYPO3 dans leurs produits d’hé­ber­ge­ment si c’est le souhait de l’uti­li­sa­teur. Ceux qui veulent con­fi­gu­rer TYPO3 exac­te­ment selon leurs idées peuvent le faire via le Sour­ce­Pa­ckage. Les pro­gram­meurs ex­pé­ri­men­tés de TYPO3 peuvent en effet di­rec­te­ment adapter le code source. Vous pouvez de plus per­son­na­li­ser TYPO3 grâce à son bon millier d’ex­ten­sions.

Dans notre exemple, nous tra­vail­lons sur le système d’ex­ploi­ta­tion Windows. Le programme FTP utilisé est FileZilla. Nous té­lé­char­geons la version 12 LTS de TYPO3 depuis typo3.org.

Étape 1 : rendez-vous sur la page de té­lé­char­ge­ment de TYPO3. Vous y trouverez les dernières versions prises en charge de TYPO3. Les dé­ve­lop­peurs décrivent briè­ve­ment en quoi les versions diffèrent les unes des autres. Choi­sis­sez la version qui vous convient le mieux. Par exemple, pour installer TYPO3 12, cliquez sur « Get Version 12 ».

Étape 2 : la manière classique de faire est de sé­lec­tion­ner « Package download » pour obtenir TYPO3 au format d’archive .tar (pour Unix/Linux) ou .zip (pour Windows). La com­pres­sion compacte Tar convient aux systèmes Unix/Linux. Les paquets avec signature GPG (en bas de la capture d’écran ci-dessus) ga­ran­tis­sent l’au­then­ti­cité du programme té­lé­chargé. Nous re­com­man­dons cette version pour les uti­li­sa­teurs pro­fes­sion­nels.

Étape 3 : cliquez sur le lien de votre choix pour lancer le té­lé­char­ge­ment. Une fois terminé, ouvrez le menu de té­lé­char­ge­ments de votre na­vi­ga­teur.

Étape 4 : en ouvrant l’archive com­pres­sée, vous accédez aux fichiers source de TYPO3.

Étape 5 : faites une ex­trac­tion du dossier entier et en­re­gis­trez-la dans un dossier que vous pouvez fa­ci­le­ment retrouver.

Étape 6 : ouvrez le programme FTP, dans notre cas FileZilla. Pour créer une connexion rapide à votre serveur, entrez votre nom de serveur sous « Host », puis votre nom d’uti­li­sa­teur et votre mot de passe. En général, le système complète au­to­ma­ti­que­ment le port. Sé­lec­tion­nez ensuite le bouton « Qui­ck­con­nect » ; le programme essaie ensuite de se connecter à votre serveur. Dans la fenêtre de gauche, vos fichiers locaux s’affichent, tandis que la fenêtre de droite présente le ré­per­toire de votre serveur, si la connexion est réussie.

Autrement : vous pouvez aussi sé­lec­tion­ner « Fichier » (ici : « File ») dans le menu principal et cliquer dans le menu déroulant qui s’ouvre sur « Site Manager ». Une nouvelle fenêtre apparaît. Dans le Site Manager, entrez le nom de votre serveur sous « Host » ainsi que votre nom d’uti­li­sa­teur et mot de passe. Dans cet outil, vous ajustez les pa­ra­mètres de té­lé­char­ge­ment pour TYPO3 et vous vous connectez au serveur. Dans l’onglet « Transfer Settings » (pa­ra­mètres transfert), sé­lec­tion­nez le mode de transfert. Cliquez sur le bouton « Default » et fixez un maximum pour le nombre si­mul­ta­né­ment de con­nexions au­to­ri­sées (nous choi­sis­sons 6). Si un pare-feu protège votre serveur, sé­lec­tion­nez le mode « Passive » puis « Connect ».

Étape 7 : sé­lec­tion­nez « Edit » dans le menu principal, puis « Settings » et « Con­nec­tion » dans le menu déroulant. Sous « Timeout », vous pouvez définir le nombre de secondes après lequel le té­lé­char­ge­ment doit être in­ter­rompu : 600 est une bonne valeur. Fixez le nombre maximal de ré­pé­ti­tions à 2. Dans la colonne de gauche, sé­lec­tion­nez « Transfers », puis « File Types » et dé­fi­nis­sez le type de transfert par défaut sur « Binary ».

Étape 8 : une fois que vous avez effectué tous les réglages, faites glisser le dossier TYPO3 de l’em­pla­ce­ment de votre disque dur (affiché dans la fenêtre de gauche) vers la fenêtre du serveur distant. Placez le dossier extrait dans le ré­per­toire racine de votre hé­ber­ge­ment (souvent indiqué par « / » pour les systèmes Unix).

Étape 9 : vérifiez que vous pouvez bien retrouver les fichiers té­lé­char­gés sur votre serveur. Connectez-vous à votre hôte pour cela. Le dossier peut être trouvé dans la zone d’hé­ber­ge­ment (hosting) sur votre espace Web s’il a été transféré cor­rec­te­ment. Autrement, vous pouvez accéder à votre ins­tal­la­tion TYPO3 via l’URL localhost/site/.

Étape 10 : si vous voulez installer un site Web avec TYPO3 et le rendre ac­ces­sible au public, vous avez besoin d’un nom de domaine. Nor­ma­le­ment, vous avez au moins un domaine inclus dans votre offre d’hé­ber­ge­ment.

Étape 11 : si vous avez bien un nom de domaine valide, connectez-le au serveur. Le chemin d’accès doit pointer di­rec­te­ment vers le ré­per­toire TYPO3.

Étape 12 : main­te­nant que le serveur et le domaine sont reliés, l’ins­tal­la­tion de TYPO3 dans le na­vi­ga­teur peut continuer. Pour ce faire, rendez-vous sur la page d’accueil de votre nouveau site Web. Un message de re­mer­cie­ment de TYPO3 apparaît. À partir de là, vous pouvez utiliser l’outil d’ins­tal­la­tion de TYPO3. Pour ce faire, créez un fichier vide avec le nom « FIRST_INSTALL » (sans extension de fichier) dans le ré­per­toire racine de votre espace Web. Ra­frai­chis­sez la page de votre site Web.

Étape 13 : accédez à l’URL http://www.[NOM-DOMAINE].fr/typo3/install.php pour lancer l’outil d’ins­tal­la­tion. L’outil vous aide à installer TYPO3 avec un processus en 5 phases. Tout d’abord, l’outil examine votre en­vi­ron­ne­ment système. Si des problèmes sur­vien­nent en raison d’un pa­ra­mé­trage, utilisez la fonction de dépannage. Sinon, continuez.

Étape 14 : dans l’étape suivante, spécifiez la base de données que TYPO3 doit utiliser. Si vous n’avez pas encore créé de base de données, rendez-vous sur le site Web de votre four­nis­seur d’hé­ber­ge­ment. Une base de données peut gé­né­ra­le­ment être créée en seulement quelques étapes. Pour TYPO3, vous avez besoin des in­for­ma­tions suivantes :

• Nom de la base de données
• Nom uti­li­sa­teur pour la base de données
• Mot de passe
• Hôte (souvent « localhost »)
• Port (souvent 3306)

Étape 15 : main­te­nant, vous pouvez soit choisir une base de données existante, soit en créer une nouvelle. Cette dernière option n’est possible que si vous disposez des au­to­ri­sa­tions né­ces­saires.

Étape 16 : dans le masque de saisie suivant, vous dé­fi­nis­sez un nom d’uti­li­sa­teur et un mot de passe avec lesquels vous vous con­nec­te­rez au backend comme à l’outil d’ins­tal­la­tion. Sous « Site name », entrez le nom de votre nouveau site Web TYPO3.

Étape 17 : dans la dernière étape, l’assistant termine l’ins­tal­la­tion en adaptant au­to­ma­ti­que­ment certaines con­fi­gu­ra­tions à votre en­vi­ron­ne­ment système. Vous pouvez encore décider si TYPO3 doit créer ou non un site Web vide dans un premier temps. En cliquant sur « Open the TYPO3 Backend », vous accédez à la zone d’ad­mi­nis­tra­tion où vous pouvez vous connecter à votre compte nou­vel­le­ment créé. Vous avez désormais bien installé TYPO3.

L’équipe de TYPO3 re­com­mande de ver­rouil­ler l’assistant d’ins­tal­la­tion une fois le travail terminé afin qu’il ne soit pas ac­ces­sible à des tiers. Vous avez la pos­si­bi­lité de consulter les données de base ou de comparer votre base de données. La colonne de gauche vous permet d’accéder aux con­fi­gu­ra­tions, de faire des mises à niveau et d’examiner l’en­vi­ron­ne­ment système en cas d’erreur. Via la structure de dossiers, vous pouvez vi­sua­li­ser l’ar­bo­res­cence de vos ré­per­toires. Test Setup permet par ailleurs de tester si vos réglages pro­dui­sent des erreurs. Si c’est le cas, l’assistant de dépannage Clean Up vous aidera à y remédier.

Ensuite, vous serez redirigé vers le backend, où vous pourrez entrer les données de connexion que vous avez préa­la­ble­ment définies pour les ad­mi­nis­tra­teurs. Vous pouvez adapter TYPO3 selon vos besoins, ajouter des ex­ten­sions ou même créer des comptes pour les éditeurs qui doivent avoir ensuite accès au frontend du site. La com­mu­nauté très active de TYPO3 propose des templates gratuits que vous pouvez utiliser pour votre site Web. Ces modèles con­tien­nent des commandes en « ty­poS­cript », le langage de con­fi­gu­ra­tion interne de TYPO3. Après avoir installé TYPO3 selon les ins­truc­tions ci-dessus, installez les ex­ten­sions et modèles qui vous sont utiles pour per­son­na­li­ser votre site Web et optimiser votre backend.