Installation de Typo3 sur Mac OS X 10.3 Client¶

A lire avant de commencer¶

Le but de ce manuel est de vous aider à installer et à configurer un serveur web, comprenant toutes les fonctionnalités requises pour une installation complète de Typo3. Vous n'avez pas besoin de maîtriser les technologies Unix pour le suivre, mais si avez déjà un peu d'expérience dans ce domaine, cela vous sera sans doute fort utile. Si par contre vous ne vous sentez pas à l'aise avec Mac OS X, faites bien attention de suivre chaque étape de ce manuel, sans en omettre une seule. Vous allez apprendre à installer et à configurer un serveur internet, ainsi que tous les programmes et librairies nécessaires à l'utilisation d'un CMS comme Typo3. Vous allez également découvrir le mode de fonctionnement interne de votre machine, ce qui vous aidera aussi, je l'espère, lors de l'utilisation quotidienne de votre Macintosh.

Installation¶

Il est préférable de commencer avec une nouvelle installation de Mac OS X. Bien qu'il ne devrait pas y avoir de problème avec une configuration existante, il y a toujours un léger risque d'incompatibilité si vous avez déjà installé et configuré des programmes. La meilleure solution est donc de réinstaller complètement le système, suivre ce manuel, et finalement installer puis configurer vos programmes et fichiers, comme d'habitude. Ainsi, vous éviterez tout risque de problème.

Système X-Window¶

