Ce document traite de l'administration de sites TYPO3, en mettant l'accent sur les bases de la mise en place, la gestion via des outils comme 'superadmin', et le nettoyage des bases de données avec l'extension 'lowlevel'. Il décrit les procédures pour installer et configurer l'outil 'superadmin.php' ainsi que les opérations de nettoyage possibles de la base de données. Des instructions détaillées sont fournies pour exécuter des scripts en ligne de commande pour analyser et corriger les problèmes dans les installations TYPO3.

1. Administration d'un site TYPO3
Yannick Pavard

2. Partie 2 : Administrer un ou plusieurs sites TYPO3
 Principes de base pour la mise en place d’un site TYPO3
 Administrer un site TYPO3 via l’outil d’installation et de
configuration
 « Superadmin » un outil pour gérer vos instances TYPO3
 Nettoyer votre base de données avec l’extension “lowlevel”

3. Administrer un ou
plusieurs sites
TYPO3

4. Principes de base pour la mise en place d’un site TYPO3
Serveur web (Apache / IIS)
Fichiers du site
« dummy 4.2.9 »
Source 4.2.9
« core » Fichiers du site
« dummy 4.2.9 »
Fichiers du site
Source 4.3 « dummy 4.3 »
« core »
Fichiers du site
« dummy 4.3 »

5. « InstallTool » pour l'installation, l'entretien
et la mise à jour d'un site réalisé avec TYPO3
1: Basic Configuration : Vérifier la configuration de TYPO3 et du serveur
2: Database Analyser : Mettre à jour votre base de données lors des mises à jour majeures
3: Update Wizard : Mise à jour de votre site (bdd, extension, fichiers …) lors d'une mise à jour majeure
4: Image Processing : Vérifier la configuration de ImageMagick et de la librairie GD
5: All Configuration : Configuration avancée (utf8, 404, permissions, ...)
6: typo3temp/ : Nettoyer le contenu du répertoire temporaire
7: Clean up database : Vider le cache (des images par exemple)
8: phpinfo() : Vérifier la configuration du PHP
9: Edit files in typo3conf/ : Éditer les fichiers de configuration
10: About : Changer le mot de passe d'accès à « l'installTool »
Accès : http://www.siteweb.com/typo3/install/

6. Administrer tout vos sites TYPO3
avec l'outil « superadmin.php » !
Fonctionnalités :
 Accès direct à tous les sites
✔ Site public
✔ Administration « Backend »
 Informations de base :
✔ Pour l'accès aux bases de données
✔ Pour les utilisateurs admin
✔ Pour les mots de passe de l'installTool
 La liste de toutes les extensions installées / actives
 Raccourcis vers les outils de mises à jour
 Changer les mots de passe « Administrateur »

7. Quelle configuration pour utiliser ce script ?
/var/www/htdocs/
Source TYPO3 4.2
superadmin.php
hp
dmi n .p
Source TYPO3 4.3 era
.ca /s u p
obe
fo g l
w.in
tp:/ /ww
ht
www.infoglobe.ca
labo.infoglobe.ca
www.tc2l.ca
ottawa.infoglobe.ca
Blogue.infoglobe.ca wordpress

8. Procédure pour installer et configurer
l'outil « superadmin.php »
(1) Copier le script (misc/superadmin.php) à la racine d'un de vos sites
(2) Éditer le fichier copié pour indiquer le répertoire où se trouvent
tous vos sites à administrer :
$parentDirs = array();
$parentDirs[] = array(
'dir'=> '/var/www/',
'url' => 'http://localhost/'
);
(3) Accéder à l'outil ainsi : http://www.site1.com/superadmin.php
Attention ! Vous devez protéger l'accès à ce fichier !

9. L’extension “lowlevel”
Cette extension système contient un ensemble de
script pour analyser et nettoyer la base de données
d'un site TYPO3
✔ Identifier et corriger les relations perdues (bdd ↔ fichiers ou bdd ↔ bdd)
✔ Identifier et mettre a jour les fichiers référencés en double
✔ Identifier et corriger les images perdues dans l'éditeur de texte RTE
✔ Lister les fichiers orphelins dans le répertoire [uploads] pour les
supprimer manuellement
✔ Lister les enregistrements orphelins (qui sont ou ne sont pas rattachés
à une page du site)
✔ Lister et supprimer les enregistrements qui ont été effacés
✔ Lister et corriger les problèmes liés aux espaces de travail
✔ Nettoyer le code XML (ex : Templavoila) avec du contenu obsolète ou
détaché

10. Exécution du script (en ligne de commande)
/var/www/votresite/typo3/cli_dispatch.phpsh lowlevel_cleaner
pour voir l'aide et toutes les options disponibles
/var/www/votresite/typo3/cli_dispatch.phpsh lowlevel_cleaner outil
Les outils existants sont : missing_files, missing_relations,
double_files, rte_images, lost_files, orphan_records, deleted, versions,
cleanflexform, syslog, tx_templavoila_unusedce

11. Exécution du script (en ligne de commande)
/var/www/votresite/typo3/cli_dispatch.phpsh lowlevel_cleaner outil options
Parmi les options, en voici quelques­unes :
 ­r : Pour exécuter le traitement au lieu d'afficher l'aide
 ­s : Mode silencieux (affiche erreurs et messages importants)
 ­­refindex : Mode lors du traitement des index
 ­­dryrun : Mode pour simuler le traitement au lieu de l'exécuter pour vrai
À savoir :
➔ Vous devez créer un utilisateur « _cli_lowlevel » (mot de passe bidon)
➔ « HOWTO_clean_up_TYPO3_installations.txt » est l'aide à consulter
pour comprendre chacune des options.
➔ Vous pouvez également créer vos propres scripts de nettoyage

12. Voici un exemple :
✗ cli_dispatch.phpsh lowlevel_cleaner missing_relations ­r ­­refindex
update ­­dryrun
Actions : Nettoyage des références perdues dans la base de données.
­­refindex update : Force pour mettre à jour la table des références
­­dryrun : Simuler et voir les changements à réaliser
3 cas sont vérifiés :
➔ Références vers des enregistrements offline (espace de travail)
➔ Références vers des enregistrements supprimés
➔ Références vers des enregistrements inexistants

13. Et un autre :
✗ cli_dispatch.phpsh lowlevel_cleaner deleted ­r ­­AUTOFIX ­­dryrun
Actions : Supprime pour de bon les enregistrements supprimés dans la
base de données
­­AUTOFIX : Forcer la suppression des enregistrements
­­dryrun : Simuler et voir les changements à réaliser
Cet outil a des options supplémentaires :
­­pid : Limiter a un une page précise
­­depth : limiter la profondeur des pages

14. Merci ...
D'autres informations
à venir sur notre blogue
http://blogue.infoglobe.ca