TYPO3 Enterprise CMS sur un serveur ISPConfig en 10 étapes faciles

Version 2.0
Auteur : [at] bb-hosting [dot] org>

TYPO3 est un CMS avancé de classe entreprise.
J'ai écrit ce "comment faire" pour ceux qui veulent exécuter ce CMS sur leur serveur ISPConfig.
Vous pouvez probablement configurer TYPO3 de différentes manières, mais je préfère la manière décrite ici.
Je suppose également qu'il s'agit de votre première configuration TYPO3 et que vos sites Web sont stockés sous /var/www/

Dans ce guide, je vais utiliser juste comme exemple :
- Une installation TYPO3 version 4.2.0
- Site Web :www.mytypo3website.tld
- Base de données MySQL :webdb1
- Nom d'utilisateur MySQL :web1u1
- Nom d'utilisateur FTP (administrateur pour le site Web) :webadmin

Montrons de quoi notre serveur ISPConfig est capable, c'est parti :

ÉTAPE 1 - Créer un site Web :

Dans ISPConfig, créez un site Web via "Nouveau site" dans le menu principal.
Sur l'onglet intitulé "Base", utilisez www pour le nom d'hôte et mytypo3website.tld pour le nom de domaine. Activez les scripts MySQL et PHP pour ce site Web, mais désactivez le mode sans échec PHP.

ÉTAPE 2 - Créez un utilisateur administrateur pour le site Web :

Dans ISPConfig, créez un utilisateur administrateur afin de pouvoir charger/télécharger le site Web ultérieurement via FTP :
Dans le menu principal, sélectionnez "ISP Manager", sélectionnez votre nouveau site Web appelé mytypo3website.tld dans l'arborescence et appuyez sur l'onglet "Utilisateur et e-mail".
Appuyez sur "nouveau" et définissez un nouvel utilisateur avec le nom "webadmin" et son adresse e-mail. Donnez à cet utilisateur les droits d'administrateur et appuyez sur "Enregistrer".

ÉTAPE 3 - Créez une base de données MySQL pour le site Web :

Cliquez sur l'onglet "Options" et créez une nouvelle base de données pour le site Web.
ISPConfig vous montrera :

Nom de la base de données :web1db1
Utilisateur de la base de données :web1u1

Ensuite, vous définissez un mot de passe pour l'utilisateur de la base de données et appuyez sur "Enregistrer".

ÉTAPE 4 - Téléchargez/extrayez les packages et supprimez les fichiers tar.gz :

cd /var/www/web1/web/

Téléchargez les sources de la version 4.2.0 de TYPO3

wget http://surfnet.dl.sourceforge.net/sourceforge/typo3/typo3_src-4.2.0.tar.gz

(À ce stade, choisissez votre emplacement de téléchargement le plus proche sur Sourceforge).

Téléchargez le mannequin TYPO3 version 4.2.0 :

wget http://surfnet.dl.sourceforge.net/sourceforge/typo3/dummy-4.2.0.tar.gz

(À ce stade, choisissez votre emplacement de téléchargement le plus proche sur Sourceforge).

Décompressez les fichiers téléchargés :

tar xvfz typo3_src-4.2.0.tar.gz
tar xvfz dummy-4.2.0.tar.gz

Supprimez les fichiers tar.gz :

rm *.tar.gz

ÉTAPE 5 - Déplacez le contenu factice vers le répertoire Web et supprimez le répertoire vide :

cd dummy-4.2.0
mv * ../
cd ../
rmdir dummy-4.2.0

Vous pouvez avoir plusieurs installations TYPO3 avec un seul paquet source.
Créez donc un répertoire source global pour TYPO3 version 4.2.0, déplacez-y la source TYPO3 et supprimez le répertoire vide :

mkdir /var/www/typo3_src-4.2.0
cd typo3_src-4.2.0
mv * /var/www/typo3_src-4.2.0/
cd ../
rmdir typo3_src-4.2.0

ÉTAPE 6 - Définissez la propriété et les autorisations :

