Présentation donnée lors du JIT 2009 à Québec pour Infoglobe. Cette présentation présentait succintement l'installTool ainsi que l'outil "superadmin.php" et l'extension "lowlevel"
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”
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 quelquesunes :
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