1. Informations

Nous sommes maintenant prêts pour l'installation du système de gestion de contenu Typo3. Nous allons effectuer un type d'installation un peu spécial, puisque vous avez peut-être défini des hôtes virtuels au cours du chapitre sur Apache. Nous n'allons pas placer le répertoire «source» de Typo3 dans la racine web d'un des serveur. Nous allons le placer à l'extérieur. Ainsi, il sera accessible depuis n'importe que hôte virtuel, tout simplement par le biais d'un lien symbolique. Cela veut également dire que vous n'aurez qu'un seul répertoire source Typo3 pour tous vos serveurs. Du coup, lorsque vous aurez besoin de mettre à jour Typo3, tout ce qu'il y aura à faire, c'est mettre à jour ce répertoire unique, et tous vos sites seront instantanément mis à jour.

2. Télécharger la source

La première chose à faire est de télécharger une version de Typo3. Connectez-vous sur http://typo3.org/download/packages/. Vous y verrez trois distributions différentes, plus la source. Vous pouvez d'ores et déjà télécharger la source. Prenez la version en tar.gz, qui a l'avantage de préserver les liens symboliques contenus dans l'archive.

Ensuite, à vous de décider quel distribution vous allez utiliser. La première est appelée «Dummy». Il s'agit d'une version complète et vierge de Typo3, parfaite donc pour démarrer un nouveau projet. Par contre, si vous désirez des exemples, vous pouvez en télécharger une autre, comme «QuickStart», qui est un site Typo3 préfabriqué, et dont l'utilité est de vous aider à comprendre le fonctionnement du système. La dernière distribution, «TestSite», est un autre site d'exemples, mais destiné aux utilisateurs qui connaissent déjà un peu Typo3.

La distribution n'a ici aucune espèce d'importance. Dans ce manuel, j'utilise «Dummy», mais les étapes sont exactement les mêmes pour chacune d'entre elles.

3. Installer les fichiers

Décompressez la source et la distribution que vous avez choisie. Placez le répertoire contenant la source dans /Library/Servers/ et les fichiers de la distribution dans la racine web que vous aurez choisie (ex. /Library/Servers/Server-1/Documents/). Il nous faut également attribuer des permissions correctes pour ces deux répertoires:

sudo chown -R your_username:www /Library/Servers/

sudo chmod -R g+w /Library/Servers/

Et voilà. Comme vous le verrez par la suite, il est extrêmement important que l'utilisateur www aie accès en écriture aux répertoires Typo3. La dernière étape consiste à recréer le lien vers la source Typo3 dans la racine web du serveur. Premièrement, dans la racine web, effacez le vieux lien:

rm typo3_src

Ensuite, créez le nouveau:

ln -s /Library/Servers/typo3_src_3.x.x typo3_src

Tous les autres liens de la distribution vont se référer au lien typo3_src. Donc si ce dernier est correct, les autres le sont également.

Les prochaines étapes de l'installation vont se dérouler dans un navigateur internet. Pour que tout se passe bien, vous devrez utiliser un navigateur basé sur Mozilla. Comme vous le découvrirez, le «backend» de Typo3 est un endroit vaste et complexe, avec de nombreuses fonctionnalités. Si votre navigateur ne respecte pas les standards web, votre expérience avec Typo3 pourrait fort bien se transformer en cauchemar.

Les standards sur internet sont extrêmement importants. Ils garantissent à l'utilisateur un affichage correct. Malheureusement, il n'y a aucun moyen pour obliger quelqu'un à respecter ces standards. Sur Mac OS X, vous avez le choix entre plusieurs navigateurs, tous comprenant des fonctionnalités plus élégantes et attractives les unes que les autres. Mais la plupart d'entre eux sont totalement incompatibles avec les standards. Certains d'entre eux, comme Safari, d'Apple, et Internet Explorer, de Microsoft, vont jusqu'à prétendre les respecter, alors que ce n'est absolument pas le cas.

Les navigateurs utilisant le moteur Gecko (de Mozilla) sont compatibles avec les standards. Donc pour travailler avec Typo3, il vous faut en utiliser un. Il peut s'agir de Firefox, Mozilla ou Netscape. Personnellement, mon navigateur favoris est Firefox. Il possède tout ce dont vous avez besoin, il est plus rapide que Netscape et Mozilla, et il offre une interface soignée et intuitive, comme la plupart des programmes sous OS X. Vous trouverez ci-dessous les liens vers ces différents navigateurs:

Firefox     http://www.mozilla.org/products/firefox/

Mozilla     http://www.mozilla.org/products/mozilla1.x/

Netscape    http://channels.netscape.com/ns/browsers/download.jsp

1. Accéder à Typo3

Maintenant que vous avez un navigateur digne de ce nom, vous pouvez accéder à votre installation de Typo3. Connectez vous à cette adresse:

http://localhost/

