aeto/drupal-watchdlog (1.0.4)

Published 2026-05-15 00:23:36 +02:00 by vasko

Set up this registry in your ~/.composer/config.json file:

{
	"repositories": [{
			"type": "composer",
			"url": "https://git.vasko2.vshosting.cz/api/packages/Aeto/composer"
		}
	]
}

To install the package using Composer, run the following command:

composer require aeto/drupal-watchdlog:1.0.4

For more information on the Composer registry, see the documentation.

Čtečka logových souborů z /dlog/ pro Drupal.

Drupal WatchDlog

Jednoduchý Drupal modul pro prohlížení Monolog logových souborů uložených v adresáři /dlog/.

Funkce

Seznam dostupných log souborů (*.log) v /dlog/ seřazený podle data úpravy.
Prohlížeč jednotlivých souborů s paměťově úspornou čtečkou (čte soubor odzadu po 8 kB chunkech, zvládne i velmi velké logy).
Filtry podle kanálu (multiselect), úrovně (multiselect) a fulltextového hledání ve zprávě.
Barevné odlišení úrovní (DEBUG / INFO / NOTICE / WARNING / ERROR / CRITICAL / ALERT / EMERGENCY).
Stránkování (100 záznamů na stránku).
Zobrazení kontextových metadat: IP, UID, uživatel, request URI.

Požadavky

Drupal 10 nebo 11
PHP 8.1+
Adresář /dlog/ čitelný webovým serverem a obsahující soubory *.log ve formátu Monolog:
```
[2026-04-13T10:09:21.780182+02:00] channel.LEVEL: zpráva [] {"extra":"json"}
```

Instalace

Přes Composer z vlastního repozitáře:

Pokud není na serveru uloženo přihlášení musí se vygenerovat na Gitea v sekci Nastavení -> Aplikace -> přístupové tokeny, kde název tokenu a token jsou jméno a heslo.

composer config repositories.aeto composer https://git.vasko2.vshosting.cz/api/packages/Aeto/composer
composer require aeto/drupal-watchdlog
drush en drupal_watchdlog

Použití

Po aktivaci je v administraci k dispozici odkaz:

Reports → WatchDlog – /admin/watchdlog

Detail konkrétního souboru: /admin/watchdlog/view/{filename}

Přístup je povolen uživatelům s oprávněním administer site configuration.

Konfigurace

Cesta k adresáři s logy se nastavuje v administraci na /admin/config/system/watchdlog. Výchozí hodnota je ../dlog (relativně k DRUPAL_ROOT). Lze zadat absolutní cestu (začínající /) nebo relativní k DRUPAL_ROOT (např. ../../shared/dlog).

Self upgrade (vydání nové verze)

Modul se distribuuje přes Gitea Composer registry (https://git.vasko2.vshosting.cz/api/packages/Aeto/composer). Klienti v composer.json mají repository typu composer (viz Instalace) – díky tomu se z Aety stahují všechny balíčky stejným způsobem. Registry ale nesleduje automaticky git tagy – každou novou verzi je nutné nahrát jako zip přes API. Tomu se vyhneš dvěma skripty v bin/.

Jednorázové nastavení autentizace

Vygeneruj v Gitea access token (Nastavení → Aplikace → access tokeny, scope write:package) a zapiš ho do ~/.netrc:

cat >> ~/.netrc <<EOF
machine git.vasko2.vshosting.cz
login TVUJ_USERNAME
password TVUJ_TOKEN
EOF
chmod 600 ~/.netrc

Tato položka funguje jak pro upload (níže), tak pro composer install v cílových projektech.

Vydání nové verze

bin/release.sh 1.0.3

Skript v jednom kroku:

Ověří čistotu pracovní kopie a formát verze (X.Y.Z).
Vytvoří annotated git tag a pushne větev + tag na origin.
Vyrobí zip drupal_watchdlog-1.0.3.zip přes git archive.
Nahraje zip do Composer registry přes PUT /api/packages/Aeto/composer.

Jen upload (tag už existuje)

Pokud je tag pushnutý, ale zip v registry chybí:

bin/upload.sh 1.0.3                       # najde zip v aktuálním adresáři nebo /tmp
bin/upload.sh 1.0.3 /cesta/k/balicku.zip  # nebo s vlastní cestou

Aktualizace v cílovém projektu

composer clear-cache
composer update aeto/drupal-watchdlog

Licence

GPL-2.0-or-later

Dependencies

ID	Version
drupal/core	^10 \|\| ^11
php	>=8.1

Details

Composer

2026-05-15 00:23:36 +02:00

GPL-2.0-or-later

29 KiB

Assets (1)

aeto-drupal-watchdlog.1.0.4.zip 29 KiB

Versions (3) View all

1.0.4

2026-05-15

1.0.3