(N'oubliez pas que web1 et administrateur Web ne sont qu'un exemple pour le numéro de site Web et l'administrateur)

cd /var/www/web1/
chown -R -v -f webadmin:web1 web/
cd /var/www/web1/web/
chgrp -R www-data fileadmin typo3conf typo3temp uploads
chmod -R g+w,o-rwx fileadmin typo3conf typo3temp uploads

ÉTAPE 7 – Créez un lien symbolique :

Créez un lien symbolique entre la source TYPO3 version 4.2.0 et le typo3_src dans votre site :
Premièrement, supprimez le fichier typo3_src vide :

rm typo3_src

puis entrez la commande :

ln -s /var/www/typo3_src-4.2.0 /var/www/web1/web/typo3_src

Comme vous le voyez, différentes installations TYPO3 (éventuellement avec différents domaines) peuvent utiliser le même paquet source TYPO3. Vous pouvez même changer le paquet source simplement en changeant le lien symbolique dans le répertoire d'installation.

ÉTAPE 8 - Activez l'outil d'installation TYPO3 :

Si vous pointez vers votre nouveau site Web TYPO3 http://mytypo3website.tld, vous remarquerez que vous ne pouvez pas procéder à l'installation, car l'outil d'installation de TYPO3 a été verrouillé pour des raisons de sécurité. Pour activer l'outil d'installation, vous devez créer un fichier texte vide avec le nom "ENABLE_INSTALL_TOOL" dans le répertoire /var/www/web1/web/typo3/typo3conf.

ÉTAPE 9 – Démarrer l'outil d'installation de TYPO3 :

Dans votre navigateur préféré, pointez sur http://mytypo3website.tld où vous verrez l'outil d'installation de TYPO3 1-2-3.

Remplissez les champs avec :

Nom d'utilisateur :web1u1
Mot de passe :Mot de passe MySQL tel que défini dans ISPConfig
Nom d'hôte :localhost

Suivez les instructions de l'outil d'installation TYPO3 1-2-3.

Après l'étape 3 (dans l'outil d'installation) et pour des raisons de sécurité, vous devez changer le mot de passe par défaut pour l'outil d'installation TYPO3 et le mot de passe administrateur, qui est nécessaire pour le backend du CMS. Après tout, n'oubliez PAS de supprimer le fichier "ENABLE_INSTALL_TOOL" dans le répertoire /var/www/web1/web/typo3/typo3conf, qui est nécessaire pour verrouiller à nouveau le programme d'installation de TYPO3 !

ÉTAPE 10 – Modifiez les limites de ressources dans votre fichier PHP.ini :

Probablement, cette dernière étape n'est nécessaire que si vous avez des erreurs de mémoire php ou si TYPO3 ne fonctionne pas correctement.
Connectez-vous en tant que root sur votre serveur ISPConfig et modifiez le fichier /etc/php4/ apache2/php.ini
Donnez aux ressources les limites suivantes :

max_execution_time =60
max_input_time =60
memory_limit =64M
post_max_size =12M

Après avoir modifié votre fichier php.ini vous devez redémarrer Apache avec la commande :

/etc/init.d/apache2 restart

Remarque :
L'emplacement de votre fichier php.ini est destiné aux systèmes Debian Linux.
La façon dont vous redémarrez Apache2 et l'emplacement de votre fichier php.ini peuvent être différents sur d'autres distributions Linux.

Important :
Vous ne pouvez pas utiliser php5-cgi+suPHP pour votre site Web TYPO3 car il entre en conflit avec le mécanisme suPHP. Pour que votre site TYPO3 soit opérationnel, procédez comme suit :
Connectez-vous à votre serveur en tant que root et activez le module php5 pour Apache2 :

a2enmod php5

Redémarrez Apache2 avec :

/etc/init.d/apache2 force-reload

Dans ISPConfig, désactivez PHP pour le site Web TYPO3 et ajoutez ce qui suit dans le champ des directives Apache pour votre site TYPO3 :

AddType application/x -httpd-php .php .php3 .php4 .php5
php_admin_flag safe_mode Off

(Où « web1 » est votre propre numéro Web fourni par ISPConfig)

Maintenant, votre serveur ISPConfig avec Debian Etch, utilise PHP5-mod pour votre site TYPO3 au lieu de php5-cgi+suPHP.