Si vous êtes sur un hôte virtuel, ajoutez le numéro de port après localhost (ex. http://localhost:9000). Vous devriez obtenir ceci:

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

Pour des raisons de sécurité, l'installeur est désactivé. Pour le rendre disponible, ouvrez le fichier typo3_src/typo3/install/index.php, et désactivez les lignes suivantes en ajoutant le signe // devant chacune:

//if (1==1 || (substr($HTTP_SERVER_VARS['REMOTE_ADDR'],0,7)!='192.168' && $HTTP_SERVER_VARS['REMOTE_ADDR']!='127.0.0.1')) {

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

//}

Sauvegardez ce fichier, et rafraîchissez la page sur votre navigateur.

2. 1-2-3 GO!

Vous devriez voir apparaître ceci:

Entrez le nom et le mot de passe de l'utilisateur MySQL que vous avez défini précédemment, et cliquez sur le bouton de validation. Sur la page suivante, sélectionnez la base de données que vous avez créée, et, dans la dernière étape, importez la base de données (cliquez simplement sur le bouton de validation).

Félicitations. Vous avez maintenant un système de gestion de contenu Typo3 entièrement fonctionnel sur votre Macintosh.

3. Configuration avancée

Maintenant, configurons un peu plus. Cliquez sur le lien «Continue to configure Typo3». Vous allez tout d'abord devoir entrer un nouveau mot de passe pour sécuriser l'installeur. Une fois cette opération effectuée, rendez-vous dans la section «All Configuration»:

Cette page permet de configurer les options de base de Typo3. Changez les valeurs comme ci-dessous:

[GFX]

[thumbnails_png]             1

[gdlib_png]                  1

[gdlib_2]                    1

[im_path]                    /usr/local/bin/

[im_path_lzw]                /usr/local/bin/

[im_version_5]               1

[im_imvMaskState]            1

[im_no_effects]              1

[im_v5effects]               1

[im_mask_temp_ext_gif]       1

[im_combine_filename]        composite

[TTFdpi]                     96

[SYS]

[sitename]                   The name of your website

[encryptionKey]              Just enter some random text

[curlUse]                    1

[binPath]                    /usr/bin/,/usr/local/bin/

[BE]

[unzip_path]                 /usr/bin/

[lockRootPath]               Your server's document directory

                             (eg. /Library/Servers/Server-1/Documents)

[FE]

[simulateStaticDocuments]    1

Lorsque vous êtes au bout, validez le formulaire pour que ces nouvelles valeurs soient écrites. Vous pouvez ensuite vous rendre dans «Basic Configuration», ou «Image Processing», pour vérifier que tout est en ordre.

Pour obtenir d'avantage d'informations au sujet des autres options, veuillez vous référer à la section documentation de ce chapitre.

4. Remplacement d'URL

Il y a maintenant une dernière étape à effectuer. Dans le processus de configuration, nous avons activé l'option [simulateStaticDocuments]. Il s'agit d'une fonctionnalité très pratique de Typo3. Toutes vos futures pages seront en effet générées par le fichier index.php. Donc, pour n'importe quelle page, l'URL sera sous cette forme là:

http://localhost/index.php?id=1&type=0

Ceci n'est pas très évident pour vos visiteurs. L'option que nous avons activée va donc transformer l'URL pour simuler un fichier HTLML pour chaque page de votre site, en utilisant le nom de la page. Cette transformation est effectuée via le module Apache «mod_rewrite», que nous avons également activé précédemment.

Nous devons configurer ce module en plaçant un fichier .htaccess au premier niveau de la racine web du serveur. Pour créer ce fichier, vous devez tapez une commande de ce type, dans le terminal:

pico /Library/Servers/Server-1/Documents/.htaccess

Et voici le contenu du fichier:

RewriteEngine On

RewriteCond %{REQUEST_FILENAME} !-f

RewriteRule ^[^/]*\.html$ index.php

RewriteRule ^[^/]*\.pdf$ index.php

Et voilà. Sauvegardez et fermez le fichier, redémarrez Apache, et tout est fini. Vous pouvez maintenant commencer à apprécier le meilleur système de gestion de contenu sur votre système préféré.

Vous êtes arrivés au terme de ce manuel. Vous avez un serveur web en fonction, comprenant de nombreuses fonctionnalités, ainsi qu'un installation complète de Typo3. Vous devriez maintenant jeter un coup d'oeil à la section documentation du site officiel de Typo3 (http://typo3.org/documentation/document-library/Matrix/), sur laquelle vous pourrez trouver tout ce que vous désirez savoir au sujet de Typo3.

Si vous n'avez jamais utilisé ce système auparavant, vous devriez lire le manuel «Getting Started», qui est basé sur la distribution «QuickStart» de Typo3. Il vous guidera tout au long de vos premiers pas.

Si vous avez d'autres questions concernant ce manuel, vous pouvez me trouver sur les forums de Typo3 France (http://www.typo3.fr/forum/), sur lesquels je me ferai un plaisir de vous répondre.