Lors de l'installation de votre Macintosh, vous avez la possibilité d'installer un programme nommé X11, qui est un système X-Window. En d'autres termes, c'est un environnement graphique alternatif à l'interface Aqua que vous connaissez déjà. De nombreux programmes que nous allons installer on besoin d'X11 pour fonctionner correctement; vous devez donc impérativement l'installer. De plus, la plupart des manuels concernant Typo3 sont fournis au format SXW, et ne sont lisible que via X11. SXW est le format des documents texte d'OpenOffice. Le mieux est donc d'installer X11, suivi d'OpenOffice, afin de pouvoir lire ces manuels. La version Mac peut être téléchargée depuis le site officiel ( http://www.openoffice.org/ ).

Outils de développement¶

Mac OS X est vendu avec un CD supplémentaire appelé les «Developer Tools». Ce CD contient des programmes ainsi que des librairies permettant de développer des applications natives pour Mac OS X. Les programmes que nous allons installer vont avoir besoin de certaines de ces ressources. Il vous faut donc installer le contenu de ce CD avant de continuer.

Activer l'utilisateur «root»¶

Tout système basé sur Unix possède un utilisateur appelé «root». C'est donc le cas pour Mac OS X. Root est le super-administrateur, qui a accès à n'importe quelle partie du système, et qui a le droit d'effectuer n'importe quelle opération. Par défaut, cet utilisateur est désactivé sur OS X, pour des raisons de sécurités évidentes. Pour effectuer notre installation, nous allons devoir l'activer. Pour cela, ouvrez le programme Gestionnaire NetInfo, qui se trouve dans /Applications/Utilitaires/.

Dans le menu «Sécurité», cliquez sur«Activer l'utilisateur root». Vous allez obtenir un écran comme celui-ci:

Entrez un mot de passe, puis cliquez sur OK. Nous pouvons maintenant accéder à toutes les fonctionnalités du système.

Sauvegardes¶

Si vous possédez des fichiers importants sur votre disque dur, je vous conseille de créer une sauvegarde complète dans un endroit sûr. Les opérations que nous allons effectuer pourraient en effet faire planter votre ordinateur en cas d'erreur. Pour éviter ce genre de désagréments, vous pouvez utiliser des programmes gratuits, comme l'excellent CarbonCopyCloner ( http://www.bombich.com/software/ccc.html ), qui est simple d'utilisation, et très puissant.

Copier & Coller¶

Faites toujours des copier-coller des commandes et des codes que vous trouverez dans ce manuel, afin d'éviter une faute de frappe.

Manuels Unix¶

Si vous avez des doutes au sujet d'une commande, vous pouvez toujours taper «man» suivi de la commande, dans le terminal. Vous obtiendrez alors un manuel complet de la fonction désirée, avec les paramètres nécessaires, ainsi que des exemples d'utilisation.

Questions¶

Si vous avec des questions concernant ce manuel, vous pouvez toujours me contacter par courrier électronique (info@macmade.net), ou me trouver sur les forums de Typo3 France ( http://www.typo3.fr/forum/ ). Veuillez indiquer dans votre message une description de votre problème, ainsi qu'un résumé de la configuration actuelle de votre machine.

Lancer le terminal¶

Mac OS X est un système basé sur Unix. Cela veut dire que, sous l'aspect fluide et simple de l'interface Aqua, se cache une puissance terrible, qui fait de Mac OS X un système merveilleux. En fait, Unix constitue le premier niveau de Mac OS X. Même si vous ne le connaissez pas, même si vous ne le voyez pas, tout ce que vous faites sur votre Mac est rendu possible par cette base Unix. Pour le constater, ouvrez l'application Terminal, qui se trouve dans /Applications/Utilitaires/.

Ne craignez rien. Il est vrai qu'il ne s'agit pas là d'une interface utilisateur très conviviale. Mais souvenez-vous qu'il n'y a absolument aucune raison pour que cela le soit. Le but de ce programme est en effet de créer une interface robuste entre la base Unix du système et vous. N'importe quelle commande tapée dans le terminal sera d'abord interprétée, puis exécutée par le système. Vous pouvez théoriquement faire n'importe quoi avec le terminal, même détruire votre propre machine, à condition de connaître les commandes nécessaires. Gardez donc à l'esprit qu'il ne s'agit pas d'un jouet, et que vous ne serez pas avertis en cas d'erreur. Nous ne sommes pas sur un système Microsoft, et nous en sommes vraiment sûr...

Voici mon propre terminal en pleine action. Le votre sera sans doute un peu différent. Maintenant, je vais vous guider dans les bases du shell Unix.

Les bases¶

Vous allez tout d'abord remarquer une phrase disant «Welcome to Darwin». Darwin est le nom de code du noyau Unix de Mac OS X, basé sur les systèmes BSD. Ensuite, vous devriez avoir quelque chose du genre:

cube:~ macmade$

On appelle cela le «prompt». Tout d'abord, cela indique que vous vous trouvez sur une machine appelée «cube» (en l'occurrence, ma machine adorée) et que vous travaillez actuellement dans le répertoire «~», qui est votre dossier de départ (dans /Utilisateurs/). Ensuite vient le nom de l'utilisateur exécutant la session. Finalement, le signe dollar vous indique que vous utilisez bash (Bourne Again Shell), qui est le shell par défaut sous Mac OS X. Maintenant, vous pouvez vous exercer à taper quelques commandes. Par exemple:

ls

Validez avec la touche enter. Le résultat sera le suivant:

Desktop   Documents Library   Movies    Music     Pictures  Public    Sites

La commande ls (list) produit une liste de tous les fichiers et dossiers dans le répertoire courant. Maintenant, essayez ceci:

ls -al /

Cette fois, le résultat est différent. Avec la commande ls, nous avons passé deux options, ainsi qu'un argument. Les options sont passées grâce au signe «-», et peuvent être combinées. Elles déterminent comment la commande doit réagir. Dans cette exemple, nous avons demandé à la machine de produire une liste détaillée (l), en incluant également les fichiers cachés (a). L'argument / indique à la commande qu'elle doit produire une liste de votre disque dur, à la place du répertoire courant. Chaque commande peut avoir des options et des arguments. Lisez la section concernant les commandes pour de plus amples détails.

Session root¶

Dans une section précédente de ce manuel, nous avons activé l'utilisateur root. Nous pouvons donc maintenant avoir un contrôle total du système via le terminal. Tapez ceci:

su

Le mot de passe que vous avez défini précédemment vous sera demandé. Remarquez qu'après avoir été authentifié, le prompt a changé. Vous êtes maintenant connecté en tant que root. Pour revenir à votre session utilisateur, tapez «exit». Certaines des commandes que nous allons utiliser vont avoir besoin des privilèges root, mais vous n'aurez pas besoin à chaque fois d'ouvrir une session root. Vous pouvez très bien exécuter une seule commande en tant que root, depuis votre session utilisateur. Essayez ceci:

sudo ls -al

La commande ls a été exécutée avec les privilèges root, mais après cela, vous vous trouvez toujours dans votre propre session. Il s'agit là d'un moyen beaucoup plus sûr pour effectuer une opération nécessitant des droits spéciaux, puisque vous n'accéder complètement au système que pour le temps nécessaire à la commande.

Commandes utiles¶

Vous allez trouver ici quelques commandes que nous allons utiliser dans ce manuel. Vous n'avez pas besoin de les apprendre par coeur. Il s'agit simplement d'une petite référence, pour vous aider à comprendre les opérations que vous aller effectuer. Veuillez également noter qu'il ne s'agit pas là d'une référence exhaustive des commandes. Pour obtenir cela, tapez man suivi de la commande, dans le terminal.

pico fichier

chown [paramètres optionnels] propriétaire:groupe fichier

-R

Recursive

Permission de lecture      (R) - 4
Permission d'écriture      (W) - 2
Permission d'exécution     (X) - 1

chmod [paramètres optionnels] permissions fichier

-R

Recursive

ls [paramètres optionnels] [répertoire optionnel]

-a

All

-c

Changed

-l

Long

-n

Numeric

cd répertoire

cp [paramètres optionnels] fichier destination

-R

Recursive

-f

Force

-p

Preserve

-v

Verbose

mv [paramètres optionnels] fichier destination

-f

Force

-v

Verbose

ln [paramètres optionnels] fichier lien

-s

Symbolic

mkdir [paramètres optionnels] répertoire

-m

Mod

rm [paramètres optionnels] fichier

-d

Directory

-f

Force

-R

Recursive

-v

Verbose

Activer le serveur¶

Mac OS X est livré avec un serveur Apache 1.3 prêt à l'emploi. Nous n'aurons donc pas besoin de l'installer, mais uniquement de l'activer. Pour cela, ouvrez les Préférences Système (dans le menu pomme) et allez dans la section Partage. Vous obtiendrez une fenêtre comme ceci:

Vous voyez ici toutes les options de partage et les protocoles disponibles avec OS X. Celui qui nous intéresse est «Partage Web Personnel». En l'activant, vous lancerez le serveur Apache.

Votre machine est maintenant accessible via le protocole HTTP. Pour le vérifier, ouvrez votre navigateur favori, est accédez à l'adresse http://127.0.0.1/ ou http://localhost/. Il s'agit là des adresses locales de votre serveur, accessible uniquement depuis votre Macintosh. Pour savoir comment accéder au serveur depuis l'extérieur, veuillez lire le chapitre suivant, sur le réseau.

Commandes Apache¶

Apache est fourni avec un programme accessible via le terminal, qui sert à contrôler et à tester l'environnement du serveur. Le nom de ce programme est «apachectl», pour Apache Control. Vous trouverez ci- dessous une brève descriptions de ses fonctionnalités. Vous avez besoin de privilèges spéciaux pour y accéder. Utilisez donc sudo avant de l'invoquer. La syntaxe par défaut est:

apachectl fonction

start

stop

restart

graceful

status

fullstatus

configtest

Configuration¶

Maintenant que le serveur Apache est actif, nous allons examiner le fichier de configuration. Ce fichier se nomme httpd.conf, et se trouve dans le répertoire /etc/httpd/. Ce répertoire, comme de nombreux autres utilisés par le système, est caché. Vous ne pouvez donc pas le voir dans le Finder.

D'abord, depuis le terminal, accédez au répertoire de configuration d'Apache:

cd /etc/httpd/

Nous allons, avant de poursuivre, effectuer une copie de sécurité de ce fichier:

sudo cp httpd.conf httpd.conf.save

Après cela, nous allons ouvrir le fichier avec pico. Vous devez utiliser sudo, afin d'enregistrer toute modification, puisque ce fichier appartient à l'utilisateur root:

sudo pico httpd.conf

Etudions maintenant le contenu du fichier. A la ligne 63, vous trouverez ceci:

ServerRoot "/usr"

Cela indique que les fichiers de base d'Apache se trouvent dans /usr/local/. Ensuite, à la ligne 190, vous verrez ceci:

# Dynamic Shared Object (DSO) Support

Cette ligne est un commentaire (précédée par le signe #). Elle ne sera donc pas interprétée par Apache. La section DSO est très importante. Après les commentaires, vous verrez une série d'instructions:

#LoadModule    vhost_alias_module    libexec/httpd/mod_vhost_alias.so
#LoadModule    env_module            libexec/httpd/mod_env.so
LoadModule     config_log_module     libexec/httpd/mod_log_config.so
[...]
#AddModule     mod_vhost_alias.c
#AddModule     mod_env.c
AddModule      mod_log_config.c
[...]

Vous remarquerez que certaines de ces lignes sont également des commentaires. L'instruction LoadModule indique à Apache de charger un module additionnel. En d'autres termes, cela ajoute des fonctionnalités à Apache. L'instruction AddModule est complémentaire à LoadModule. Seules les lignes qui ne sont pas commentées seront exécutées par Apache. Donc seuls les modules correspondants seront chargés. Pour en activer un autre, il suffit d'ôter le signe # dans les deux instructions correspondant au module en question.

C'est précisément ce que nous allons faire maintenant. Nous allons ajouter certains modules, requis pour le fonctionnement d'un CMS comme Typo3. Activez donc les lignes suivantes, en effaçant le signe #:

#LoadModule    status_module     libexec/httpd/mod_status.so
#LoadModule    info_module       libexec/httpd/mod_info.so
[...]
#LoadModule    rewrite_module    libexec/httpd/mod_rewrite.so
[...]
#LoadModule    perl_module       libexec/httpd/libperl.so
#LoadModule    php4_module       libexec/httpd/libphp4.so
[...]
#AddModule     mod_status.c
#AddModule     mod_info.c
[...]
#AddModule     mod_rewrite.c
[...]
#AddModule     mod_perl.c
#AddModule     mod_php4.c

Et voilà. Nous avons activé l'utilisation de Perl et de PHP sur notre serveur, ainsi que les modules permettant d'obtenir des informations sur Apache, qui sont utilisés, par exemple, par la commande «apachectl status». Nous avons également activé le module permettant la réécriture d'URLs. Vous verrez pourquoi dans la chapitre concernant Typo3.

Ensuite vient la configuration du serveur principal («Main Server»). Vous trouverez, aux lignes 330 et 331:

User www
Group www

www est l'utilisateur qui exécutera les opérations d'Apache. C'est un élément important à retenir, pour le chapitre concernant l'installation de Typo3. Plus loin, à la ligne 363, vous verrez cela:

DocumentRoot "/Library/WebServer/Documents"

Il s'agit de l'endroit où vont se trouver les documents accessibles depuis internet. Nous allons changer cette ligne, pour utiliser un autre endroit. Certaines mises à jour du système vont en effet modifier des fichiers Apache. Nous n'allons donc pas utiliser l'emplacement par défaut, pour éviter tout risque de problème:

DocumentRoot "/Library/Servers/Server-1/Documents"

Il va donc maintenant falloir créer ce nouvel emplacement. Dans une autre fenêtre du terminal, tapez:

sudo mkdir /Library/Servers /Library/Servers/Server-1 /Library/Servers/Server-1/Documents /Library/Servers/Server-1/CGI-Executables

Ensuite, nous allons attribuer les permissions correctes pour ces répertoires:

sudo chown -R your_username:www /Library/Servers
sudo chmod -R g+w /Library/Servers

Remplacez «your_username» par votre nom d'utilisateur court (celui qui figure dans le prompt). Revenons maintenant au fichier de configuration, à la ligne 388:

<Directory "/Library/WebServer/Documents">

Il nous faut également changer cette ligne, en tenant compte du nouvel emplacement (/Library/Servers/Server-1/Documents). L'instruction <Directory> indique une section de configuration de répertoire. En dessous, vous pourrez voir ceci:

Options Indexes FollowSymLinks MultiViews

Cette ligne configure les options du répertoire. Par exemple, l'option «Indexes» permet à Apache de produire une liste des fichiers, si aucune page index.html n'est trouvé. Pour désactiver cette option, ajoutez un signe moins juste avant:

Options -Indexes FollowSymLinks MultiViews

Plus loin, vous verrez ceci:

AllowOverride None

Vous allez devoir changer cette ligne en «AllowOverride All». Cela va activer l'utilisation de fichiers .htaccess à l'intérieur du répertoire /Library/Servers/Server-1/Documents/. Un fichier .htaccess peut contenir des instructions Apache, afin de configurer le serveur sans avoir à toucher le fichier de configuration principal. Nous utiliserons un tel fichier dans le chapitre sur Typo3. Juste après ceci, vous trouverez les lignes suivantes:

Order allow,deny
Allow from all

Nous n'avons pas besoin de changer ces lignes. Elles indiquent à Apache que tout le monde peut accéder aux fichiers contenus sur le serveur. Si vous désirez, par exemple, restreindre l'accès à votre seule machine, changez ces deux lignes ainsi:

Order deny,allow
Deny from all
Allow from 127.0.0.1

Vous pourrez trouver de plus amples détails sur les restrictions d'accès dans le manuel d'Apache. Plus loin, à la ligne 659, nous allons encore devoir changer la référence de l'emplacement du répertoire contenant les scripts CGI, comme nous l'avons fait précédemment:

<Directory "/Library/WebServer/CGI-Executables">

Ensuite, à la ligne 864:

#AddHandler cgi-script .cgi

Nous avons plus haut activé le module Perl. Nous devons donc maintenant activer cette ligne pour permettre l'exécution de scripts CGI, en enlevant le signe #. C'est tout pour l'instant. Vous pouvez sauvegarder le fichier de configuration en appuyant sur [ctrl-o] et le fermer en appuyant sur [ctrl-x]. Vous vous retrouverez alors de nouveau dans votre session shell. Pour que les changement soient pris en compte, il faut redémarrer Apache:

sudo apachectl graceful

Hébergement virtuel¶

Votre serveur est maintenant actif. Pour publier vos fichiers, placez les simplement dans /Library/Servers/Server-1/Documents/. Mais que se passe-t-il si vous avez besoin de plus d'un serveur?

Apache permet de faire de l'hébergement multiple. Cela veut dire que vous pouvez avoir autant de sites que vous le désirez sur votre serveur, chacun ayant sa propre racine web. Il y a plusieurs façons de réaliser ceci. Dans notre cas, nous allons utiliser une méthode appelée «hôtes virtuels basés sur le nom de domaine». En premier, copiez le répertoire /Library/Servers/Server-1/:

sudo cp -prf /Library/Servers/Server-1 /Library/Servers/Server-2

Maintenant, ouvrez à nouveau le fichier de configuration d'Apache. La section concernant les hôtes virtuels se trouve à la ligne 1029. Nous allons ajouter quelques lignes, juste après les commentaires:

NameVirtualHost *
Listen 80
<VirtualHost *:80>
DocumentRoot "/Library/Servers/Server-1/Documents"
</VirtualHost>

Nous ajoutons ici le premier serveur comme hôte virtuel. Remarquez l'instruction «Listen». Elle indique le port de l'hôte virtuel. 80 est le port par défaut du protocole HTTP. Nous allons maintenant ajouter un second serveur. Celui-ci ne peut pas se trouver sur le même numéro de port que le premier. Nous allons donc en utiliser un autre (9000). Du coup, pour accéder au second serveur depuis un navigateur, l'adresse sera http://127.0.0.1:9000/. Dans le fichier de configuration, ajoutez maintenant les lignes suivantes:

Listen 9000
<VirtualHost *:9000>
DocumentRoot "/Library/Servers/Server-2/Documents"
<Directory "/Library/Servers/Server-2/Documents">
Options -Indexes FollowSymLinks MultiViews
AllowOverride None
</Directory>
<IfModule mod_alias.c>
ScriptAlias /cgi-bin/ "/Library/Servers/Server-2/CGI-Executables/"
<Directory "/Library/Servers/Server-2/CGI-Executables">
AllowOverride None
Options None
</Directory>
</IfModule>
</VirtualHost>

Et voilà. Nous avons ajouté la configuration d'un nouveau serveur. Sauvegardez et fermez le fichier, puis redémarrez Apache pour conclure. Le second serveur est désormais opérationnel. Pour en ajouter encore d'autres, répétez simplement les opérations précédentes, en choisissant à chaque fois un numéro de port différent. Ne choisissez pas 9001, 9002, 9003, etc... Cela ne marchera pas. Il faut en effet un peu plus d'espace entre les ports, par exemple 9005, 9010, 9015, etc... Vous ne devriez également pas choisir un numéro en dessous de 9000, car de nombreux numéros correspondent déjà à des protocoles existants. Pour vérifier si un numéro est attribué ou non, vous pouvez consulter le site internet de l'IANA ( http://www.iana.org/assignments/port-numbers ).

Documentation¶

Pour obtenir d'autres informations, vous pourrez trouver le manuel complet du serveur web Apache sur le site de l'Apache Software Foundation ( http://httpd.apache.org/docs/ ).

Airport et les routeurs¶

Si vous êtes connecté à internet via Airport ou un modem/routeur, vous pourriez rencontrer des difficultés pour accéder à votre serveur nouvellement configuré depuis l'extérieur. En effet, toutes les requêtes sont bloquées par le routeur. Heureusement, il existe un moyen pour permettre des connections distantes.

Si vous utilisez Airport pour vous connecter, ouvrez simplement l'application «Utilitaire Admin Airport», qui se trouve dans /Applications/Utilitaires/, et connectez-vous sur votre borne. Ensuite, cliquez sur «Show All Settings», et allez dans la section «Port Mapping». Vous obtiendrez ceci:

Il vous suffit d'ouvrir les ports nécessaire. Prenons un exemple avec le port HTTP (utilisé pour internet). Le numéro de port correspondant est 80. Entrez ce numéro dans les champs «Public Port» et «Private Port». Ensuite, entrez le numéro IP de votre machine (qui peut être trouvée dans les Préférences Système, à la rubrique Réseau) dans le champ «Private Address».

Si vous mettez à jour votre station de base avec ces réglages, toutes les requêtes sur le port 80 de la borne seront redirigées vers le port 80 de votre machine. Donc, depuis l'extérieur, si vous vous connectez à l'adresse IP de la borne depuis un navigateur, vous atteindrez le serveur Apache de votre Macintosh.

La procédure est pareille si vous utilisez un modem/routeur. Connectez-vous à l'interface de configuration du routeur, et ajoutez les ports désirés, ainsi que votre adresse IP. Voici par exemple l'interface de mon propre routeur, un Netopia.

Vous pouvez ici définir une rangée de ports, mais si vous ne le voulez pas, entrez simplement le même port dans tous les champs. Reportez- vous au manuel de votre modem, ou à votre FAI pour en savoir d'avantage sur votre modèle spécifique.

Numéros de port¶

Vous trouverez dans cette section les ports habituels qui sont utilisés sur Mac OS X. Vous n'avez pas besoin de les ouvrir tous, mais si vous désirez atteindre un service particulier depuis l'extérieur, ajoutez simplement le numéro correspondant à la configuration de votre routeur. Pour accéder au serveur web, le seul port que vous devez ouvrir est le 80, plus les ports des hôtes virtuels, si vous en avez défini dans le chapitre précédent.

20

ftp-data

21

ftp

22

ssh

23

telnet

25

smtp

80

http

110

pop3

115

sftp

143

imap

443

https

548

afp

3306

mysql

Informations¶

Typo3 est capable de produire des éléments graphiques à la demande. Cette capacité est utilisée lors de la création de menus graphiques, d'aperçus, etc... Mais pour effectuer cela, Typo3 a besoin de programmes et de librairies Unix externes. Nous n'allons pas installer des versions prêtes à l'emploi de ces programmes, qui peuvent parfois être incomplètes ou incompatibles. Nous allons à chaque fois télécharger le code source, et le convertir en une version binaire exécutable. Cette opération est appelée compilation. Parfois, cela peut prendre un certain temps, mais c'est une partie assez agréable. Vous verrez en effet votre Macintosh travailler tout seul. L'ordre d'installation est TRÈS important, car certains des programmes que nous allons installer ont des dépendances. Cela veut dire que nous ne pourrons pas en installer un, si un autre n'est pas déjà présent sur le système. Respectez donc attentivement l'ordre d'installation de ce manuel.

Note à propos de la compilation¶

Sur les systèmes Unix, la compilation d'un programme se passe généralement de la manière suivante:

Télécharger et décompresser le code source.

Ouvrir une session shell.

Obtenir les privilèges root.

Cd dans le répertoire contenant la source du programme.

Configurer le processus de compilation:

./configure [paramètres optionnels]

Lancer la compilation:

make

Installer les fichiers:

make install

Lorsque la commande make install est terminée, vous pouvez effacer le répertoire contenant le code source. Si vous désirez obtenir tous les paramètres de compilation disponibles, tapez ./configure --help, à l'intérieur du répertoire source.

Lib JPEG¶

cp -f /usr/share/libtool/config.* ./
./configure --enable-static --enable-shared
make
make install

Lib PNG¶

12
13
14
15

ZLIBLIB=/usr/lib
ZLIBINC=/usr/include
#ZLIBLIB=../zlib
#ZLIBINC=../zlib

24

LDFLAGS=-L. -L$(ZLIBLIB) -lpng -lz

119
120
121
122
123
124
125

ln -f -s libpng.3.$(PNGMIN).$(SHAREDLIB_POSTFIX) \
libpng.3.$(SHAREDLIB_POSTFIX); \
ln -f -s libpng.3.$(SHAREDLIB_POSTFIX) libpng.$(SHAREDLIB_POSTFIX); \
ln -f -s $(LIBNAME).$(PNGVER).$(SHAREDLIB_POSTFIX) \
libpng.$(SHAREDLIB_POSTFIX); \
ln -f -s libpng.3.$(PNGMIN).$(SHAREDLIB_POSTFIX) \
libpng.3.$(SHAREDLIB_POSTFIX); \

94
95

#-@/bin/rm -f $(DI)/png.h $(DI)/pngconf.h
#-@/bin/rm -f $(DI)/libpng

102

#-@/bin/rm -f $(DL)/libpng.a

108

#-@/bin/rm -f \

110
111
112
113

#-@/bin/rm -f $(DL)/$(LIBNAME).$(SHAREDLIB_POSTFIX)
#-@/bin/rm -f libpng.$(SHARED_POSTFIX)
#-@/bin/rm -f libpng.3.$(SHARED_POSTFIX)
#-@/bin/rm -f libpng.3.$(PNGMIN)*.$(SHARED_POSTFIX)

131
132

#-@/bin/rm -f $(DL)/pkgconfig/$(LIBNAME).pc
#-@/bin/rm -f $(DL)/pkgconfig/libpng.pc

140
141

#-@/bin/rm -f $(DM)/man3/libpng.3
#-@/bin/rm -f $(DM)/man3/libpngpf.3

145

#-@/bin/rm -f $(DM)/man5/png.5

150
151

#-@/bin/rm -f $(DB)/libpng-config
#-@/bin/rm -f $(DB)/$(LIBNAME)-config

Lib TIFF¶

FreeType¶

19
20
21
22
23
24
25

//#ifndef FT_FREETYPE_H
//#error "`ft2build.h' hasn't been included yet!"
//#error "Please always use macros to include FreeType header files."
//#error "Example:"
//#error "  #include <ft2build.h>"
//#error "  #include FT_FREETYPE_H"
//#endif

GNU GhostScript¶

ImageMagick¶

./configure --enable-shared

GD¶

Informations¶

Les librairies qui vont suivre ne sont pas requises pour une installation de base de Typo3. Elles sont en fait utilisées par des extensions, comme Indexed Search Engine, ou PDF Generator. Comme ces extensions sont utilisées sur la plupart des sites Typo3, je vais vous donner les instruction nécessaire pour installer les librairies qu'elles utilisent.

CatDoc¶

XPDF¶

./configure --with-freetype2-library=/usr/local/lib --with-freetype2-includes=/usr/local/include/freetype2 --enable-a4-paper

HTML Doc¶

./configure --prefix=/usr/local --without-gui

GNU Aspell¶

Informations¶

Nous allons maintenant installer le système de bases de données relationnel MySQL, qui contiendra toutes les tables utilisées par Typo3. MySQL n'est pas fourni de base avec Mac OS X. Par contre, OS X a déjà un utilisateur système permettant d'exécuter le serveur MySQL. La distribution officielle est, de plus, composée d'exécutables. Nous n'aurons donc pas besoin de compiler MySQL.

Installation¶

cp -prf Desktop/mysql-4.0.x-apple-darwin6.6-powerpc /usr/local/mysql

./scripts/mysql_install_db

chown -R mysql /usr/local/mysql/*

./bin/safe_mysqld --user=mysql &

/usr/local/mysql/bin/mysqladmin -u root password your_password

Configuration¶

#!/bin/sh
. /etc/rc.common
if [ "${MYSQL:=-YES-}" = "-YES-" ]; then
ConsoleMessage "Starting MySQL"
cd /usr/local/mysql/
if [ -e ./bin/safe_mysqld ]
then
./bin/safe_mysqld --user=mysql &
elif [ -e ./bin/mysqld_safe ]
then
./bin/mysqld_safe --user=mysql &
else
ConsoleMessage "MySQL not found"
fi
fi

{
Description   = "MySQL";
Provides      = ("MySQL");
Requires      = ("Resolver");
Preference    = "Late";
Messages =
{
start = "Starting MySQL";
stop  = "Stopping MySQL";
};
}

sudo chown -R root:admin /Library/StartupItems/MySQL/
sudo chmod 755 /Library/StartupItems/MySQL/MySQL

cd /var/root/
pico .profile

export PATH=$PATH:/usr/local/bin:/usr/local/mysql/bin

cp .profile /Users/your_username/

Commandes MySQL¶

Vous trouverez ici un résumé des commandes MySQL de base. Cette liste n'est pas exhaustive. Reportez-vous au manuel de MySQL pour de plus amples détails à propos de ces commandes.

sudo mysql -p

sudo mysql -p databasename < mysqlfile.sql

sudo mysqladmin -p commande

create databasename

drop databasename

extended-status

ping

processlist

reload

refresh

shutdown

status

version

sudo mysqldump -p [optional params] databasename > mysqlfile.sql

-A

All DB

-a

All

-B

Databases

-c

Complete

-d

Data

-e

Extended

-l

Lock

-q

Quick

-t

Tab

--opt

Création d'une base de données¶

Nous sommes maintenant prêts à créer la base de données qui sera utilisée par Typo3. Dans le terminal, tapez:

sudo mysqladmin -p create typo3

Dans cet exemple, nous avons choisi typo3 comme nom de base de données. Vous pouvez bien sûr en utiliser un autre.

Création d'un utilisateur¶

Nous allons également créer un utilisateur, et l'associer à notre nouvelle base de données. N'utilisez jamais l'utilisateur MySQL root pour une application internet. Créez en toujours un nouveau. Cela s'effectue ainsi, dans mysql (sudo mysql -p):

GRANT ALL ON typo3.* TO username@localhost IDENTIFIED BY 'userpassword';

L'instruction GRANT donne à un utilisateur des privilèges sur une base de données spécifique. Lisez le manuel de MySQL pour de plus amples explications sur cette instruction.

Administration¶

Nous pourrions utiliser le terminal pour toutes les opérations MySQL, mais il existe des moyens plus simples. Nous allons ici installer PHPMyAdmin, qui est un outil d'administration écrit en PHP. Il nous offrira une interface graphique beaucoup plus conviviale pour administrer nos bases de données et nos tables. Connectez-vous donc sur le site de PHPMyadmin ( http://www.phpmyadmin.net/ ), et téléchargez la dernière version stable.

[...]
$cfg['PmaAbsoluteUri'] = 'http://127.0.0.1/phpmyadmin/';
[...]
$cfg['Servers'][$i]['auth_type']     = 'http';

Documentation¶

Pour obtenir d'avantage d'informations sur le système de bases de données relationnel MySQL, vous pouvez vous connecter sur le site internet de MySQL AB ( http://dev.mysql.com/doc/ ), pour y trouver le manuel complet.

Informations¶

Nous avons maintenant compilé et installé tous les programmes et librairies nécessaires à l'utilisation de Typo3. Mais il nous reste encore à recompiler PHP, pour que ces changements soient disponibles. En effet, Typo3 utilise la plupart de ces programmes via l'API PHP. Apple fournit avec son système une distribution basique de PHP. Nous allons donc en créer une autre, plus appropriée à nos besoins. Nous laisserons l'installation d'Apple en place, pour éviter des problèmes lors de mises à jour du système. Nous nous contenterons de la désactiver, et nous mettrons notre propre version à un autre endroit.

Installation¶

sudo mv /usr/libexec/httpd/libphp4.so /usr/libexec/httpd/libphp4.so.save

./configure --prefix=/usr/local/php --with-config-file-path=/usr/local/php --with-apxs --with-ldap=/usr --with-kerberos=/usr --enable-cli --with-zlib-dir=/usr --enable-trans-sid --with-xml --enable-exif --enable-ftp --enable-mbstring --enable-dbx --enable-sockets --with-iodbc=/usr --with-curl=/usr --with-tiff-dir=/usr/local --with-gd --with-png-dir=/usr/local --with-jpeg-dir=/usr/local --with-freetype-dir=/usr/local --enable-gd-native-ttf --enable-gd-imgstrttf

+--------------------------------------------------------------------+
| License:                                                           |
| This software is subject to the PHP License, available in this     |
| distribution in the file LICENSE.  By continuing this installation |
| process, you are bound by the terms of this license agreement.     |
| If you do not agree with the terms of this license, you must abort |
| the installation process at this point.                            |
+--------------------------------------------------------------------+
|                          *** NOTE ***                              |
|            The default for register_globals is now OFF!            |
|                                                                    |
| If your application relies on register_globals being ON, you       |
| should explicitly set it to on in your php.ini file.               |
| Note that you are strongly encouraged to read                      |
| http://www.php.net/manual/en/security.registerglobals.php          |
| about the implications of having register_globals set to on, and   |
| avoid using it if possible.                                        |
+--------------------------------------------------------------------+

Thank you for using PHP.

cp php.ini-* /usr/local/php/

Configuration¶

Nous allons maintenant configurer notre installation. Nous avons copié deux fichiers dans le répertoire PHP: php.ini-dist et php.ini- recommended. Ces fichiers sont des exemples de configuration. Le premier contient une configuration basique, et le second, une configuration recommandée. Nous allons choisir, dans ce cas là, la version recommandée, et l'optimiser un peu pour Typo3. Commençons par la copier:

sudo cp /usr/local/php/php.ini-recommended /usr/local/php.ini

Ouvrez maintenant ce fichier dans un éditeur texte. A la ligne 89, vous verrez ceci:

short_open_tag = On

Il n'est pas nécessaire de mettre cette directive sous «Off», mais il est fortement recommandé de le faire. Cela affectera la façon de déclarer un script PHP. Si vous la désactivez, vous ne pourrez plus utiliser des balises courtes (<? ?>).

Ensuite, à la ligne 167:

allow_call_time_pass_reference = Off

Avec cette directive sous «Off», il est impossible de forcer une variable à être passée par référence lorsque vous appelez une fonction. Ce réglage est correct pour Typo3, et ne doit en aucun cas être changé.

Plus loin, à la ligne 208, une directive très importante:

;open_basedir =

Cette directive est commentée (avec le signe ;). Elle est donc inactive. Elle contrôle les endroits de votre disque auxquels PHP pourra accéder. Sans elle, PHP peut accéder à l'entier du disque. Il vaut donc mieux l'activer, et ajouter des chemins d'accès (chaque chemin étant séparé par le signe :), comme dans l'exemple ci-dessous:

open_basedir = /Library/Servers/:/usr/bin/:/usr/sbin/:/usr/local/bin/:/var/tmp/

Maintenant, à la ligne 240:

;;;;;;;;;;;;;;;;;;;
; Resource Limits ;
;;;;;;;;;;;;;;;;;;;

max_execution_time = 30     ; Maximum execution time of each script, in seconds
max_input_time = 60         ; Maximum amount of time each script may spend parsing request data
memory_limit = 8M           ; Maximum amount of memory a script may consume (8MB)

Ces lignes contrôlent les ressources attribuées à PHP. Pour Typo3, nous allons devoir augmenter la limite de mémoire à au moins 16M. Vous devriez également augmenter le temps maximum d'exécution à 60.

Ensuite, à la ligne 285:

error_reporting  =  E_ALL

Cette ligne contrôle les erreurs PHP qui seront affichées. Vous devriez désactiver les avertissements:

error_reporting  =  E_ALL & ~E_NOTICE

De cette manière, vous ne serez pas averti lors d'une «erreur» de ce type, qui peut parfaitement être intentionnelle.

Vous devriez également activer l'affichage des erreurs PHP, afin d'être informé lorsque vous avez un bug dans un script. Cela se passe à la ligne 292, en écrivant «On» à la place de «Off»:

display_errors = Off

Toujours plus loin, à la ligne 369:

variables_order = "GPCS"

Cette directive est aussi importante. Les variables d'environnement ne seront pas définies dans le tableau $HTTP_ENV_VARS[], et ce pour des raisons de performance. Ce réglage est correct pour Typo3, et ne devrait jamais être modifié.

Ensuite, à la ligne 380:

register_globals = Off

Le réglage est également correct. N'utilisez jamais la fonctionnalité register_globals dans vos scripts PHP. Cela améliore à la fois la sécurité et les performances.

Même chose à la ligne 397:

register_argc_argv = Off

Et finallement, aux lignes 397 et 400:

magic_quotes_gpc = Off
magic_quotes_runtime = Off

Il est important pour Typo3 que ces deux directives soient sous «Off».

Vous pourriez également avoir envie d'augmenter la taille maximale des fichiers uploadés. C'est possible à la ligne 501:

upload_max_filesize = 2M

Votre nouvelle installation de PHP est maintenant configurée. Il ne reste plus qu'à redémarrer Apache pour que ces changements soient effectifs.

Documentation¶

Vous pouvez obtenir le manuel complet et de la documentation supplémentaire sur PHP sur le site internet du groupe PHP ( http://www.php.net/manual/ ).

Installation¶

sudo chown -R your_username:www /Library/Servers/
sudo chmod -R g+w /Library/Servers/

rm typo3_src

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

Note à propos des navigateurs internet¶

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

Configuration¶

http://localhost/

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!

44

45


46

//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!");
//}

[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

[sitename]                   The name of your website
[encryptionKey]              Just enter some random text
[curlUse]                    1
[binPath]                    /usr/bin/,/usr/local/bin/

[unzip_path]                 /usr/bin/
[lockRootPath]               Your server's document directory
                             (eg. /Library/Servers/Server-1/Documents)

[simulateStaticDocuments]    1

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

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

RewriteEngine On
RewriteCond %{REQUEST_FILENAME} !-f
RewriteRule ^[^/]*\.html$ index.php
RewriteRule ^[^/]*\.pdf$ index.php

Documentation¶

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.

((generated))¶