cgoit / contao-sitewatch-bundle

v1.0.0 2026-11-01 19:07 UTC

Requires

• php: ^8.3
• ext-mbstring: *
• contao/core-bundle: ^5.3
• psr/log: ^3.0 || ^4.0
• symfony/config: ^6.0 || ^7.2
• symfony/dependency-injection: ^6.0 || ^7.2
• symfony/http-client-contracts: ^3.0
• symfony/http-kernel: ^6.0 || ^7.2

Requires (Dev)

• contao/manager-plugin: ^2.0
• phpunit/phpunit: ^12.5 || ^13.2
• symfony/filesystem: ^6.1 || ^7.2
• symfony/http-client: ^6.1 || ^7.2
• terminal42/contao-build-tools: dev-main

Conflicts

• contao/manager-plugin: <2.0 || >=3.0

LGPL-3.0-or-later

• Carsten Götzinger

Published on Packagist.org on 2026-11-01 19:07 UTC

README

Meldet den Zustand einer Contao-5-Installation per Push an Sitewatch. Gedacht für Hosting, auf dem kein eigenes Programm laufen darf (z. B. Shared Hosting). Wo der Go-Agent läuft, braucht es dieses Bundle nicht.

Das Bundle ist nur lesend und öffnet keinen eingehenden Endpunkt: Ein Contao-Cron-Job (stündlich) sendet den Report per HTTPS an Sitewatch.

Installation

composer require cgoit/contao-sitewatch-bundle

In config/config.yaml:

Den fertigen Block mit Token erzeugt Sitewatch beim Anlegen eines Agenten vom Typ „Contao-Bundle“ (Seite „Agenten“).

cgoit_sitewatch:
    url: 'https://sitewatch.example.org'
    token: '%env(SITEWATCH_TOKEN)%'   # Token der Site in Sitewatch, nicht ins Repository
    site_id: 'meine-seite'             # a-z, 0-9, -
    site_name: 'Meine Seite'           # optional
    site_url: 'https://www.example.org' # optional, nur zur Anzeige

SITEWATCH_TOKEN gehört in die .env.local auf dem Server. Ohne url, token und site_id sendet das Bundle nichts und schreibt eine Warnung ins Log. Die URL muss mit https:// beginnen (http nur für localhost).

Was gemeldet wird

PHP- und Contao-Version, Anzahl der Pakete, Wartungsmodus (var/maintenance.html), Zeitpunkt des Cron-Laufs und gruppierte Fehler (ERROR und höher, letzte 24 Stunden) aus var/logs.

Nicht ermittelt werden Updates, Sicherheitshinweise, Migrationen, Backups, TLS-Zertifikat und Serverwerte. Sitewatch kennt das am Agent-Typ contao-bundle und zeigt es als „nicht geprüft“; site.problems enthält nur echte Fehlschläge.

Cron

Der Job hängt am Contao-Cron. Läuft dieser nur über Seitenaufrufe (Contao-Fallback ohne echten Server-Cron), meldet sich eine Seite ohne Besucher nicht. Sitewatch kann sie dann in der Site-Konfiguration anpingen, sobald der Report überfällig ist.

Tests

composer install
composer run tests