Ce guide s’applique à TYPO3 12.4 à 13.4 LTS et PHP 8.1 à 8.3. Les prérequis sont un compte live24h, un workspace et une clé API avec droits d’écriture – voir les étapes communes .
Installer
Installation via Composer :
composer require live24h/website-monitor-typo3
vendor/bin/typo3 extension:setup
Enregistrez ensuite dans la configuration de l’extension apiKey, en option siteBaseUrl et apiBaseUrl (par défaut https://api.live24h.eu). Le référencement dans le TYPO3 Extension Repository (TER) officiel suivra.
Étape par étape (backend)
- Dans le backend, ouvrez le groupe de modules Gestion des sites → live24h Monitor.
- Dans l’onglet Paramètres, vérifiez la connexion (« Tester la connexion »).
- Lancez l’analyse du site.
- Consultez le Health Score et les recommandations.
- Sélectionnez les checks – les suggestions verrouillées sont signalées « Montée en gamme requise ».
- Créez les checks en un clic.
En alternative, via CLI
# Dry-run : affiche scan, modules, score et suggestions sous forme de rapport
vendor/bin/typo3 live24h:monitor:scan --base-url=https://www.example.org
# Création : crée les suggestions par défaut
vendor/bin/typo3 live24h:monitor:scan --base-url=https://www.example.org --apply
Pour des déploiements échelonnés, il existe en plus vendor/bin/typo3 live24h:monitor:rollout (niveaux minimal, standard, enterprise – en dry-run par défaut).
Solutions de dépannage et conseils
Le module backend « live24h Monitor » est absent.
Exécutez vendor/bin/typo3 extension:setup et videz le cache avec vendor/bin/typo3 cache:flush. Vérifiez également que votre utilisateur backend a accès au module.
siteBaseUrl est vide ou la mauvaise URL est vérifiée.
L’URL de base est déduite de la configuration de Site TYPO3. Si elle n’est pas univoque, définissez siteBaseUrl explicitement dans la configuration de l’extension – ou indiquez-la en CLI avec --base-url=.
Le « test de connexion » échoue.
Vérifiez apiKey (droits d’écriture requis), apiBaseUrl (https://api.live24h.eu) et que le serveur est autorisé à se connecter vers l’extérieur.
Un check Heartbeat reste sur « En attente ». C’est normal et ce n’est pas une erreur : un Heartbeat attend le premier signal de la tâche Scheduler surveillée (le ping vers l’URL Heartbeat). Tant que la tâche ne s’est pas manifestée, le check reste sur « En attente » – et non sur « En panne ». Au premier passage, le statut passe à « Opérationnel ».
Le Heartbeat du Scheduler n’apparaît pas. La suggestion de Heartbeat suppose que l’extension système Scheduler de TYPO3 est installée et active. Sans elle, ce point disparaît.
Backend ou CLI – que choisir ?
Les deux mènent au même résultat. L’assistant backend est proche du client, la CLI convient aux déploiements reproductibles. Sans --apply, l’analyse s’exécute en dry-run.
Questions fréquentes
Pourquoi une extension TYPO3 dédiée ? Les projets TYPO3 ont souvent plusieurs Sites et des exigences plus élevées en matière de traçabilité. Un parcours guidé convient mieux que des checks individuels manuels.
Est-ce réservé aux agences ? Non. Cela convient tout autant aux entreprises, aux opérateurs SaaS, aux institutions publiques et aux équipes techniques.
Plusieurs domaines sont-ils pris en charge ? Oui. Les Sites et domaines sont lus depuis la configuration de Site et peuvent être sécurisés par domaine.