PHP - E-Mail versenden

Links

http://www.phpbuddy.eu/emails-mit-php-versenden.html?start=4

E-Mail mit CSS und Anhang

Todo Quelle siehe oben (2012-03)

HTML Email mit CSS Formatierung und Dateianhang

Da wir eine Datei mit der Mail verschicken möchten, muß das Formular natürlich dahingehend erweitert werden, dass ein Upload auch möglich ist. In unserem Beispiel möchten wir eine JPG datei anhängen und erlauben auch nur das hochladen dieses Bildtyps. Die Template Datei ist identisch zum vorherigen HTML Beispiel. In der Datei funktionen.inc.php fügen wir aber eine weitere Funktion hinzu, die für uns prüft, ob eine Datei hochgeladen wurde und ob es sich dabei um eine JPG Datei handelt.

function checkFile()
{
    if ($_FILES['datei']['error'] == 0 &&
        $_FILES['datei']['type'] == 'image/jpeg')
    {
        return $_FILES['datei']['name'];
    }
    else
    {
        die( 'Bitte eine gültige JPG Datei anhängen!' );
    }
}

In der Datei mail.php wird sich nun einiges ändern. Zunächst erweitern wir die einleitende Abfrage dahingehend, dass wir feststellen ob auch eine Datei angehängt wurde ...

if (isset($_POST['senden']) && $_FILES['datei']['size'] > 0)

... und fügen ebenso den Aufruf für die neue Funktion hinzu, die prüft ob ein JPG hochgeladen wurde:

$uploadname = checkFile();

Das weitere Listing der Datei mail.php sieht wie folgt aus:

    // Template mit dem Mailbody laden
    $template = file_get_contents( 'mailbody.txt' );
    // Trenner für den Anhang
    $trenner = md5( time() );
 
    // Platzhalter mit den Benutzereingaben ersetzen
    $template = str_replace( '###NAME###', htmlspecialchars( $name ), $template );
    $template = str_replace( '###EMAIL###', $email, $template );
    $template = str_replace( '###NACHRICHT###', nl2br( htmlspecialchars( $nachricht ) ), $template );
 
    // Mail Header erstellen
    $mailheader .= "Reply-To: " .$name. "<" .$email. ">\r\n";
    $mailheader .= "Return-Path: noreply@" .$_SERVER['SERVER_NAME']. "\r\n";
    $mailheader .= "Message-ID: <" .time(). " noreply@" .$_SERVER['SERVER_NAME']. ">\r\n";
    $mailheader .= "X-Mailer: PHP v" .phpversion(). "\r\n";
    $mailheader .= "From: PHP Email Tutorial<noreply@" .$_SERVER['SERVER_NAME']. ">\r\n";
    $mailheader .= "MIME-Version: 1.0\r\n";
    $mailheader .= "Content-Type: multipart/mixed;\r\n";
    $mailheader .= " boundary = " .$trenner;
    $mailheader .= "\r\n\r\n";
 
    // Mailbody vorbereiten
    $mailbody  = "This is a multi-part message in MIME format\r\n";
    $mailbody .= "--" .$trenner. "\r\n";
    $mailbody .= "Content-Type: text/html; charset=UTF-8\r\n";
    $mailbody .= "Content-Transfer-Encoding: 8bit\r\n\r\n";
    $mailbody .= $template. "\r\n\r\n";
 
    // Anhang anfügen
    $mailbody .= "--" .$trenner. "\r\n";
    $mailbody .= "Content-Type: image/jpeg; name=\"" .$uploadname. "\"\r\n";
    $mailbody .= "Content-Transfer-Encoding: base64\r\n";
    $mailbody .= "Content-Disposition: attachment; filename=\"" .$uploadname. "\"\r\n\r\n";
    $mailbody .= chunk_split( base64_encode( file_get_contents( $_FILES['datei']['tmp_name'] ) ) );
    $mailbody .= "\n";
 
    // Email versenden
    if (@mail( $empfaenger, htmlspecialchars( $betreff ), $mailbody, $mailheader ))
    {
        // Bei erfolgreichem Versand Danke-Seite anzeigen
        echo 'Danke, die Email wurde verschickt!';
    }

Wir sehen auf den ersten Blick, dass dieser Code ganz anders aussieht als das vorherige Beispiel. Gehen wir den Code mal der Reihe nach durch, um etwas Licht in's Dunkel zu bringen.

Im oberen Bereich erzeugen wir einen eindeutigen String, den wir zum trennen der verschiedenen Teilbereiche der Mail verwenden werden:

$trenner = md5( time() );

Der erste Teil des Mail Header ist uns bereits bekannt, aber beim Content-Type benötigen wir nun eine andere Angabe.

$mailheader .= "Content-Type: multipart/mixed;\r\n";

Dieser Content-Type ähnelt der Angabe "multipart/form-data" in einem HTML Formular, wenn wir dort ebenfalls gemischte Inhalte haben, nämlich Text und Dateien. Damit der Mail Client nun weiß an welchen Stellen im gesendeten Quellcode er Inhalte trennen muß, teilen wir im Header den boundary-String mit.

