Cron-Verwaltung: Einrichtung und Hilfe

Öffnen Sie in Ihrem Back Office Module > "Module Manager", wählen Sie "Upload a module" und laden Sie die ZIP-Datei des Moduls hoch. Installieren Sie es und klicken Sie dann auf "Configure". Verwenden Sie bei älteren PrestaShop-Versionen die entsprechende Modulseite.

Öffnen Sie Cron Manager > Einstellungen > Konfiguration. Verwenden Sie Server-Cron (empfohlen), wenn Ihr Hosting geplante PHP-Befehle unterstützt. Verwenden Sie cron-job.org oder einen anderen externen HTTP-Scheduler, wenn Sie einen entfernten Auslöser benötigen. Front-Office-Fallback und Back-Office-Fallback benötigen Seitenaufrufe. Sie gewährleisten keine feste Ausführungszeit.

Installieren Sie die MPR-Module, deren Aufgaben Sie ausführen möchten. Öffnen Sie Module in Cron Manager und synchronisieren Sie deren Definitionen. Ein zentraler Auslöser verteilt die fälligen registrierten Aufgaben. Er erkennt keine beliebigen Skripte als Aufgaben.

Kopieren Sie unter Cron-Endpunkte den Server-Cron-Befehl, die HTTP-Cron-URL oder den Wert unter Gemeinsames Cron-Token. Das Token wird als 64 hexadezimale Zeichen generiert. Eine Neugenerierung macht Ihre alten Befehle und URLs ungültig. Aktualisieren Sie danach jeden Scheduler.

Server-Cron

Der generierte Kopierbefehl verwendet --token=TOKEN, was der aktuelle Runner akzeptiert. Bei einer Servereinrichtung können Sie das Token stattdessen in die erste Zeile einer Datei außerhalb des öffentlichen Webverzeichnisses schreiben. Gewähren Sie nur dem Benutzer für die geplante PHP-Ausführung Lesezugriff, beispielsweise mit dem Dateimodus 0400. Verwenden Sie zu Ihrem Hosting passende absolute Pfade:

* * * * * /usr/bin/php /path/to/prestashop/modules/mprcron/cron.php --token-file=/private/mprcron.token --max-tasks=20 --max-seconds=300 --context=cron

Übernehmen Sie diese Beispielpfade nicht wörtlich. Die ausführbare PHP-CLI-Datei muss Ihren Shop und dessen Abhängigkeiten laden können. Für Befehlsaufgaben muss der Server außerdem die Ausführung von Prozessen erlauben.

HTTP-Scheduler

Kopieren Sie die vom Shop generierte HTTP-Cron-URL. Ihr Format lautet:

https://yourshop.com/module/mprcron/cron?token=YOUR_TOKEN
https://yourshop.com/module/mprcron/cron?token=YOUR_TOKEN&max_tasks=20&max_seconds=300

Speichern Sie für cron-job.org Ihren Schlüssel und das Intervall und verwenden Sie dann das Steuerelement zum Erstellen oder Synchronisieren des Auftrags. Prüfen Sie mit Öffentliche Anfrage testen die Erreichbarkeit. Auf diesem Bildschirm können Sie den externen Auftrag pausieren, fortsetzen, löschen oder trennen. Authentifizierungssperren, Wartungseinschränkungen und Firewalls können entfernte Anfragen blockieren.

Grenzen und Kontext

Ein Runner-Aufruf verwendet standardmäßig 20 Aufgaben und 300 Sekunden. Die Grenzen werden auf 1 bis 100 Aufgaben und 10 bis 300 Sekunden begrenzt. Dies sind Aufrufparameter, keine Felder im Konfigurationsformular. Die CLI akzeptiert --max-tasks, --max-seconds und --context=cron|front|admin. Der Front-Controller-Endpunkt des Moduls führt im Kontext cron aus. Erwarten Sie nicht, dass dessen Query-String diesen Kontext ändert.

Verwenden Sie Übersicht für eine Zusammenfassung. Aufgaben zeigt das besitzende Modul, den Aufgabenschlüssel, die Bezeichnung, den Typ, den Zeitplan, den Aktivierungsstatus, den Kontext, die Priorität, das Zeitlimit sowie die letzte und nächste Ausführung. Verwenden Sie Ausführen für eine sofortige Ausführung. Ändern Sie eine einzelne Aufgabe über Pausieren oder Fortsetzen. Bearbeiten Sie eine vom Modul definierte Häufigkeit und setzen Sie sie bei Bedarf auf den Modulstandard zurück.

Verwenden Sie Module, um Definitionen zu synchronisieren, die Aufgaben eines Moduls zu pausieren oder fortzusetzen oder Registrierungen zu entfernen. Eine entfernte, vom Modul definierte Registrierung kann durch Synchronisierung des besitzenden Moduls wiederhergestellt werden. Das Entfernen einer benutzerdefinierten Aufgabe löscht deren benutzerdefinierte Definition.

Eine benutzerdefinierte Aufgabe erstellen

Ihr Mitarbeiterprofil benötigt die zur jeweiligen Aktion passenden Rechte zum Anzeigen, Hinzufügen, Bearbeiten oder Löschen von Aufgaben.

