phpList Cronjob einrichten: Warteschlange automatisch versenden

Einrichtung

Schritt für Schritt

1. Geheimnis für die Fernverarbeitung prüfen

   Öffnen Sie Config → Settings und dort den Abschnitt Security. Beim Punkt „Secret for remote processing“ steht bereits ein Zufallswert, den phpList bei der Einrichtung erzeugt. Übernehmen Sie ihn oder tragen Sie einen eigenen, langen Wert aus Buchstaben und Ziffern ein.

2. Adresse zusammensetzen und prüfen

   Die Adresse besteht aus Ihrer phpList-Installation, dem Admin-Pfad und zwei Parametern. Nehmen Sie https, damit das Geheimnis verschlüsselt übertragen wird; das empfiehlt auch das phpList-Handbuch. Rufen Sie die Adresse einmal im Browser auf. Richtig ist eine knappe Textausgabe zum Versand, etwa „Finished, Nothing to do“, wenn gerade nichts in der Warteschlange liegt.

   https://ihre-domain.de/lists/admin/?page=processqueue&secret=IHRGEHEIMNIS

3. Konto bei Cronjob.de anlegen

   Die Registrierung dauert eine Minute und ist kostenlos. Fünf Cronjobs bleiben dauerhaft gratis, die ersten 14 Tage laufen im Unlimited-Tarif.

   Kostenlos starten 14 Tage Unlimited inklusive, keine Zahlungsdaten

4. Cronjob mit dieser Adresse anlegen

   Fügen Sie die Adresse ein und wählen Sie alle fünf Minuten. Diesen Takt zeigt das Beispiel im phpList-Handbuch. Häufiger bringt wenig, siehe die Frage zur Sperre weiter unten.

   */5 * * * *

   Diesen Ausdruck können Sie bei Cronjob.de direkt so eintragen – das Zeitplanfeld versteht die Crontab-Schreibweise. Sie müssen sie aber nicht kennen: klicken Sie den Takt stattdessen einfach an.

5. Fehler-Benachrichtigung einschalten

   Hinterlegen Sie unter Benachrichtigungen eine E-Mail-Adresse. Ein Versand, der stillsteht, fällt sonst erst auf, wenn die Kampagne längst hätte draußen sein sollen. Die Fehlerbenachrichtigung per E-Mail gibt es ab dem Tarif Plus, in den ersten 14 Tagen ist sie kostenlos dabei.

Was die fünf Felder eines Ausdrucks wie */5 * * * * bedeuten, steht in der Crontab-Referenz – mit Beispielen und den häufigsten Stolpersteinen. Bauen können Sie den Ausdruck im Crontab-Generator. Ob Sie dafür überhaupt einen Dienst von außen brauchen, zeigt der Vergleich der drei Wege.

Kontrolle

Läuft es wirklich?

Legen Sie eine Testkampagne an eine Liste mit einer einzigen Adresse an. Beim nächsten Aufruf sollte sie verschickt werden. In phpList sehen Sie den Stand unter „Campaigns“ bei der jeweiligen Kampagne. Ab Plus zeigt das Aufrufprotokoll von Cronjob.de zusätzlich die Ausgabe jedes Laufs, etwa „Finished, All done“ oder den Hinweis, dass noch nicht alle Nachrichten verschickt sind.

FAQ

Häufige Fragen zu phpList

Wie oft sollte der phpList-Cronjob laufen?

Das phpList-Handbuch zeigt als Beispiel alle fünf Minuten für die Warteschlange und einmal täglich für die Bounces. Fünf Minuten passen für die meisten Listen. Wie viele Mails je Durchgang rausgehen, steuern Sie über die Stapelverarbeitung („Batch processing“), nicht über den Takt.

Was passiert, wenn ein Aufruf kommt, während der vorige noch läuft?

Nichts Schlimmes. Laut Handbuch erkennt phpList das und bricht den zweiten Lauf ab. So ist immer nur ein Versandvorgang aktiv, und die eingestellten Versandgrenzen werden eingehalten.

Wird der Versand abgeschnitten, wenn der Aufruf endet?

Nein. Laut Handbuch verarbeitet phpList die Warteschlange bei einem Aufruf über die Adresse ohnehin nur etwa eine Minute lang und macht beim nächsten Aufruf weiter. Unser Aufruf wartet 45 Sekunden (kostenlos) beziehungsweise 60 Sekunden (Plus und Unlimited). Wählen Sie die Stapelgröße so, dass ein Durchgang in diese Zeit passt.

Ich bekomme „Error: Incorrect processing secret“.

Dann passt der Wert in der Adresse nicht zum gespeicherten Geheimnis. Prüfen Sie Config → Settings → Security. Zeichen wie &, + oder Leerzeichen stören in einer Adresse; nehmen Sie am einfachsten nur Buchstaben und Ziffern. Sehen Sie stattdessen die Anmeldeseite, fehlt der Parameter secret oder der Pfad stimmt nicht. Bei vielen Installationen liegt phpList unter /lists/.

Kann ich auch die Bounces per Adresse abholen lassen?

Das Handbuch beschreibt die Fernverarbeitung nur für die Warteschlange. Im Quelltext von phpList ist das Geheimnis aber auch für page=processbounces zugelassen. Wenn Sie das nutzen, legen Sie dafür einen eigenen Cronjob an; einmal täglich genügt laut dem Beispiel im Handbuch.