Cronjobs dienen der regelmäßigen automatisierten Ausführung von Programmcode. Das Cronjobs-AddOn ist Bestandteil der REDAXO-Basisinstallation, muss jedoch bei Bedarf separat installiert werden.
Im AddOn lassen sich dann beliebig viele Einträge erstellen, die gemäß den Einstellungen jedes Eintrages abgearbeitet werden.
Zunächst gibt man den Namen eines Eintrags ein. Dies kann beispielsweise RSS Feed lesen oder Monatliches Backup sein.
Eine aussagekräftige Beschreibung vervollständigt den informativen Teil des Eintrages.
Im Feld Umgebung kann man ein oder mehrere Ereignisse wählen, bei denen der Cronjob ausgeführt wird.
- Frontend
- Backend
- Skript
Sobald ein eingestelltes Intervall erreicht ist, wartet das AddOn auf das eingestellte Ereignis: einen Seitenaufruf im Frontend, auf eine Aktion durch einen Nutzer im Backend oder den Aufruf der Skriptumgebung. Tritt das eingestellte Ereignis ein, wird der Cronjob ausgeführt.
Obwohl alle drei Einträge gleichzeitig aktiviert werden können, sollte man die Umgebung Skript nicht gleichzeitig mit Frontend oder Backend auswählen - von Testzwecken einmal abgesehen.
Somit können Cronjobs ausgelöst werden durch:
- einen Seitenaufruf im Frontend
- einen Seitenaufruf im Backend
- einen direkten Aufruf der Cronjob-Skriptumgebung durch einen externen Dienst
Bei der Ausführung in der Umgebung Frontend und Backend läuft der Cronjob in der Session des jeweiligen Users, sodass dort auch ein Zugriff auf die Session möglich ist. Nur die Umgebung Skript erlaubt die Ausführung des Cronjobs unabhängig von einem Aufruf von REDAXO im Frontend oder im Backend.
Nur in der Umgebung Backend ist es möglich, den Cronjob manuell in den Einstellungen des AddOns zu starten.
Wenn eines der Ereignisse Frontend oder Backend eintritt, so kann der Cronjob seinen Dienst zu Beginn des Aufrufes erledigen oder am Ende. Nur in Ausnahmefällen sollte die Einstellung Beginn gewählt werden, da sie den jeweiligen Aufruf verzögert. Das fällt natürlich weniger ins Gewicht, wenn die Ausführung am Ende geschieht.
Im Feld Status kann ein Cronjob deaktiviert werden. Standard ist aktiviert.
Im Feld Typ bestehen die Auswahlmöglichkeiten:
- PHP-Code
- PHP-Callback
- URL-Aufruf
AddOns können dort weitere Einträge hinzufügen.
Beispielsweise:
- Datenbankexport (durch das AddOn
Backup) - Search it: Reindexieren (durch das AddOn
Search it)
Je nach Einstellung im Feld Typ stehen unterschiedliche Eingabemöglichkeiten im Bereich Typspezifische Parameter zur Verfügung.
So kann bei der Einstellung PHP-Code kompletter PHP-Code eingegeben werden, bei der Einstellung PHP-Callback lediglich ein Aufruf.
AddOns können eigene typspezifische Parameter zur Verfügung stellen.
Die Standardeinstellung für den Bereich Intervall ist die tägliche Ausführung, jeweils beim nächsten Aufruf der Umgebung nach 0:00 Uhr.
AddOns können eigene Ausführungstypen definieren. Dies wird beispielsweise im System AddOn Backup verwendet, um automatisierte Backups auszuführen.