Cronjobs #

Diese Seite richtet sich an Entwickler, die wissen müssen, was im Hintergrund einer Website läuft und wie sie eigene geplante Arbeiten hinzufügen. Mehrere Funktionen werden nur über Cronjobs abgeschlossen: Freigegebene Inhalte werden veröffentlicht, verzögert indexierte Inhalte indexiert, Benachrichtigungen versendet, datierte Inhalte verborgen. Eine Website ohne ihre Crontab sieht gut aus und hört still und leise auf, diese Dinge zu tun.

Inhalt #

1. Teile und Skripte
2. Was die mitgelieferten Teile tun
3. Teile ausführen
4. Planung
5. Die Seite Cronjobs
6. Ein eigener Cronjob
7. Prüfungen vor dem Live-Gang

Teile und Skripte #

Ein Skript ist eine PHP-Datei in einem Cronjob-Verzeichnis (cronjobs/ der Installation oder einer Erweiterung, die in [CronjobSettings] ExtensionDirectories[] genannt ist). Ein Teil ist eine Gruppe von Skripten, die zusammen nach einem Zeitplan laufen, in cronjob.ini als [CronjobPart-<name>] Scripts[] deklariert. Die Skripte aus [CronjobSettings] Scripts[] bilden den Standardteil, angezeigt als global (Cronjobs, Abschnitt 1).

Was die mitgelieferten Teile tun #

settings/cronjob.ini enthält die vollständige Liste (infrequent, frequent, contentcheck, contentjobs, audit, logs, notification, mailpreferences, mailbounces, unlock, cluster_maintenance, cleanuprss, cache_cleanup), und Erweiterungen fügen eigene Teile hinzu, etwa für Sitemaps oder Newsletter. So listen Sie auf, was Ihre Installation hat:

php runcronjobs.php --list --allow-root-user

Teile ausführen #

php runcronjobs.php -s <siteaccess> frequent --allow-root-user        # one part
php runcronjobs.php -s <siteaccess> --allow-root-user                 # the default part
php runcronjobs.php -s <siteaccess> --script=workflow.php --allow-root-user   # one script
./console list cron                                                    # every part as a console command, cron:<part>

Führen Sie sie als der Benutzer aus, unter dem der Webserver läuft, damit Dateien, die die Cronjobs schreiben, für die Website lesbar bleiben. Jedes Skript nimmt eine eigene Sperre, sodass ein zweiter Lauf desselben Skripts wartet oder übersprungen wird (Cronjobs in der Shell ausführen).

Planung #

Fügen Sie je Teil eine Crontab-Zeile hinzu, vom Hauptverzeichnis der Installation aus:

*/5 * * * *  cd /var/www/example && php runcronjobs.php -s site frequent >/dev/null 2>&1
*/15 * * * * cd /var/www/example && php runcronjobs.php -s site >/dev/null 2>&1
17 * * * *   cd /var/www/example && php runcronjobs.php -s site infrequent >/dev/null 2>&1

Das sind die Standardzeitpläne, die die Seite Cronjobs vorschlägt; legen Sie je Teil eigene mit cronjob.ini [AdminSettings] CrontabSchedule_<part> fest (Planung mit der Crontab). Hosting-Panels haben eigene Cron-Bildschirme (Cron und Shell-Zugang).

Die Seite Cronjobs #

Die Administration listet jeden Teil und jedes Skript, zeigt, ob die Crontab es einplant, führt einen Teil oder ein Skript mit Live-Ausgabe aus, bewahrt die letzten Läufe auf, zählt Probleme und schlägt Crontab-Zeilen vor. Verwenden Sie sie, um ein neues Skript auszuprobieren, bevor Sie es einplanen, und um herauszufinden, warum über Nacht etwas nicht geschehen ist (Cronjobs, Cronjob-Konsole).

Ein eigener Cronjob #

1. Schreiben Sie das Skript in extension/exp_mysite/cronjobs/exp_feed_sync.php, mit einem @description-Tag in seinem Doc-Kommentar (Konsole und Seite zeigen ihn an).

2. Deklarieren Sie das Verzeichnis und einen Teil in extension/exp_mysite/settings/cronjob.ini.append.php:

   <?php /* #?ini charset="utf-8"?
   
   [CronjobSettings]
   ExtensionDirectories[]=exp_mysite
   
   [CronjobPart-exp_mysite]
   Scripts[]=exp_feed_sync.php
   */ ?>

3. Leeren Sie den INI-Cache, führen Sie den Teil von Hand aus (php runcronjobs.php -s <siteaccess> exp_mysite) und planen Sie ihn dann ein.

Ruhiger Modus, Protokollierung und die Stoppschalter stehen unter Cronjob-Teile und im Tutorial Ein Cronjob-Teil von Hand. Lange Arbeit gehört in einen Cronjob oder einen Inhaltsjob, nicht in eine Seitenanfrage.

Prüfungen vor dem Live-Gang #

• To do: Der Teil frequent und der Standardteil sind für jeden öffentlichen Siteaccess eingeplant, der sie braucht.
• To do: Workflows mit Freigaben, verzögertes Indexieren und Benachrichtigungen wurden bei laufendem Cron von Anfang bis Ende getestet.
• To do: Cron läuft als Benutzer des Webservers, und seine Ausgabe wird protokolliert oder an jemanden gemailt, der sie liest.
• To do: Ihre eigenen Teile sind eingeplant und im Projekt dokumentiert.

Verwandte Seiten #

• Cronjobs für Hoster
• Cronjobs für Website-Bauer
• Workflows und Auslöser
• Freie Dokumentation: Diese Seite darf unter der GNU FDL 1.3 frei kopiert, übersetzt und verbessert werden.