presseportale/app/Console/Commands/PurgePressReleaseEvents.php
Kevin Adametz 951b6c47fa web: Crawler-Abruf-Protokoll und Panel „Auslieferung" ohne Google-Link (Anhang 1: 1c.0, 1c.1, 1c.6)
Abrufe öffentlicher Meldungen durch bekannte Such- und KI-Dienste werden
je Meldung mit Dienst, gekürztem User-Agent und Zeitpunkt protokolliert —
keine IP. Dienste und Muster stehen in config/crawlers.php. Aufzeichnung
wie der Aufruf-Zähler per defer() und fehlertolerant; Bereinigung hängt
an press-releases:purge-events.

VisibilityStats liefert die Abrufe je Dienst (letzter Abruf, Anzahl) und
verliert den site:-Suchlink (Stufe 1 verspricht nichts, was von Dritten
abhängt).

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
2026-09-17 14:21:35 +00:00

116 lines
3.9 KiB
PHP

<?php
namespace App\Console\Commands;
use App\Models\AppSetting;
use App\Models\PressReleaseCrawlerHit;
use App\Models\PressReleaseEvent;
use Illuminate\Console\Command;
/**
* Begrenzt das Ereignis-Log der Pressemitteilungen auf einen
* Aufbewahrungszeitraum.
*
* Seit der Aufruf-Zähler nicht mehr im Request auf `press_releases.hits`
* schreibt, ist `press_release_events` die Quelle jedes einzelnen
* Seitenaufrufs — die Tabelle wächst also mit dem Traffic und hatte als
* einzige Log-Tabelle des Systems keine Bereinigung. Für die Gesamtzahl ist
* das Log nach der Aggregation nicht mehr nötig (die steckt in `hits`);
* gebraucht wird es nur noch für den zeitlichen Verlauf in der Absenderansicht.
*
* ZWEI SICHERUNGEN, beide zwingend:
*
* 1. Gelöscht wird ausschließlich UNTERHALB der Wasserstandsmarke von
* `press-releases:aggregate-views`. Alles darüber ist noch nicht in `hits`
* verbucht — würde es hier verschwinden, wären diese Aufrufe dauerhaft
* verloren. Fehlt die Marke, bricht der Lauf ab, statt zu raten.
* 2. Gelöscht wird in Blöcken. Ein einzelnes DELETE über Millionen Zeilen
* hielte die Sperre über die gesamte Laufzeit.
*/
class PurgePressReleaseEvents extends Command
{
protected $signature = 'press-releases:purge-events
{--days= : Ereignisse älter als X Tage löschen (Standard: config press_releases.events.retention_days)}
{--chunk=5000 : Zeilen je Durchgang}
{--dry-run : Nur zählen, nichts löschen}';
protected $description = 'Begrenzt das Ereignis-Log der Pressemitteilungen auf den Aufbewahrungszeitraum.';
public function handle(): int
{
$days = (int) ($this->option('days') ?? config('press_releases.events.retention_days'));
if ($days < 1) {
$this->error('Aufbewahrungszeitraum muss mindestens einen Tag betragen.');
return self::FAILURE;
}
$watermark = AppSetting::getValue(AggregatePressReleaseViews::WatermarkKey);
if ($watermark === null) {
$this->error(
'Wasserstandsmarke des Aufruf-Zählers fehlt — es ist unbekannt, welche Ereignisse '
.'bereits in `hits` verbucht sind. Erst "php artisan press-releases:aggregate-views" laufen lassen.'
);
return self::FAILURE;
}
$watermark = (int) $watermark;
$cutoff = now()->subDays($days);
$chunk = max(100, (int) $this->option('chunk'));
$expired = PressReleaseEvent::query()
->where('id', '<=', $watermark)
->where('created_at', '<', $cutoff);
if ($this->option('dry-run')) {
$this->info(sprintf(
'[Dry-Run] %d Ereignisse älter als %s und bereits verbucht (Stand Event-ID %d).',
(clone $expired)->count(),
$cutoff->format('d.m.Y'),
$watermark,
));
return self::SUCCESS;
}
$deleted = 0;
while (true) {
$removed = (clone $expired)->limit($chunk)->delete();
if ($removed === 0) {
break;
}
$deleted += $removed;
}
$this->info(sprintf(
'Ereignis-Log bereinigt: %d Einträge vor dem %s gelöscht (Aufbewahrung %d Tage).',
$deleted,
$cutoff->format('d.m.Y'),
$days,
));
// Crawler-Abruf-Protokoll (1c.0): gleiche Aufbewahrung, keine
// Wasserstandsmarke nötig — es wird nirgends aufsummiert.
$crawlerDeleted = 0;
while (true) {
$removed = PressReleaseCrawlerHit::query()->where('created_at', '<', $cutoff)->limit($chunk)->delete();
if ($removed === 0) {
break;
}
$crawlerDeleted += $removed;
}
$this->info(sprintf('Crawler-Abruf-Protokoll bereinigt: %d Einträge gelöscht.', $crawlerDeleted));
return self::SUCCESS;
}
}