Der Befehl drop() verweigert das Annehmen einer E-Mail und gibt an das absendende System den angegebenen SMTP-Code mit einen frei definierbarem Informationstext zurück.
|
•Die eingehende E-Mail wird nicht angenommen (siehe Unterschied zu bounce()) •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
drop(['smtp_code'], ['text']);
.
Rückgabewert
positiv |
immer |
Parameter
smtp_code (optional)
Der smtp_code gibt den Grund für das Zurückweisen einer E-Mail an.
Die Bedeutung der Codes gliedert sich wie folgt:
1XX |
Mailserver hat die Anforderung akzeptiert, ist aber selbst noch nicht tätig geworden. Eine Bestätigungsmeldung ist erforderlich. |
2XX |
Mailserver hat die Anforderung erfolgreich ohne Fehler ausgeführt. |
3XX |
Mailserver hat die Anforderung verstanden, benötigt aber zur Verarbeitung weitere Informationen. |
4XX |
Mailserver hat einen temporären Fehler festgestellt. Wenn die Anforderung ohne jegliche Änderung wiederholt wird, kann die Verarbeitung möglicherweise abgeschlossen werden. |
5XX |
Mailserver hat einen fatalen Fehler festgestellt. Die Anforderung kann nicht verarbeitet werden. |
|
Quelle: Wikipedia Detaillierte Auflistungen der Fehlercodes sind zum Beispiel unter www.supermailer.de/smtp_reply_codes.htm zu finden. |
Default: Wird dieser Parameter nicht angegeben, so wird der Code „555“ verwendet.
text (optional)
Der Informationstext spezifiziert den Grund des Abweisens näher.
Default: Wird dieser Parameter nicht angegeben, so wird der Text „mail NOT accepted“ ausgegeben.
Beispiel 1
Zeile |
Code |
|---|---|
01 |
drop('451','Die Nachricht konnte nicht entschluesselt werden'); |
Erklärung
In diesem Beispiel wird eine E-Mail mit dem Fehlercode „451 - Die Nachricht konnte nicht entschlüsselt werden“ abgewiesen. Im System-Log wird für diese Aktion folgender Eintrag generiert: „Message Rejected. (451 - Die Nachricht konnte nicht entschlüsselt werden)“.
