- Rückmeldungen an den Hersteller (docs/specs/feedback.md): Fehlerbericht und
Funktionswunsch, nur freigeschaltete Wege, Idempotency-Key je Meldung,
Warteschlange mit höchstens fünf Versuchen, 422 am Feld, 429 mit Wartezeit,
404 blendet den Weg aus, Referenznummer und „Meine Rückmeldungen“,
sichtbare technische Angaben und Datenschutzhinweis über dem Absendeknopf
- Hintergrundaufgaben ohne Dauerprozess: Cron, Web-Cron (/cron/{token}) oder
Pseudo-Cron nach dem Seitenaufruf; Queue in kurzen Häppchen
- Seite „Systemzustand“ mit Voraussetzungen, Grenzen, Betrieb, Sicherheit und
Anleitung für den Cronjob
- Web-Installer (Systemprüfung → Datenbank → Administrator), legt .env und
Anwendungsschlüssel selbst an, arbeitet vor der Einrichtung ohne Datenbank
- Datenbank-Benachrichtigungen im Admin-Bereich
Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
80 lines
2.4 KiB
PHP
80 lines
2.4 KiB
PHP
<?php
|
|
|
|
namespace App\Support;
|
|
|
|
use Illuminate\Support\Facades\Artisan;
|
|
use Illuminate\Support\Facades\Log;
|
|
use Throwable;
|
|
|
|
/**
|
|
* Hintergrundaufgaben ohne Dauerprozess (Shared Hosting):
|
|
* 1. echter Cron: * * * * * php artisan schedule:run
|
|
* 2. Web-Cron: externer Dienst ruft /cron/{token} auf
|
|
* 3. Pseudo-Cron: nach Auslieferung einer Seite, wenn 1 und 2 fehlen (wie WP-Cron)
|
|
* Jeder Lauf hinterlässt ein Lebenszeichen, das „Systemzustand“ anzeigt.
|
|
*/
|
|
class BackgroundTasks
|
|
{
|
|
/** Ohne Lebenszeichen von Cron/Web-Cron springt der Pseudo-Cron ein. */
|
|
public const PSEUDO_CRON_AFTER_SECONDS = 300;
|
|
|
|
public function __construct(private readonly Settings $settings) {}
|
|
|
|
public function run(string $source): void
|
|
{
|
|
$lock = @fopen(storage_path('.background.lock'), 'c');
|
|
|
|
if ($lock === false || ! flock($lock, LOCK_EX | LOCK_NB)) {
|
|
return;
|
|
}
|
|
|
|
try {
|
|
@set_time_limit(55);
|
|
$this->heartbeat($source);
|
|
Artisan::call('schedule:run');
|
|
} catch (Throwable $e) {
|
|
Log::error('Hintergrundaufgaben fehlgeschlagen: '.$e->getMessage(), ['exception' => $e]);
|
|
} finally {
|
|
flock($lock, LOCK_UN);
|
|
fclose($lock);
|
|
}
|
|
}
|
|
|
|
public function heartbeat(string $source): void
|
|
{
|
|
$beats = $this->heartbeats();
|
|
$beats[$source] = now()->getTimestamp();
|
|
@file_put_contents(storage_path('.background-heartbeat'), json_encode($beats));
|
|
}
|
|
|
|
/**
|
|
* @return array<string, int> Quelle (cron, webcron, pseudo) => Zeitpunkt
|
|
*/
|
|
public function heartbeats(): array
|
|
{
|
|
$data = json_decode((string) @file_get_contents(storage_path('.background-heartbeat')), true);
|
|
|
|
return is_array($data) ? array_map('intval', $data) : [];
|
|
}
|
|
|
|
public function pseudoCronDue(): bool
|
|
{
|
|
$beats = $this->heartbeats();
|
|
$external = max($beats['cron'] ?? 0, $beats['webcron'] ?? 0);
|
|
|
|
return now()->getTimestamp() - $external > self::PSEUDO_CRON_AFTER_SECONDS
|
|
&& now()->getTimestamp() - ($beats['pseudo'] ?? 0) >= 60;
|
|
}
|
|
|
|
public function webCronToken(): string
|
|
{
|
|
$token = $this->settings->get('system.cron_token');
|
|
|
|
if (! is_string($token) || strlen($token) < 32) {
|
|
$token = bin2hex(random_bytes(20));
|
|
$this->settings->set('system.cron_token', $token);
|
|
}
|
|
|
|
return $token;
|
|
}
|
|
}
|