Suche

InhaltsverzeichnisAnleitung für Entwickler

Besucherzähler und Statistiken Index Formulardaten prüfen

E-Mails versenden

Versionsinformation: Die Funktionen send_mail und form_mail, sowie die Klasse form_mailer wurden in Version 2.8 umbenannt in sendMail, formMail und formMailer, um der Namenskonvention des Frameworks zu entsprechen. Die Funktion sendMail ist ab Version 2.8 eine statische Funktion der Klasse Mailer. Die Funktion formMail ist ab Version 2.8 eine statische Funktion der Klasse FormMailer.

Allgemeines zum Versand von Mails

Das Framework bietet die Funktion Mailer::mail() zum Versand von Mails. Diese Funktion implementiert eine Reihe von Sicherheitsvorkehrungen, zum Schutz vor verschiedenen Arten von Header-Injection.

Die Funktion "Mailer::mail" ist eine gegen Missbrauch und "Header-Injection" abgesicherte Variante der nativen PHP-Funktion "mail". Anders als "mail" werden alle Eingabedaten geprüft und auch nicht alle Header-Informationen, welche "mail" prinzipiell gestattet sind erlaubt.

Es wird "true" zurückgegeben, wenn die Mail versandt werden konnte, "false" sonst. Der Wert "true" bedeutet jedoch nicht, dass die Mail erfolgreich zugestellt wurde. Er bedeutet lediglich, dass die Eingabedaten im Sinne dieser Funktion syntaktisch korrekt waren.

Die Funktion erzeugt im Header der Mail die zusätzlichen Einträge "x-yana-php-header-protection" und "x-yana-php-spam-protection".

• "x-yana-php-header-protection" hat den Wert 0 wenn der übergebene Header unauffällig war, andernfalls 1
• "x-yana-php-spam-protection" hat den Wert 0 wenn der Header kein bcc-Feld enthielt, sonst 1

Wenn Sie eine Mail empfangen, die über YANA versendet wurde, können Sie im Header der Mail die entsprechenden Einträge prüfen, um zu sehen ob das Framework im Nachrichtentext Unregelmäßigkeiten entdeckt hat.

Aus Sicherheitsgründen gelten folgende Einschränkungen.

• Empfänger:     $recipient
  Der Parameter muss eine gültige Mailadresse sein gemäß des regulären Ausdrucks (Perl-Syntax)
  /^[äöüß\w\d-_\.]{1,}\@[äöüß\w\d-_\.]{2,}\.[\w\d-_\.]{2,}$/i

• Betreff:    $subject
  Alle Sonderzeichen außer "()äÄüÜöÖß[]", alle Tags sowie alle Zeilenumbrüche werden still (ohne Warnung) entfernt. Bei einer Länge von mehr als 128 Zeichen werden alle nachfolgenden Zeichen still entfernt.

• Nachrichtentext:    ($text)
  Alle '@'-Zeichen werden still durch die Zeichenkette "[at]" ersetzt. Bei Textnachrichten erfolgt ein automatischer Zeilenumbruch nach spätestens 70 Zeichen. Bei HTML-Nachrichten werden einige potentiell gefährliche Tags still entfernt (Blacklist-Ansatz).

• Header:     $header
  Dieser Parameter ist ein assoziatives Datenfeld. Es darf beliebige X-Header-Daten enthalten, sowie einige unkritische Header-Informationen (Whitelist-Ansatz).

Die Liste der von Header akzeptierten Parameter lautet:

gültige Belegungen für den Parameter $header der Funktion Mailer::mail()

Die Verwendung von "BCC" ist aus Sicherheitsgründen nicht gestattet.

Wie sende ich einen Text als Mail?

<?php 
$recipient = "meineMail@domain.tld";
$subject = "Benachrichtigung";

$mailer = new Mailer("skins/mein_skin/beispiel.mail");
$mailer->subject = $subject;
$mailer->sender  = $ARGS["mail"];
$mailer->insert("NAME", $ARGS["name"]);
$mailer->insert("NACHRICHT", $ARGS["nachricht"]);
$mailer->insert("IP", $_SERVER["REMOTE_ADDR"]);
$test = $mailer->send($recipient);

if ($test === true) {
    print "Versand erfolgreich";
} else if ($test === false) {
    print "Versand nicht erfolgreich";
}
?>

Wie sende ich eine Mail auf Basis eines Templates?

<?php 
$recipient = "meineMail@domain.tld";
$subject = "Benachrichtigung";

$mailer = new Mailer("skins/mein_skin/beispiel.mail");
$mailer->subject = $subject;
$mailer->sender  = $ARGS["mail"];
$mailer->insert("NAME", $ARGS["name"]);
$mailer->insert("NACHRICHT", $ARGS["nachricht"]);
$mailer->insert("IP", $_SERVER["REMOTE_ADDR"]);
$test = $mailer->send($recipient);

if ($test === true) {
    print "Versand erfolgreich";
} else if ($test === false) {
    print "Versand nicht erfolgreich";
}
?>

Anmerkung: vor dem Versand der E-Mail prüft die Funktion $mailer->send() die Eingabedaten automatisch auf Versuche von Header-Injection und säubert alle Eingaben. Es kann jedoch absolut nichts schaden, wenn Sie die Syntax der Eingabedaten trotzdem auch in Ihrem Skript noch einmal überprüfen bevor Sie die Funktion aufrufen.

Wie versende ich Daten aus einem Formular als Mail?

<?php 
$formMailer = new FormMailer();
// Betreff
$formMailer->subject = "Benachrichtigung";
// Kopf- und Fusszeile
$formMailer->headline = "Inhalte des Kontaktformulars:\n\n"
$formMailer->footline = "\n\nYANA formmailer at ".$_SERVER['SERVER_NAME'];
// Formularinhalt
$formMailer->content = $_POST;

$test = $formMailer->send("meineMail@domain.tld");

if ($test === true) {
    print "Versand erfolgreich";
} else if ($test === false) {
    print "Versand nicht erfolgreich";
}
?>

Besucherzähler und Statistiken Index Formulardaten prüfen

Thomas Meyer, www.yanaframework.net