Der Befehl bounce() erstellt eine Nichtzustellbarkeits-Nachricht an den Absender der E-Mail.
Dieser Befehl erzeugt eine Bounce-E-Mail (wird auch Non Delivery Notification (NDN) oder Non-Delivery Report/Receipt (NDR) bezeichnet) und löscht die ursprüngliche E-Mail. Das Aussehen der Bounce-E-Mail wird durch eine Vorlage definiert. Der Absender dieser Bounce-E-Mail ist der Postmaster (siehe Mail System SMTP settings Postmaster address). Optional wird der Header der ursprünglichen E-Mail der Bounce-E-Mail als Dateianlage angehängt.
|
•Die E-Mail wird zunächst vom E-Mail System angenommen und erst mit dem Erstellen der Bounce-E-Mail verworfen (siehe Unterschied zu drop()) •Alle nachfolgenden Befehle werden ignoriert. •Dieser Befehl kann nicht die Bedingung einer if/else Anweisung sein (siehe Abschnitt Kontrollstrukturen - if/else Anweisungen). |
Aufbau des Befehls
bounce('template', ['attach_header']);
Rückgabewert
kein
Parameter
template
Definiert die zu verwendende Vorlage.
Vorlagen werden über die Administrationsoberfläche (siehe Mail System Edit mail templates...) definiert und verwaltet.
attach_header
Dieser Parameter gibt an, ob der Header der ursprünglichen E-Mail der Bounce-E-Mail als Dateianlage angehängt werden soll (true) oder nicht (false).
Mögliche Werte
•true, yes oder 1
•false, no oder 0
Standardeinstellung ist 0
Beispiel 1
Zeile |
Code |
|---|---|
01 |
bounce('bounce','yes'); |
Erklärung
Die Auslieferung der E-Mail soll verhindert werden. Zugleich sollen dem Absender über eine Rück-(Bounce-)E-Mail Informationen bereit gestellt werden. Der Inhalt dieser Rück-E-Mail ist in der Vorlage bounce definiert. Weiterhin wird der Header der nicht ausgelieferten E-Mail als Anlage angehängt (Wert yes des Parameters attach_header).