Öffnen Sie das Formular für benutzerdefinierte Aufgaben unter Aufgaben.

Verwenden Sie Testlauf oder Speichern und testen und prüfen Sie das Ergebnis. Ein HTTP-Scheduler oder ein Fallback-Seitenaufruf führt keine Befehlsaufgaben aus. Die Aktion Ausführen unter Aufgaben verwendet den ausdrücklichen Admin-Testkontext.

Zeitpläne

hourly:00
daily:04:00
weekly:1:08:00
weekly:1,3:08:00
every:3600
*/15 * * * *
0 3 * * *
30 2 * * 1

Bei wöchentlichen Zeitplänen ist Tag 0 Sonntag und Tag 1 Montag. every:3600 verwendet Sekunden. Kalenderbasierte Zeitpläne verwenden die Zeitzone der PHP-Laufzeit. Vergleichen Sie diese mit den in der Aufgabenliste angezeigten Zeiten.

Geben Sie für einen Lieferantenimport Name Nightly supplier import, Typ URL, Methode POST, Zeitplan daily:02:30 sowie die URL des Lieferanten ein. Setzen Sie Erwarteter HTTP-Status auf 200. Fügen Sie Content-Type: application/json zu Header und diesen Inhalt zu Body hinzu:

{"source":"prestashop","mode":"scheduled"}

Verwenden Sie für einen Callable module_name::method. Verwenden Sie für einen Befehl einen absoluten Befehl wie php /path/to/script.php.

1. Verwenden Sie Ausführen bei einer unbedenklichen Aufgabe. Prüfen Sie Logs auf Status, Kontext, Dauer und Ergebnisvorschau.
2. Warten Sie auf den nächsten Auslöser Ihres Schedulers. Prüfen Sie unter Zugriffe einen Server- oder externen Zugriff und anschließend Letzte Ausführung und Nächste Ausführung der Aufgabe.
3. Wenn Zugriffe ohne Ausführungen eingehen, prüfen Sie Cron-Ausführung aktivieren, den Aktivierungsstatus, den Zeitplan und den Kontext der Aufgabe. Eine von einem anderen Runner beanspruchte Aufgabe wird übersprungen.
4. Wenn keine Zugriffe eingehen, prüfen Sie Scheduler-Pfad, Token und öffentliche Erreichbarkeit. Eine manuelle Ausführung testet nur die Aufgabe selbst; der Scheduler Ihres Hostings muss die URL trotzdem aufrufen.
5. Prüfen Sie bei fehlgeschlagenen, zeitüberschrittenen oder abgestürzten Ergebnissen das Ergebnis und das Zielskript. Fehlgeschlagene Ausführungen verschieben ihre nächste Ausführung um eine Wiederholungsverzögerung. Wenn verfügbar, wird die CLI-Unterprozessisolierung verwendet, damit eine abgestürzte Aufgabe nicht den gesamten Stapel stoppen muss.

Authentifizierte Diagnose-URLs verwenden denselben Endpunkt:

?token=YOUR_TOKEN&action=status
?token=YOUR_TOKEN&action=health
?token=YOUR_TOKEN&action=tasks
?token=YOUR_TOKEN&action=tasks&module=mprcron
?token=YOUR_TOKEN&action=run&id_task=123

Zugriffe unterscheidet Server-, externe, Front-Office-, Back-Office-, Fallback- und manuelle Auslöser. Logs zeichnet Ausführungen auf. Verwenden Sie Einstellungen > Integrität für Installationsprüfungen. Lizenz, Support und Aktualisieren befinden sich ebenfalls unter Einstellungen.

Wenn Sie ein MPR-Modul pflegen, verwenden Sie das mitgelieferte MyPrestaRocks\Cron\CronTrait, deklarieren Sie Aufgaben in getCronTasks() und rufen Sie dessen Cron-Installations- und Deinstallationsmethoden im Lebenszyklus Ihres Moduls auf. Eine Aufgabendefinition kann Folgendes enthalten:

'refresh_feed' => [
    'label' => 'Refresh product feed',
    'callable' => 'mymodule::cronRefreshFeed',
    'schedule' => 'daily:03:00',
    'context' => 'cron',
    'priority' => 50,
    'timeout' => 120,
]

Synchronisieren Sie nach Änderungen an Definitionen das besitzende Modul unter Module.

Schalten Sie Cron-Ausführung aktivieren für einen vorübergehenden Stopp aus und prüfen Sie Ihren externen Scheduler separat. Entfernen Sie den Cron-Eintrag des Hostings oder pausieren/löschen Sie den externen Auftrag, wenn Sie das Modul außer Betrieb nehmen. Deinstallieren Sie es über den "Module Manager". Die Deinstallationsroutine deregistriert die eigenen Aufgaben von Cron Manager und entfernt dessen Menü. Sie behält die gemeinsam genutzten Cron-Tabellen bei, da andere Module sie weiterhin verwenden können.

Erfordert PrestaShop 1.6.1 oder neuer und PHP 7.1 oder neuer.