Questa guida vale per TYPO3 12.4 fino a 13.4 LTS e PHP 8.1 fino a 8.3. Servono un account live24h, un workspace e una API key con permessi di scrittura – vedi passaggi comuni .
Installare
Installazione via Composer:
composer require live24h/website-monitor-typo3
vendor/bin/typo3 extension:setup
Inserisci poi nella configurazione dell’estensione apiKey, facoltativamente siteBaseUrl e apiBaseUrl (default https://api.live24h.eu). La pubblicazione nel TYPO3 Extension Repository (TER) ufficiale seguirà.
Passo per passo (Backend)
- Nel backend apri il gruppo di moduli Site-Management → live24h Monitor.
- Nella scheda Impostazioni verifica la connessione («Testa connessione»).
- Avvia l’analisi del sito.
- Guarda l’Health Score e le raccomandazioni.
- Seleziona i check – i suggerimenti bloccati sono contrassegnati come «Upgrade richiesto».
- Crea i check con un clic.
In alternativa via CLI
# Dry-run: mostra scan, modules, score e suggestions come report
vendor/bin/typo3 live24h:monitor:scan --base-url=https://www.example.org
# Creazione: crea i suggerimenti predefiniti
vendor/bin/typo3 live24h:monitor:scan --base-url=https://www.example.org --apply
Per rollout graduali è disponibile inoltre vendor/bin/typo3 live24h:monitor:rollout (livelli minimal, standard, enterprise – di default come dry-run).
Soluzioni ai problemi e suggerimenti
Manca il modulo backend «live24h Monitor».
Esegui vendor/bin/typo3 extension:setup e svuota la cache con vendor/bin/typo3 cache:flush. Verifica inoltre che il tuo utente backend abbia accesso al modulo.
siteBaseUrl è vuoto oppure viene controllato l’URL sbagliato.
L’URL di base viene ricavato dalla configurazione Site di TYPO3. Se non è univoco, imposta siteBaseUrl esplicitamente nella configurazione dell’estensione – oppure indicalo via CLI con --base-url=.
Il «Testa connessione» fallisce.
Verifica apiKey (servono permessi di scrittura), apiBaseUrl (https://api.live24h.eu) e se il server può connettersi verso l’esterno.
Un check Heartbeat resta su «In attesa». È normale e non è un errore: un Heartbeat attende il primo segnale del task Scheduler monitorato (il ping all’URL Heartbeat). Finché il task non si è ancora fatto sentire, il check resta su «In attesa» – non su «Disservizio». Con la prima esecuzione lo stato passa a «Operativo».
Il Heartbeat dello Scheduler non compare. Il suggerimento del Heartbeat presuppone che la system extension Scheduler di TYPO3 sia installata e attiva. Senza di essa, questo punto non è disponibile.
Backend o CLI – cosa usare?
Entrambi portano allo stesso risultato. Il wizard backend è vicino al cliente, la CLI è adatta a rollout ripetibili. Senza --apply la scansione gira come dry-run.
Domande frequenti
Perché un’estensione TYPO3 dedicata? I progetti TYPO3 hanno spesso più siti e requisiti più alti di tracciabilità. Un flusso guidato è più adatto dei singoli check manuali.
È solo per le agenzie? No. È adatto in egual misura ad aziende, operatori SaaS, enti pubblici e team tecnici.
Sono supportati più domini? Sì. Siti e domini vengono letti dalla configurazione Site e possono essere protetti per dominio.