Erste Schritte

Cron einrichten

Zwei Einträge. Beide sind nötig, und sie tun Verschiedenes. Pfad anpassen:

0 3 * * * cd /pfad/zu/formrelay && php artisan formrelay:cleanup --force >> /dev/null 2>&1
* * * * * cd /pfad/zu/formrelay && php artisan queue:work --stop-when-empty >> /dev/null 2>&1
Eintrag Was er tut Ohne ihn
formrelay:cleanup Aufbewahrungsfristen durchsetzen, hängende Zustellungen neu einreihen, eingespielte Update-Pakete entfernen Greift nur der minutengenaue Löschauftrag — was dabei liegen bleibt, bleibt für immer
queue:work Die Aufträge der Warteschlange abarbeiten und sich beenden, sobald sie leer ist Bleibt jeder Auftrag der Warteschlange liegen — ohne Fehlermeldung

Über die Warteschlange laufen die Zustellung der Einsendungen (mit Wiederholungen bis zu sechs Stunden Abstand) und ihr Löschen nach der Frist.

Ohne --force ist formrelay:cleanup ein Testlauf: Er zeigt, was gelöscht würde, und verändert nichts. Führe ihn einmal von Hand aus, bevor du den Cron scharf schaltest.

Dauerhafter Worker statt Cron

Ein dauerhaft laufender Worker (Supervisor, systemd) ersetzt den zweiten Eintrag. Beispiel für systemd:

; /etc/systemd/system/formrelay-worker.service
[Unit]
Description=Formrelay Queue Worker
After=network.target

[Service]
User=www-data
Restart=always
ExecStart=/usr/bin/php /pfad/zu/formrelay/artisan queue:work --sleep=3

[Install]
WantedBy=multi-user.target

User ist der Nutzer, unter dem PHP läuft. Die Aktualisierung führt php artisan queue:restart aus; ein Worker mit Restart=always startet danach mit dem neuen Code.

Kontrolle

Beide Zeilen stehen nach der Installation unter Einstellungen → Systemdaten, Karte „Zeitsteuerung (Cron)" — mit dem Pfad dieser Installation und einem Knopf zum Kopieren. Dort steht auch, wann jeder Befehl zuletzt gelaufen ist. Fehlt ein Lauf oder ist er überfällig, erscheint oben auf der Seite eine Warnung.

Gelesen wird dafür nicht die crontab, sondern ein Zeitstempel, den die Befehle selbst hinterlassen. Der Testlauf ohne --force zählt nicht als Lauf.

php artisan queue:failed

Listet Aufträge der Warteschlange, die endgültig gescheitert sind.

Quelle dieser Seite: docs/cron.md im Repository. Sie wird beim Bauen daraus erzeugt — Änderungen gehören in die Markdown-Datei, nicht in diese Seite.