An dieser Stelle möchte ich noch auf 2 wichtige Dinge hinweisen. Das Leerzeichen vor dem "boundary" im Header ist kein Versehen! Es kann tatsächlich dazu führen das eine Mail nicht korrekt dargestellt wird, wenn dieses Leerzeichen fehlt. Ebenso ist es wichtig, dass die "From"-Angabe unmittelbar vor der "MIME-Version" und dem "Content-Type" steht. Vertauscht man die Reihenfolge der Header Angabe, führt das z.B. bei mir dazu, dass ich im Thunderbird nur eine leere Seite als Mail angezeigt bekomme, obwohl der komplette Mail Inhalt im Quelltext einsehbar ist.

Die nächste Zeile ...

$mailbody  = "This is a multi-part message in MIME format\r\n";

... steht vor der Nachricht im Head Bereich in der Email. Sie scheint nicht zwingend erforderlich zu sein, aber Mail Clients fügen diese ebenfalls hinzu, wenn man mit z.B. Thunderbird eine Email verschickt. Ich vermute, dass dies aus Gründen der Kompatibilität zu einigen Mail Server geschieht.

Nun folgt der erste Teil unserer Email, der Text.

    $mailbody .= "--" .$trenner. "\r\n";
    $mailbody .= "Content-Type: text/html; charset=UTF-8\r\n";
    $mailbody .= "Content-Transfer-Encoding: 8bit\r\n\r\n";
    $mailbody .= $template. "\r\n\r\n";

Durch den Trenner teilen wir dem Mail Client mit, dass zwischen diesem Trenner und dem nächsten Trenner, bzw. dem Ende der Mail, ein Teilabschnitt dieser Email steht. Damit der Client weiß um was es sich bei diesem Abschnitt handelt, teilen wir ihm das mithilfe des "Content-Type" und dem "Transfer-Encoding" mit. Durch die Angabe "text/html" weiß nun der Client, dass alles bis zum nächsten Trennen als HTML dargestellt werden soll.

Der nächste Teilabschnitt der Mail ist unser Bild:

    // Anhang anfügen
    $mailbody .= "--" .$trenner. "\r\n";
    $mailbody .= "Content-Type: image/jpeg; name=\"" .$uploadname. "\"\r\n";
    $mailbody .= "Content-Transfer-Encoding: base64\r\n";
    $mailbody .= "Content-Disposition: attachment; filename=\"" .$uploadname. "\"\r\n\r\n";
    $mailbody .= chunk_split( base64_encode( file_get_contents( $_FILES['datei']['tmp_name'] ) ) );
    $mailbody .= "\n";

Wieder folgt zunächst der Trenner. Der Client stoppt seine HTML Ausgabe an dieser Position und wird ab diesem Punkt ausgeben, was ihm durch den "Content-Type" und das "Transfer-Encoding" aufgetragen wird. Wir sehen nun, dass wir als Content-Type eine JPG Datei ausgeben möchten. Der Name ergibt sich aus dem Rückgabewert der Funktion, die den Upload zuvor überprüft hat. Als Transfer-Encoding wird "base64" angegeben. Diese Angabe ist überaus wichtig um eine korrekte Übertragung der Daten zu gewährleisten. Mit der Angabe "Content-Disposition: attachment;" legen wir fest, dass der Anhang wirklich an die Mail angehängt wird. Eine andere Möglichkeit wäre hier das Einbetten in den Mailtext, indem man als Content-Disposition ein "inline" angibt. Die nächste Zeile ist ziemlich tricky:

$mailbody .= chunk_split( base64_encode( file_get_contents( $_FILES['datei']['tmp_name'] ) ) );

Arbeiten wir uns mal von Innen nach Außen durch, weil hier mehrere Funktionen verschachtelt sind. Mit file_get_contents wird eine Datei als String eingelesen. Dies ist hier möglich, weil diese Funktion seit PHP 4.3 binary safe ist. Als einzulesender Dateiname nehmen wir hier den Name der temporären datei, die durch den Upload auf dem Server gelandet ist. Diese Datei steht nur zu genau diesem Zeitpunkt zur Verfügung. Sobald das Script beendet wird oder eine andere Seite geladen wird, existiert diese Datei nicht mehr. Möchte man diese Datei erst zu einem späteren Zeitpunkt verarbeiten, muß man diese zunächst mit move_uploaded_file an eine andere Position kopieren. Da wir nun die Bilddatei als String eingelesen haben, wird er mit base64_encode umgewandelt, damit die Datei beschädigt wird, falls es nicht möglich ist die Mail als 8bit zu übertragen. Es wird also aus Gründen der Kompatibilität gemacht. Anschließend wird der String mit chunk_split so aufbereitet, dass die Zeilenlänge 76 Zeichen nicht übersteigt.

Das war's! Die Daten können nun wieder mit der mail-Funktion versendet werden. Sollte man mehr als eine Datei anhängen wollen, kann man den letzten Schritt beliebig oft wiederholen. Erst Trenner setzen, dann Art der Daten und Übertragungsmodus angeben, die Datei anhängen, fertig.