Wikizone - Benutzerbeiträge [de]

PHP - E-Mail versenden

2012-03-13T10:43:08Z

178.7.132.100: /* E-Mail mit CSS und Anhang */

Links

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

=== Einfache Text E-Mail mit Template ===
Einfache Text Email

Zuerst das Listing unserer Template Datei mailbody.txt

Soeben ist eine Nachricht von ###NAME### eingetroffen.
Als Antwortadresse wurde ###EMAIL### angegeben.
Die Nachricht die gesendet wurde:
###NACHRICHT###

Wie man unschwer erkennt, ist das ganz normaler und schlichter Text. Lediglich die Platzhalter darin fallen auf. Diese Platzhalter korrespondieren in unserem Script mit den Benutzereingaben und werden in unserem Script durch diese ersetzt.
Dadurch das wir den Text, der später per Email an uns geschickt wird, in einer eigenen Datei ablegen, können wir den Text schnell und flexibel beliebig verändern und erweitern. Da es sich hierbei um einen Mailer handelt der nur reinen Text verschickt, müssen wir auf jegliche Art von Formatierungen verzichten.

Bisher haben wir das HTML-Formular, die Funktionen und das Mail Template kennengelernt, fehlt nur noch das Hauptscript, dass wir uns gleich mal vorknöpfen.

Listing der Datei mail.php

<?php

header( 'Content-Type: text/html; charset=utf-8' );

// Empfänger Email
$empfaenger = 'max.mustermann@domain.tld';

// Prüfen ob das Formular abgeschickt wurde
if (isset($_POST['senden']))
{
// Funktionen einbinden
include( 'funktionen.inc.php' );

// Benutzereingaben bereinigen und auf Injection prüfen
cleanInput();

// Name prüfen
$name = checkName( $_POST['name'] );
// Email prüfen
$email = checkEmail( $_POST['email'] );
// Betreff und Nachricht prüfen
if ((strlen( $_POST['betreff'] ) < 5) || (strlen( $_POST['nachricht'] ) < 5))
{
die( 'Bitte füllen Sie alle Felder aus!' );
}
else
{
$betreff = $_POST['betreff'];
$nachricht = $_POST['nachricht'];
}

// --------------------------------------------------------------------------------
// Wurde das Script bisher nicht abgebrochen, wurde das Formular korrekt ausgefüllt
// --------------------------------------------------------------------------------

// Template mit dem Mailbody laden und für den Versand vorbereiten
$mailbody = file_get_contents( 'mailbody.txt' );
// Platzhalter mit den Benutzereingaben ersetzen
$mailbody = str_replace( '###NAME###', htmlspecialchars( $name ), $mailbody );
$mailbody = str_replace( '###EMAIL###', $email, $mailbody );
$mailbody = str_replace( '###NACHRICHT###', htmlspecialchars( $nachricht ), $mailbody );

// Mail Header erstellen
$mailheader = "From: PHP Email Tutorial<noreply@" .$_SERVER['SERVER_NAME']. ">\r\n";
$mailheader .= "Reply-To: " .$name. "<" .$email. ">\r\n";
$mailheader .= "Return-Path: noreply@" .$_SERVER['SERVER_NAME']. "\r\n";
$mailheader .= "MIME-Version: 1.0\r\n";
$mailheader .= "Content-Type: text/plain; charset=UTF-8\r\n";
$mailheader .= "Content-Transfer-Encoding: 7bit\r\n";
$mailheader .= "Message-ID: <" .time(). " noreply@" .$_SERVER['SERVER_NAME']. ">\r\n";
$mailheader .= "X-Mailer: PHP v" .phpversion(). "\r\n\r\n";

// Email versenden
if (@mail( $empfaenger, htmlspecialchars( $betreff ), $mailbody, $mailheader ))
{
// Bei erfolgreichem Versand Danke-Seite anzeigen
echo 'Danke, die Email wurde verschickt!';
}
}

?>

Das sieht im ersten Moment mehr und wilder aus, als es das eigentlich ist. Der obere Teil ist schnell erklärt. Zunächst setzen wir die Email des Empfängers, der idR wir selbst sind. Dann wird geprüft ob das Formular überhaupt abgeschickt wurde und wenn dem so ist, binden wir die benötigten Funktionen ein und überprüfen die Benutzereingaben.

Mit den Zeilen ...

// Template mit dem Mailbody laden und für den Versand vorbereiten
$mailbody = file_get_contents( 'mailbody.txt' );
// Platzhalter mit den Benutzereingaben ersetzen
$mailbody = str_replace( '###NAME###', htmlspecialchars( $name ), $mailbody );
$mailbody = str_replace( '###EMAIL###', $email, $mailbody );
$mailbody = str_replace( '###NACHRICHT###', htmlspecialchars( $nachricht ), $mailbody );

... laden wir das Mail Template (file_get_contents) und ersetzen mit einfachen str_replace Funktionen die Platzhalter. Auch wenn wir bereits auf mögliche Injections geprüft haben, entschärfen wir dennoch die Eingaben mit htmlspecialchars, damit uns niemand etwas unterschiebt. Bei der Email ist das nicht nötig, da diese sonst nicht durch den Filter gekommen wäre.

Jetzt kommen wir zu dem wichtigsten Teil, der ein erfolgreiches Versenden überhaupt erst möglich macht: dem Mail Header.

Der Mail Header ist der Kopf der Email, der alle relevanten und wichtigen Informationen über unsere Email enthält. Sehr sehr häufig sieht man in Scripts und Tutorials, dass hier lediglich das "From:" angegeben ist. Wenn nur diese Information angegeben ist, bleibt die Mail sehr häufig in einem Spamfilter hängen. Kein Mensch würde auf die Idee kommen einen echten Brief zu verschicken und als Beschreibung auf dem Brief nur einen Name angeben, ohne komplette Anschrift und Absenderadresse. Wieso dann bei einer Email?!

Schauen wir uns also an wie ein Header aussieht, der die wichtigsten Angaben enthält:

$mailheader = "From: PHP Email Tutorial<noreply@" .$_SERVER['SERVER_NAME']. ">\r\n";
$mailheader .= "Reply-To: " .$name. "<" .$email. ">\r\n";
$mailheader .= "Return-Path: noreply@" .$_SERVER['SERVER_NAME']. "\r\n";
$mailheader .= "MIME-Version: 1.0\r\n";
$mailheader .= "Content-Type: text/plain; charset=UTF-8\r\n";
$mailheader .= "Content-Transfer-Encoding: 7bit\r\n";
$mailheader .= "Message-ID: <" .time(). " noreply@" .$_SERVER['SERVER_NAME']. ">\r\n";
$mailheader .= "X-Mailer: PHP v" .phpversion(). "\r\n\r\n";

Die Steuerungzeichen "\r\n" entsprechen einen Wagenrücklauf und Zeilenvorschub oder anders ausgedrückt, ein Zeilenumbruch. Diese Steuerungzeichen sind betriebssystemabhängig und müssen ggfs. angepasst werden. Auf Linux würde man z.B. nur "\n" verwenden. Schauen wir uns nun die anderen angaben an:

From - Das ist die Absendeadresse und der dazugehörige Name. Es ist üblich diesen in der Form Name anzugeben. Das ist die absolute Minimumangabe für inen Mailheader. Fehlt das From, wird der Versand der Mail fehlschlagen.
Reply-To - Das Format kann entweder nur eine Email Adresse sein, oder man wählt das Format wir bei From. Dieses Feld ist die Antwortadresse an die die Mail geschickt wird, wenn wir im Mail Client auf antworten klicken.
Return-Path - Konnte die Mail nicht zugestellt werden, wird dies an diese Adresse gemeldet.
MIME-Version - Entspricht dem MIME Typ der Mail.
Content-Type - Das ist die Information die dem Mail Client mitteilt, um welche Art Mail es sich handelt und welcher Zeichensatz zur Darstellung benutzt werden soll.
Content-Transfer-Encoding - Dies beschreibt die Art der Übertragung und wie sowohl Mailserver, als auch Email Clients diese Mail interpretieren. 7bit ist die kleinste Form, die maximal mögliche Kompatibilität ermöglicht. Beim 7bit ASCII Zeichensatz können die ersten 128 zeichen der ASCII Tabelle dargestellt werden. Zeichen wie deutsche Umlaute sind darin nicht vorgesehen. Bei der 8bit Übertragung können bis zu 256 zeichen dargestellt werden. Ältere Mailerver, so liest man, verstehen nur 7bit und verwerfen Anfragen die mit 8bit übertragen werden sollen. Anders ausgedrückt, es kann passieren das die Mail nicht ankommt. Ich persönlich hatte damit allerdings noch nie Probleme und die 7bit "Zwangsangabe" scheint veraltet zu sein.
Message-ID - Die Message ID ist einmalig, bzw. sollte es sein, wodurch die Mail eindeutig zugeordnet werden kann.
X-Mailer - Beschreibt den Client der die Mail versendet hat. In unserem Fall geben wir die PHP Version an, damit Mailserver auf der Route wissen, dass diese Mail mit PHP verschickt wurde.

Es gibt noch weitere Felder und Varianten, die uns aber im moment nicht kümmern. Im Abschnitt Mail mit Anhang werden wir noch einen etwas anderen Header kennen lernen.
Speziell die letzten beiden Angaben (Message ID und X_Mailer) im Header oben sind sehr wichtige Informationen. Fehlen diese Angaben, ist die Wahrscheinlichkeit sehr hoch, dass die Mail niemals beim Empfänger ankommen wird, weil die Mail irgendwo unterwegs in einem Spamfilter hängen bleibt und nicht weitergeleitet wird!

Falls also eine Mail nicht ankommt, liegt das in den aller meisten Fällen entweder am Transfer-Encoding (7bit oder 8bit) oder an fehlenden Absendeangaben!

Der Rest des Scripts ist sehr einfach, weil hier einfach nur noch die Mail verschickt wird.

if (@mail( $empfaenger, htmlspecialchars( $betreff ), $mailbody, $mailheader ))
{
// Bei erfolgreichem Versand Danke-Seite anzeigen
echo 'Danke, die Email wurde verschickt!';
}

Die mail-Funktion kennt noch einen 5. Parameter auf den ich jetzt nicht eingehen werde, weil dieser nur in den seltensten Fällen unterstützt wird. Wer mehr darüber erfahren möchte kann sich darüber in der Online-Doku informieren. Die mail-Funktion selbst liefert entweder TRUE oder FALSE zurück. Bei einem FALSE konnte die Mail nicht für den Versand übergeben werden und wir können entsprechend darauf reagieren. Im Falle von TRUE heisst das zwar das die Mail für den Versand angenommen wurde, aber es ist nicht prüfbar ob die Mail auch tatsächlich beim Empfänger ankam! Einige Gründe dafür stehen weiter oben. Wurde die Mail für den Versand akzeptiert, können wir darauf angemessen reagieren, indem wir den Besucher zu einer Danke-Seite weiterleiten oder, was weiter unter gezeigt wird, dem Benutzer eine Empfangsbestätigung, respektive Kopie der Mail an seine Adresse schicken.

Soweit so gut. Dieser Abschnitt fiel etwas länger aus, weil ich die prinzipielle Funktionsweise und den Header beschrieben habe. Die nachfolgenden Beispiele sind über große Strecken identisch, deswegen spare ich mir dort die Erklärungen und gehe nur auf die abweichenden Passagen ein.

=== E-Mail mit CSS Formatierung ===

Eine Email im HTML Format zu senden ist im Grunde genommen nichts anderes, als eine einzelne Webseite per Email zu verschicken. Wir haben also mehr oder weniger freie Hand was die Gestaltung angeht, solange wir uns an die HTML und CSS Richtlinien halten. Das wird sofort ersichtlicht, wenn man das Template für die Email sieht.

Listing der Datei mailbody.txt
<pre>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="de" lang="de">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<title>Email als HTML</title>
<style type="text/css">
body { font: normal 12px Verdana, Arial, Helvetica, sans-serif; }
a { color: blue; text-decoration: none; }
h2 { font-size: 16px; font-weight: bold; }
.gruen { color: green; }
</style>
</head>

<body>
<h2>Soeben ist eine Nachricht von <span class="gruen">###NAME###</span> eingetroffen.</h2>
<p>Als Antwortadresse wurde <a href="mailto:###EMAIL###">###EMAIL###</a> angegeben.</p>
<p>Die Nachricht die gesendet wurde lautet:<br />
###NACHRICHT###</p>
</body>
</html>
</pre>

Das Template besteht aus einer normalen HTML Datei mit etwas CSS. Auch hier treffen wir wieder unsere Platzhalter, die durch die Benutzereingaben ersetzt werden.

Die Datei funktionen.inc.php ist identisch mit wie beim vorherigen Beispiel. Auch die mail.php weicht nur minimal vom letzten Beispiel ab - das aber mit großer Wirkung!
Die erste Abweichung findet in der Zeile zum ersetzen des Platzhalters für die Nachricht statt.

$mailbody = str_replace( '###NACHRICHT###', nl2br( htmlspecialchars( $nachricht ) ), $mailbody );

Ergänzt wurde hier die Funktion nl2br. Diese Funktion bewirkt, dass das Steuerungzeichen für einen Zeilenumbruch (\n) in ein HTML-konformes Break (<br />) umgewandelt wird. Ohne diese Funktion hätten wir bei der Ausgabe nur eine laaaange Zeile Text ohne neue Absätze und Umbrüche.

Die nächsten beiden Veränderungen finden im Mail Header statt. Da wird nun ja keinen reinen Text, sondern HTML verschicken, muß natürlich der Content-Type angepasst werden. Ebenso ändern wir das Transfer-Encoding auf 8bit. Hier die beiden geänderten Zeilen:

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

That's it!
Diese kleinen Veränderungen haben eine solch große Auswirkung auf die Art der Darstellung!

Das Ergebnis im Mail Client:

(Deutlich zu sehen das die H2-Überschrift sich absetzt und auch der Name durch das CSS farblich hervorgehoben wird)

Vermutlich stand jeder angehende Programmierer schon mal an dieser Stelle. Voller Stolz blickt man in sein Postfach, wo die erste Mail vom eigenen Formmailer eingetroffen ist. Dann denkt man sich: "Das war ja einfach, mit nur so wenigen Zeilen Code so ein Ergebnis zu erzielen. Wie schwer kann es da schon sein auch eine Datei mitzuschicken?!".
Angesichts der oben gezeigten Beispiele, und wie minimal der Unterschied zwischen Text Mail und HTML Mail ist, neigt man dazu zu denken, dass dies mit einem Dateianhang ebenso einfach ist.

Tja, leider ist dem nicht so. Das senden von Dateianhänge ist erheblich aufwändiger als das senden einer Text/HTML Mail. Das Formular ist abweichend, der Mail Header ist abweichend, der Mail Body muß in einzelne Teilbereiche getrennt werden, Dateianhänge müssen Richtlinien beachten, was die Zeilenlänge und die Art der Zeichen innerhalb der Mail angeht.
Glücklicherweise hilft uns PHP bei den meisten Sachen und deshalb werden wir auch dieses Problem meistern. :)

=== 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.

<pre>
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!' );
}
}
</pre>

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:
<pre>
// 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!';
}

</pre>

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.
<pre>
$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";
</pre>
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:
<pre>
// 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";
</pre>
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.

=== E-Mail mit Empfangsbestätigung ===

Eine Empfangsbestätigung verschicken

Das ist genauso einfach wie das verschicken einer ganz einfachen Textmail. Wie wir ja bereits gehört haben, gibt die mail-Funktion bei Erfolg ein TRUE zurück. Damit können wir also feststellen, ob die Nachricht des Benutzers an uns übermittelt wurde und falls ja, schicken wir ihm eine Mail als Bestätigung. Das sieht in etwa so aus:
<pre>
if (@mail( $empfaenger, htmlspecialchars( $betreff ), $mailbody, $mailheader ))
{
// Bei erfolgreichem Versand Danke-Seite anzeigen
$mailheader = "From: Firma Max Mustermann<mustermann@domain.tld>\r\n";
$mailheader .= "Reply-To: Firma Max Mustermann<mustermann@domain.tld>\r\n";
$mailheader .= "Return-Path: noreply@" .$_SERVER['SERVER_NAME']. "\r\n";
$mailheader .= "MIME-Version: 1.0\r\n";
$mailheader .= "Content-Type: text/plain; charset=UTF-8\r\n";
$mailheader .= "Content-Transfer-Encoding: 7bit\r\n";
$mailheader .= "Message-ID: <" .time(). " noreply@" .$_SERVER['SERVER_NAME']. ">\r\n";
$mailheader .= "X-Mailer: PHP v" .phpversion(). "\r\n\r\n";

// Inhalt der Bestätigung
$mailbody = 'Vielen Dank für Ihre Email. Wir werden uns in Kürze bei Ihnen melden.';

// Bestätigung verschicken
if (@mail( $email, "Die Firma Max Mustermann bedankt sich", $mailbody, $mailheader ))
{
// Bestätigung wurde verschickt
}
}
</pre>
Das ist im Prinzip der selbe Code wie zuvor in der Text Mail. Es werden lediglich einige Kleinigkeiten im Mail Header angepasst, damit der Benutzer auch weiß, wer ihm schreibt und wohin er antworten kann.

Damit sollten die meisten Fragen zum Thema "Wie versendet man eine Email mit PHP" geklärt sein. Wer Fragen oder Anregungen hat, kann sie gerne in diesem Thread stellen.

PHP - E-Mail versenden

2012-03-13T10:42:32Z

178.7.132.100: /* E-Mail mit CSS Formatierung */

PHP - E-Mail versenden

2012-03-13T10:41:35Z

178.7.132.100: /* E-Mail mit CSS und Anhang */

Links

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

=== Einfache Text E-Mail mit Template ===
Einfache Text Email

Zuerst das Listing unserer Template Datei mailbody.txt

Soeben ist eine Nachricht von ###NAME### eingetroffen.
Als Antwortadresse wurde ###EMAIL### angegeben.
Die Nachricht die gesendet wurde:
###NACHRICHT###

Wie man unschwer erkennt, ist das ganz normaler und schlichter Text. Lediglich die Platzhalter darin fallen auf. Diese Platzhalter korrespondieren in unserem Script mit den Benutzereingaben und werden in unserem Script durch diese ersetzt.
Dadurch das wir den Text, der später per Email an uns geschickt wird, in einer eigenen Datei ablegen, können wir den Text schnell und flexibel beliebig verändern und erweitern. Da es sich hierbei um einen Mailer handelt der nur reinen Text verschickt, müssen wir auf jegliche Art von Formatierungen verzichten.

Bisher haben wir das HTML-Formular, die Funktionen und das Mail Template kennengelernt, fehlt nur noch das Hauptscript, dass wir uns gleich mal vorknöpfen.

Listing der Datei mail.php

<?php

header( 'Content-Type: text/html; charset=utf-8' );

// Empfänger Email
$empfaenger = 'max.mustermann@domain.tld';

// Prüfen ob das Formular abgeschickt wurde
if (isset($_POST['senden']))
{
// Funktionen einbinden
include( 'funktionen.inc.php' );

// Benutzereingaben bereinigen und auf Injection prüfen
cleanInput();

// Name prüfen
$name = checkName( $_POST['name'] );
// Email prüfen
$email = checkEmail( $_POST['email'] );
// Betreff und Nachricht prüfen
if ((strlen( $_POST['betreff'] ) < 5) || (strlen( $_POST['nachricht'] ) < 5))
{
die( 'Bitte füllen Sie alle Felder aus!' );
}
else
{
$betreff = $_POST['betreff'];
$nachricht = $_POST['nachricht'];
}

// --------------------------------------------------------------------------------
// Wurde das Script bisher nicht abgebrochen, wurde das Formular korrekt ausgefüllt
// --------------------------------------------------------------------------------

// Template mit dem Mailbody laden und für den Versand vorbereiten
$mailbody = file_get_contents( 'mailbody.txt' );
// Platzhalter mit den Benutzereingaben ersetzen
$mailbody = str_replace( '###NAME###', htmlspecialchars( $name ), $mailbody );
$mailbody = str_replace( '###EMAIL###', $email, $mailbody );
$mailbody = str_replace( '###NACHRICHT###', htmlspecialchars( $nachricht ), $mailbody );

// Mail Header erstellen
$mailheader = "From: PHP Email Tutorial<noreply@" .$_SERVER['SERVER_NAME']. ">\r\n";
$mailheader .= "Reply-To: " .$name. "<" .$email. ">\r\n";
$mailheader .= "Return-Path: noreply@" .$_SERVER['SERVER_NAME']. "\r\n";
$mailheader .= "MIME-Version: 1.0\r\n";
$mailheader .= "Content-Type: text/plain; charset=UTF-8\r\n";
$mailheader .= "Content-Transfer-Encoding: 7bit\r\n";
$mailheader .= "Message-ID: <" .time(). " noreply@" .$_SERVER['SERVER_NAME']. ">\r\n";
$mailheader .= "X-Mailer: PHP v" .phpversion(). "\r\n\r\n";

// Email versenden
if (@mail( $empfaenger, htmlspecialchars( $betreff ), $mailbody, $mailheader ))
{
// Bei erfolgreichem Versand Danke-Seite anzeigen
echo 'Danke, die Email wurde verschickt!';
}
}

?>

Das sieht im ersten Moment mehr und wilder aus, als es das eigentlich ist. Der obere Teil ist schnell erklärt. Zunächst setzen wir die Email des Empfängers, der idR wir selbst sind. Dann wird geprüft ob das Formular überhaupt abgeschickt wurde und wenn dem so ist, binden wir die benötigten Funktionen ein und überprüfen die Benutzereingaben.

Mit den Zeilen ...

// Template mit dem Mailbody laden und für den Versand vorbereiten
$mailbody = file_get_contents( 'mailbody.txt' );
// Platzhalter mit den Benutzereingaben ersetzen
$mailbody = str_replace( '###NAME###', htmlspecialchars( $name ), $mailbody );
$mailbody = str_replace( '###EMAIL###', $email, $mailbody );
$mailbody = str_replace( '###NACHRICHT###', htmlspecialchars( $nachricht ), $mailbody );

... laden wir das Mail Template (file_get_contents) und ersetzen mit einfachen str_replace Funktionen die Platzhalter. Auch wenn wir bereits auf mögliche Injections geprüft haben, entschärfen wir dennoch die Eingaben mit htmlspecialchars, damit uns niemand etwas unterschiebt. Bei der Email ist das nicht nötig, da diese sonst nicht durch den Filter gekommen wäre.

Jetzt kommen wir zu dem wichtigsten Teil, der ein erfolgreiches Versenden überhaupt erst möglich macht: dem Mail Header.

Der Mail Header ist der Kopf der Email, der alle relevanten und wichtigen Informationen über unsere Email enthält. Sehr sehr häufig sieht man in Scripts und Tutorials, dass hier lediglich das "From:" angegeben ist. Wenn nur diese Information angegeben ist, bleibt die Mail sehr häufig in einem Spamfilter hängen. Kein Mensch würde auf die Idee kommen einen echten Brief zu verschicken und als Beschreibung auf dem Brief nur einen Name angeben, ohne komplette Anschrift und Absenderadresse. Wieso dann bei einer Email?!

Schauen wir uns also an wie ein Header aussieht, der die wichtigsten Angaben enthält:

$mailheader = "From: PHP Email Tutorial<noreply@" .$_SERVER['SERVER_NAME']. ">\r\n";
$mailheader .= "Reply-To: " .$name. "<" .$email. ">\r\n";
$mailheader .= "Return-Path: noreply@" .$_SERVER['SERVER_NAME']. "\r\n";
$mailheader .= "MIME-Version: 1.0\r\n";
$mailheader .= "Content-Type: text/plain; charset=UTF-8\r\n";
$mailheader .= "Content-Transfer-Encoding: 7bit\r\n";
$mailheader .= "Message-ID: <" .time(). " noreply@" .$_SERVER['SERVER_NAME']. ">\r\n";
$mailheader .= "X-Mailer: PHP v" .phpversion(). "\r\n\r\n";

Die Steuerungzeichen "\r\n" entsprechen einen Wagenrücklauf und Zeilenvorschub oder anders ausgedrückt, ein Zeilenumbruch. Diese Steuerungzeichen sind betriebssystemabhängig und müssen ggfs. angepasst werden. Auf Linux würde man z.B. nur "\n" verwenden. Schauen wir uns nun die anderen angaben an:

From - Das ist die Absendeadresse und der dazugehörige Name. Es ist üblich diesen in der Form Name anzugeben. Das ist die absolute Minimumangabe für inen Mailheader. Fehlt das From, wird der Versand der Mail fehlschlagen.
Reply-To - Das Format kann entweder nur eine Email Adresse sein, oder man wählt das Format wir bei From. Dieses Feld ist die Antwortadresse an die die Mail geschickt wird, wenn wir im Mail Client auf antworten klicken.
Return-Path - Konnte die Mail nicht zugestellt werden, wird dies an diese Adresse gemeldet.
MIME-Version - Entspricht dem MIME Typ der Mail.
Content-Type - Das ist die Information die dem Mail Client mitteilt, um welche Art Mail es sich handelt und welcher Zeichensatz zur Darstellung benutzt werden soll.
Content-Transfer-Encoding - Dies beschreibt die Art der Übertragung und wie sowohl Mailserver, als auch Email Clients diese Mail interpretieren. 7bit ist die kleinste Form, die maximal mögliche Kompatibilität ermöglicht. Beim 7bit ASCII Zeichensatz können die ersten 128 zeichen der ASCII Tabelle dargestellt werden. Zeichen wie deutsche Umlaute sind darin nicht vorgesehen. Bei der 8bit Übertragung können bis zu 256 zeichen dargestellt werden. Ältere Mailerver, so liest man, verstehen nur 7bit und verwerfen Anfragen die mit 8bit übertragen werden sollen. Anders ausgedrückt, es kann passieren das die Mail nicht ankommt. Ich persönlich hatte damit allerdings noch nie Probleme und die 7bit "Zwangsangabe" scheint veraltet zu sein.
Message-ID - Die Message ID ist einmalig, bzw. sollte es sein, wodurch die Mail eindeutig zugeordnet werden kann.
X-Mailer - Beschreibt den Client der die Mail versendet hat. In unserem Fall geben wir die PHP Version an, damit Mailserver auf der Route wissen, dass diese Mail mit PHP verschickt wurde.

Es gibt noch weitere Felder und Varianten, die uns aber im moment nicht kümmern. Im Abschnitt Mail mit Anhang werden wir noch einen etwas anderen Header kennen lernen.
Speziell die letzten beiden Angaben (Message ID und X_Mailer) im Header oben sind sehr wichtige Informationen. Fehlen diese Angaben, ist die Wahrscheinlichkeit sehr hoch, dass die Mail niemals beim Empfänger ankommen wird, weil die Mail irgendwo unterwegs in einem Spamfilter hängen bleibt und nicht weitergeleitet wird!

Falls also eine Mail nicht ankommt, liegt das in den aller meisten Fällen entweder am Transfer-Encoding (7bit oder 8bit) oder an fehlenden Absendeangaben!

Der Rest des Scripts ist sehr einfach, weil hier einfach nur noch die Mail verschickt wird.

if (@mail( $empfaenger, htmlspecialchars( $betreff ), $mailbody, $mailheader ))
{
// Bei erfolgreichem Versand Danke-Seite anzeigen
echo 'Danke, die Email wurde verschickt!';
}

Die mail-Funktion kennt noch einen 5. Parameter auf den ich jetzt nicht eingehen werde, weil dieser nur in den seltensten Fällen unterstützt wird. Wer mehr darüber erfahren möchte kann sich darüber in der Online-Doku informieren. Die mail-Funktion selbst liefert entweder TRUE oder FALSE zurück. Bei einem FALSE konnte die Mail nicht für den Versand übergeben werden und wir können entsprechend darauf reagieren. Im Falle von TRUE heisst das zwar das die Mail für den Versand angenommen wurde, aber es ist nicht prüfbar ob die Mail auch tatsächlich beim Empfänger ankam! Einige Gründe dafür stehen weiter oben. Wurde die Mail für den Versand akzeptiert, können wir darauf angemessen reagieren, indem wir den Besucher zu einer Danke-Seite weiterleiten oder, was weiter unter gezeigt wird, dem Benutzer eine Empfangsbestätigung, respektive Kopie der Mail an seine Adresse schicken.

Soweit so gut. Dieser Abschnitt fiel etwas länger aus, weil ich die prinzipielle Funktionsweise und den Header beschrieben habe. Die nachfolgenden Beispiele sind über große Strecken identisch, deswegen spare ich mir dort die Erklärungen und gehe nur auf die abweichenden Passagen ein.

=== E-Mail mit CSS Formatierung ===
HTML Email mit CSS Formatierung

Eine Email im HTML Format zu senden ist im Grunde genommen nichts anderes, als eine einzelne Webseite per Email zu verschicken. Wir haben also mehr oder weniger freie Hand was die Gestaltung angeht, solange wir uns an die HTML und CSS Richtlinien halten. Das wird sofort ersichtlicht, wenn man das Template für die Email sieht.

Listing der Datei mailbody.txt

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="de" lang="de">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<title>Email als HTML</title>
<style type="text/css">
body { font: normal 12px Verdana, Arial, Helvetica, sans-serif; }
a { color: blue; text-decoration: none; }
h2 { font-size: 16px; font-weight: bold; }
.gruen { color: green; }
</style>
</head>

<body>
<h2>Soeben ist eine Nachricht von <span class="gruen">###NAME###</span> eingetroffen.</h2>
<p>Als Antwortadresse wurde <a href="mailto:###EMAIL###">###EMAIL###</a> angegeben.</p>
<p>Die Nachricht die gesendet wurde lautet:<br />
###NACHRICHT###</p>
</body>
</html>

Das Template besteht aus einer normalen HTML Datei mit etwas CSS. Auch hier treffen wir wieder unsere Platzhalter, die durch die Benutzereingaben ersetzt werden.

Die Datei funktionen.inc.php ist identisch mit wie beim vorherigen Beispiel. Auch die mail.php weicht nur minimal vom letzten Beispiel ab - das aber mit großer Wirkung!
Die erste Abweichung findet in der Zeile zum ersetzen des Platzhalters für die Nachricht statt.

$mailbody = str_replace( '###NACHRICHT###', nl2br( htmlspecialchars( $nachricht ) ), $mailbody );

Ergänzt wurde hier die Funktion nl2br. Diese Funktion bewirkt, dass das Steuerungzeichen für einen Zeilenumbruch (\n) in ein HTML-konformes Break (<br />) umgewandelt wird. Ohne diese Funktion hätten wir bei der Ausgabe nur eine laaaange Zeile Text ohne neue Absätze und Umbrüche.

Die nächsten beiden Veränderungen finden im Mail Header statt. Da wird nun ja keinen reinen Text, sondern HTML verschicken, muß natürlich der Content-Type angepasst werden. Ebenso ändern wir das Transfer-Encoding auf 8bit. Hier die beiden geänderten Zeilen:

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

That's it!
Diese kleinen Veränderungen haben eine solch große Auswirkung auf die Art der Darstellung!

Das Ergebnis im Mail Client:

(Deutlich zu sehen das die H2-Überschrift sich absetzt und auch der Name durch das CSS farblich hervorgehoben wird)

Vermutlich stand jeder angehende Programmierer schon mal an dieser Stelle. Voller Stolz blickt man in sein Postfach, wo die erste Mail vom eigenen Formmailer eingetroffen ist. Dann denkt man sich: "Das war ja einfach, mit nur so wenigen Zeilen Code so ein Ergebnis zu erzielen. Wie schwer kann es da schon sein auch eine Datei mitzuschicken?!".
Angesichts der oben gezeigten Beispiele, und wie minimal der Unterschied zwischen Text Mail und HTML Mail ist, neigt man dazu zu denken, dass dies mit einem Dateianhang ebenso einfach ist.

Tja, leider ist dem nicht so. Das senden von Dateianhänge ist erheblich aufwändiger als das senden einer Text/HTML Mail. Das Formular ist abweichend, der Mail Header ist abweichend, der Mail Body muß in einzelne Teilbereiche getrennt werden, Dateianhänge müssen Richtlinien beachten, was die Zeilenlänge und die Art der Zeichen innerhalb der Mail angeht.
Glücklicherweise hilft uns PHP bei den meisten Sachen und deshalb werden wir auch dieses Problem meistern. :)

=== 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.

<pre>
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!' );
}
}
</pre>

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:
<pre>
// 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!';
}

</pre>

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.
<pre>
$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";
</pre>
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:
<pre>
// 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";
</pre>
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.

PHP - E-Mail versenden

2012-03-13T10:40:47Z

178.7.132.100: /* E-Mail mit CSS und Anhang */

Links

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

=== Einfache Text E-Mail mit Template ===
Einfache Text Email

Zuerst das Listing unserer Template Datei mailbody.txt

Soeben ist eine Nachricht von ###NAME### eingetroffen.
Als Antwortadresse wurde ###EMAIL### angegeben.
Die Nachricht die gesendet wurde:
###NACHRICHT###

Wie man unschwer erkennt, ist das ganz normaler und schlichter Text. Lediglich die Platzhalter darin fallen auf. Diese Platzhalter korrespondieren in unserem Script mit den Benutzereingaben und werden in unserem Script durch diese ersetzt.
Dadurch das wir den Text, der später per Email an uns geschickt wird, in einer eigenen Datei ablegen, können wir den Text schnell und flexibel beliebig verändern und erweitern. Da es sich hierbei um einen Mailer handelt der nur reinen Text verschickt, müssen wir auf jegliche Art von Formatierungen verzichten.

Bisher haben wir das HTML-Formular, die Funktionen und das Mail Template kennengelernt, fehlt nur noch das Hauptscript, dass wir uns gleich mal vorknöpfen.

Listing der Datei mail.php

<?php

header( 'Content-Type: text/html; charset=utf-8' );

// Empfänger Email
$empfaenger = 'max.mustermann@domain.tld';

// Prüfen ob das Formular abgeschickt wurde
if (isset($_POST['senden']))
{
// Funktionen einbinden
include( 'funktionen.inc.php' );

// Benutzereingaben bereinigen und auf Injection prüfen
cleanInput();

// Name prüfen
$name = checkName( $_POST['name'] );
// Email prüfen
$email = checkEmail( $_POST['email'] );
// Betreff und Nachricht prüfen
if ((strlen( $_POST['betreff'] ) < 5) || (strlen( $_POST['nachricht'] ) < 5))
{
die( 'Bitte füllen Sie alle Felder aus!' );
}
else
{
$betreff = $_POST['betreff'];
$nachricht = $_POST['nachricht'];
}

// --------------------------------------------------------------------------------
// Wurde das Script bisher nicht abgebrochen, wurde das Formular korrekt ausgefüllt
// --------------------------------------------------------------------------------

// Template mit dem Mailbody laden und für den Versand vorbereiten
$mailbody = file_get_contents( 'mailbody.txt' );
// Platzhalter mit den Benutzereingaben ersetzen
$mailbody = str_replace( '###NAME###', htmlspecialchars( $name ), $mailbody );
$mailbody = str_replace( '###EMAIL###', $email, $mailbody );
$mailbody = str_replace( '###NACHRICHT###', htmlspecialchars( $nachricht ), $mailbody );

// Mail Header erstellen
$mailheader = "From: PHP Email Tutorial<noreply@" .$_SERVER['SERVER_NAME']. ">\r\n";
$mailheader .= "Reply-To: " .$name. "<" .$email. ">\r\n";
$mailheader .= "Return-Path: noreply@" .$_SERVER['SERVER_NAME']. "\r\n";
$mailheader .= "MIME-Version: 1.0\r\n";
$mailheader .= "Content-Type: text/plain; charset=UTF-8\r\n";
$mailheader .= "Content-Transfer-Encoding: 7bit\r\n";
$mailheader .= "Message-ID: <" .time(). " noreply@" .$_SERVER['SERVER_NAME']. ">\r\n";
$mailheader .= "X-Mailer: PHP v" .phpversion(). "\r\n\r\n";

// Email versenden
if (@mail( $empfaenger, htmlspecialchars( $betreff ), $mailbody, $mailheader ))
{
// Bei erfolgreichem Versand Danke-Seite anzeigen
echo 'Danke, die Email wurde verschickt!';
}
}

?>

Das sieht im ersten Moment mehr und wilder aus, als es das eigentlich ist. Der obere Teil ist schnell erklärt. Zunächst setzen wir die Email des Empfängers, der idR wir selbst sind. Dann wird geprüft ob das Formular überhaupt abgeschickt wurde und wenn dem so ist, binden wir die benötigten Funktionen ein und überprüfen die Benutzereingaben.

Mit den Zeilen ...

// Template mit dem Mailbody laden und für den Versand vorbereiten
$mailbody = file_get_contents( 'mailbody.txt' );
// Platzhalter mit den Benutzereingaben ersetzen
$mailbody = str_replace( '###NAME###', htmlspecialchars( $name ), $mailbody );
$mailbody = str_replace( '###EMAIL###', $email, $mailbody );
$mailbody = str_replace( '###NACHRICHT###', htmlspecialchars( $nachricht ), $mailbody );

... laden wir das Mail Template (file_get_contents) und ersetzen mit einfachen str_replace Funktionen die Platzhalter. Auch wenn wir bereits auf mögliche Injections geprüft haben, entschärfen wir dennoch die Eingaben mit htmlspecialchars, damit uns niemand etwas unterschiebt. Bei der Email ist das nicht nötig, da diese sonst nicht durch den Filter gekommen wäre.

Jetzt kommen wir zu dem wichtigsten Teil, der ein erfolgreiches Versenden überhaupt erst möglich macht: dem Mail Header.

Der Mail Header ist der Kopf der Email, der alle relevanten und wichtigen Informationen über unsere Email enthält. Sehr sehr häufig sieht man in Scripts und Tutorials, dass hier lediglich das "From:" angegeben ist. Wenn nur diese Information angegeben ist, bleibt die Mail sehr häufig in einem Spamfilter hängen. Kein Mensch würde auf die Idee kommen einen echten Brief zu verschicken und als Beschreibung auf dem Brief nur einen Name angeben, ohne komplette Anschrift und Absenderadresse. Wieso dann bei einer Email?!

Schauen wir uns also an wie ein Header aussieht, der die wichtigsten Angaben enthält:

$mailheader = "From: PHP Email Tutorial<noreply@" .$_SERVER['SERVER_NAME']. ">\r\n";
$mailheader .= "Reply-To: " .$name. "<" .$email. ">\r\n";
$mailheader .= "Return-Path: noreply@" .$_SERVER['SERVER_NAME']. "\r\n";
$mailheader .= "MIME-Version: 1.0\r\n";
$mailheader .= "Content-Type: text/plain; charset=UTF-8\r\n";
$mailheader .= "Content-Transfer-Encoding: 7bit\r\n";
$mailheader .= "Message-ID: <" .time(). " noreply@" .$_SERVER['SERVER_NAME']. ">\r\n";
$mailheader .= "X-Mailer: PHP v" .phpversion(). "\r\n\r\n";

Die Steuerungzeichen "\r\n" entsprechen einen Wagenrücklauf und Zeilenvorschub oder anders ausgedrückt, ein Zeilenumbruch. Diese Steuerungzeichen sind betriebssystemabhängig und müssen ggfs. angepasst werden. Auf Linux würde man z.B. nur "\n" verwenden. Schauen wir uns nun die anderen angaben an:

From - Das ist die Absendeadresse und der dazugehörige Name. Es ist üblich diesen in der Form Name anzugeben. Das ist die absolute Minimumangabe für inen Mailheader. Fehlt das From, wird der Versand der Mail fehlschlagen.
Reply-To - Das Format kann entweder nur eine Email Adresse sein, oder man wählt das Format wir bei From. Dieses Feld ist die Antwortadresse an die die Mail geschickt wird, wenn wir im Mail Client auf antworten klicken.
Return-Path - Konnte die Mail nicht zugestellt werden, wird dies an diese Adresse gemeldet.
MIME-Version - Entspricht dem MIME Typ der Mail.
Content-Type - Das ist die Information die dem Mail Client mitteilt, um welche Art Mail es sich handelt und welcher Zeichensatz zur Darstellung benutzt werden soll.
Content-Transfer-Encoding - Dies beschreibt die Art der Übertragung und wie sowohl Mailserver, als auch Email Clients diese Mail interpretieren. 7bit ist die kleinste Form, die maximal mögliche Kompatibilität ermöglicht. Beim 7bit ASCII Zeichensatz können die ersten 128 zeichen der ASCII Tabelle dargestellt werden. Zeichen wie deutsche Umlaute sind darin nicht vorgesehen. Bei der 8bit Übertragung können bis zu 256 zeichen dargestellt werden. Ältere Mailerver, so liest man, verstehen nur 7bit und verwerfen Anfragen die mit 8bit übertragen werden sollen. Anders ausgedrückt, es kann passieren das die Mail nicht ankommt. Ich persönlich hatte damit allerdings noch nie Probleme und die 7bit "Zwangsangabe" scheint veraltet zu sein.
Message-ID - Die Message ID ist einmalig, bzw. sollte es sein, wodurch die Mail eindeutig zugeordnet werden kann.
X-Mailer - Beschreibt den Client der die Mail versendet hat. In unserem Fall geben wir die PHP Version an, damit Mailserver auf der Route wissen, dass diese Mail mit PHP verschickt wurde.

Es gibt noch weitere Felder und Varianten, die uns aber im moment nicht kümmern. Im Abschnitt Mail mit Anhang werden wir noch einen etwas anderen Header kennen lernen.
Speziell die letzten beiden Angaben (Message ID und X_Mailer) im Header oben sind sehr wichtige Informationen. Fehlen diese Angaben, ist die Wahrscheinlichkeit sehr hoch, dass die Mail niemals beim Empfänger ankommen wird, weil die Mail irgendwo unterwegs in einem Spamfilter hängen bleibt und nicht weitergeleitet wird!

Falls also eine Mail nicht ankommt, liegt das in den aller meisten Fällen entweder am Transfer-Encoding (7bit oder 8bit) oder an fehlenden Absendeangaben!

Der Rest des Scripts ist sehr einfach, weil hier einfach nur noch die Mail verschickt wird.

if (@mail( $empfaenger, htmlspecialchars( $betreff ), $mailbody, $mailheader ))
{
// Bei erfolgreichem Versand Danke-Seite anzeigen
echo 'Danke, die Email wurde verschickt!';
}

Die mail-Funktion kennt noch einen 5. Parameter auf den ich jetzt nicht eingehen werde, weil dieser nur in den seltensten Fällen unterstützt wird. Wer mehr darüber erfahren möchte kann sich darüber in der Online-Doku informieren. Die mail-Funktion selbst liefert entweder TRUE oder FALSE zurück. Bei einem FALSE konnte die Mail nicht für den Versand übergeben werden und wir können entsprechend darauf reagieren. Im Falle von TRUE heisst das zwar das die Mail für den Versand angenommen wurde, aber es ist nicht prüfbar ob die Mail auch tatsächlich beim Empfänger ankam! Einige Gründe dafür stehen weiter oben. Wurde die Mail für den Versand akzeptiert, können wir darauf angemessen reagieren, indem wir den Besucher zu einer Danke-Seite weiterleiten oder, was weiter unter gezeigt wird, dem Benutzer eine Empfangsbestätigung, respektive Kopie der Mail an seine Adresse schicken.

Soweit so gut. Dieser Abschnitt fiel etwas länger aus, weil ich die prinzipielle Funktionsweise und den Header beschrieben habe. Die nachfolgenden Beispiele sind über große Strecken identisch, deswegen spare ich mir dort die Erklärungen und gehe nur auf die abweichenden Passagen ein.

=== 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.

<pre>
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!' );
}
}
</pre>

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:
<pre>
// 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!';
}

</pre>

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.
<pre>
$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";
</pre>
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:
<pre>
// 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";
</pre>
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.

PHP - Validieren von Benutzereingaben

2012-03-13T10:39:09Z

178.7.132.100: Die Seite wurde neu angelegt: „ == Beispielfunktionen für die Validierung in PHP == Quelle: http://www.phpbuddy.eu/emails-mit-php-versenden.html?start=1 2012-03 <pre> <?php header( 'Conten…“

== Beispielfunktionen für die Validierung in PHP ==

Quelle: http://www.phpbuddy.eu/emails-mit-php-versenden.html?start=1 2012-03

<pre>
<?php

header( 'Content-Type: text/html; charset=utf-8' );

// Benutzereingabe bereinigen (trimmen, Slashes entfernen)
function cleanInput()
{
checkInjection();
if (get_magic_quotes_gpc()) $_POST = array_map( 'stripslashes', $_POST );
$_POST = array_map( 'trim', $_POST );
}

// Name auf Gültigkeit prüfen
function checkName( $name )
{
$muster_name = '/^([a-zA-ZäÄöÖüÜß\xc0-\xc2\xc8-\xcf\xd2-\xd4\xd9-\xdb\xe0-\xe2\xe8-\xef\xf2-\xf4\xf9-\xfb\x9f\xff\.\'\-_]?(\s)?)+$/';
if (preg_match( $muster_name, $name ))
{
return $name;
}
else
{
die( 'Der eingegebene Name enthält nicht erlaubte Zeichen!' );
}
}

// Email auf korrektes Format prüfen
function checkEmail( $email )
{
$nonascii = "\x80-\xff";
$nqtext = "[^\\\\$nonascii\015\012\"]";
$qchar = "\\\\[^$nonascii]";
$normuser = '[a-zA-Z0-9][a-zA-Z0-9_.-]*';
$quotedstring = "\"(?:$nqtext|$qchar)+\"";
$user_part = "(?:$normuser|$quotedstring)";
$dom_mainpart = '[a-zA-Z0-9][a-zA-Z0-9._-]*\\.';
$dom_subpart = '(?:[a-zA-Z0-9][a-zA-Z0-9._-]*\\.)*';
$dom_tldpart = '[a-zA-Z]{2,5}';
$domain_part = "$dom_subpart$dom_mainpart$dom_tldpart";
$pattern = "$user_part\@$domain_part";
$muster_email = "/^{$pattern}$/";
if (preg_match( $muster_email, $email ))
{
return $email;
}
else
{
die( 'Die eingegebene Email-Adresse hat kein gültiges Format!' );
}
}

// Benutzereingaben auf mögliche Injection prüfen
function checkInjection()
{
$email_injection = array( 'bcc:', 'boundary', 'cc:', 'content-transfer-encoding:', 'content-type:', 'mime-version:', 'subject:' );

// Auf potentielle Email Injections prüfen
foreach ($email_injection as $injection)
{
foreach ($_POST as $feld => $inhalt)
{
if (preg_match( "/{$injection}/i", $inhalt ))
{
header( 'location: http://www.google.com/search?hl=en&q=how+to+become+a+better+hacker' );
exit;
}
}
}
return true;
}

?>

</pre>

PHP - Tipps und Tricks

2012-03-13T10:37:55Z

178.7.132.100: /* E-Mails mit php versenden */

== Links ==
http://www.phpbuddy.eu/

== E-Mails mit php versenden ==
[[PHP - E-Mail versenden]]

siehe auch

[[PHP - Validieren von Benutzereingaben]]

== Bilder schützen und nur über php ausliefern ==
1a Schutz per htaccess, so daß nur Zugriffe vom eigenen Server zulässig sind.
1b. Verzeichnisrechte so setzen, daß nur php-Nutzer lesen kann (oder einfach ein schwer zu erratender Verzeichnisname) -> kann man aber z.B. mit iFrame umgehen ist also weniger als Schutz praktisch, reicht aber, wenn man zur Laufzeit eine andere Variante des Bildes liefern will.
2. PHP Skript liefert die Bilder -> hier kann man dann User Access, Zeitsteuerung etc. regeln.

Beispiel htaccess:

Zugriff auf das Verzeichnis nur über php nicht über direktzugriff

order deny,allow
deny from all

Hierbei sind auf Bilder nur Zugriffe von der eigenen Domain erlaubt, ansonsten kommt ein Ersatzbild. Eignet sich z.B. um Traffic durch Bilderklau vorzubeugen.

<pre>
RewriteEngine on
RewriteCond %{HTTP_REFERER} !^$
RewriteCond %{HTTP_REFERER} !^http://(www.)?mydomain.de(/.*)?$ [NC]
RewriteRule .(gif|jpg|GIF|JPG)$ http://www.myDomain.de/images/ersatz.gif [R,L]
</pre>

<pre>
<?php
if ($_SESSION['eingeloggt'] == true) {
header('Content-Type: image/jpeg');
readfile('bild.jpg');
} else {
echo 'Kein Direktzugriff erlaubt';
}
?>
</pre>

Weitere Beispiele mit htaccess:

Beispiel mit Ersatzgrafik und mehreren URL's:
Kann ja sein, dass man mehrere Homepages hat, die darauf zurückgreifen dürfen. Folgendes überträgst Du ins Notepad und speicherst es als .htaccess ab:
<pre>
RewriteEngine on
RewriteCond %{HTTP_REFERER} !^$
RewriteCond %{HTTP_REFERER} !^http://(www.)?webmaster-eye.de(/.*)?$ [NC]
RewriteCond %{HTTP_REFERER} !^http://(www.)?mynickpage.de(/.*)?$ [NC]
RewriteRule .(gif|jpg|GIF|JPG)$ http://www.webmaster-eye.de/images/ersatz.gif [R,L]
</pre>

Beispiel mit dem roten X:
Folgendes überträgst Du ins Notepad und speicherst es als .htaccess ab:
<pre>
RewriteEngine on
RewriteCond %{HTTP_REFERER} !^$
RewriteCond %{HTTP_REFERER} !^http://(www.)?webmaster-eye.de(/.*)?$ [NC]
RewriteRule .(gif|jpg)$ - [F]
</pre>

Quelle der htaccess Beispiele: http://www.webmaster-eye.de/Traffic-sparen-mit-htaccess-als-Bilder-Schutz.242.artikel.html (11/2011)

== Weiterleitung mit PHP ==
<pre>
header("Location: http://www.myHomepage.net");
exit;
</pre>
== Ausgaben zwischenspeichern oder in Variablen umleiten ==
'''Problem: Die Ausgabe von echo oder von includes soll zuerst in einer Variablen gespeichert werden, damit Sie nicht gleich ausgegeben werden.'''

Das läßt sich lösen indem man die Ausgabe zunächst puffert und dann den Puffer in eine Variable lädt.
basicartsstudios at hotmail dot com
21-Jan-2007 10:39
Sometimes you might not want to include a php-file under the specifications defined in the functions include() or require(), but you might want to have in return the string that the script in the file "echoes".

Include() and require() both directly put out the evaluated code.

For avoiding this, try output-buffering:
<pre>
<?php
ob_start();
eval(file_get_contents($file));
$result = ob_get_contents();
ob_end_clean();
?>
</pre>

or

<pre>
<?php
ob_start();
include($file);
$result = ob_get_contents();
ob_end_clean();
?>
</pre>

which i consider the same, correct me if I'm wrong.

Best regards, BasicArtsStudios

== Umlaute, UTF-8 und PHP: wenn Sonderzeichen falsch dargestellt werden ==
Quelle: http://www.sjmfreelancing.de/devblog/umlaute-utf-8-und-php.html (15.10.2008)

Ich habe des öfteren das Problem gehabt, dass Sonderzeichen auf PHP-basierten Internetseiten nicht korrekt angezeigt wurden und Firefox ein gerahmtes Fragezeichen statt Ü, ü etc. ausgab, der Internet Explorer einen Kasten und auch Safari&Co. Probleme hatten.

Lange war ich auf der Suche nach der richtigen Lösung für dieses Problem und habe mich durch unterschiedliche Blogs, Foren und Internetseiten gewühlt bis ich letztendlich eine Ansammlung verschiedenster Tipps & Tricks aufgenommen und in Kombination angewandt habe. Und siehe da: Sonderzeichen sind korrekt :)

Hier ein paar Dinge, die jeder Programmierer beherzigen sollte, wenn er mit Umlauten umgeht:
'''1. Header korrekt setzen'''
Mit einem Einzeiler kann man PHP dazu bringen einen UTF-8-Header an den Browser zu senden. Einfach folgenden Code ganz oben in der Index-Datei setzen:

header('content-type: text/html; charset=UTF-8');

2. HTML-Header korrekt setzen

Folgenden Code in den HEAD-Bereich des HTML-Dokuments setzen:
view plaincopy to clipboardprint?

<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />

3. PHP-Dateien im UTF-8-Format speichern

Ganz wichtig ist es die PHP-Dateien die man verwendet im UTF-8-Format zu speichern. Sprich: den Editor dazu zu bringen, die Datei mit Umlauten zu speichern.
4. MySQL dazu bewegen UTF-8 zu nutzen

MySQL liefert auch nicht (immer) von Haus aus UTF-8-korrekte Ausgaben. Folgendes MySQL-Query einfach nach dem connecten mit der Datenbank ausführen:

mysql_query('set character set utf8;');

5. Das &-Zeichen immer escapen

Zwar nicht direkt ein Problem, aber: ü, ä, ß etc. sind auch dann korrektes HTML, wenn man sie nicht mittels htmlentities in Entitäten umgewandelt hat. Anders sieht es mit dem Kaufmanns-Und (&) aus: diesen IMMER mit & ausgeben. Auch bei Links gilt: & durch <code>&</code> ersetzen!

== Validieren von Werten aus Eingabefeldern ==
[[PHP - Validierung von Werten aus Eingabefeldern]]

== Sicherheit in PHP Skripts ==

PHP - Tipps und Tricks

2012-03-13T10:35:20Z

178.7.132.100:

== Links ==
http://www.phpbuddy.eu/

== E-Mails mit php versenden ==
[[PHP - E-Mail versenden]]

== Bilder schützen und nur über php ausliefern ==
1a Schutz per htaccess, so daß nur Zugriffe vom eigenen Server zulässig sind.
1b. Verzeichnisrechte so setzen, daß nur php-Nutzer lesen kann (oder einfach ein schwer zu erratender Verzeichnisname) -> kann man aber z.B. mit iFrame umgehen ist also weniger als Schutz praktisch, reicht aber, wenn man zur Laufzeit eine andere Variante des Bildes liefern will.
2. PHP Skript liefert die Bilder -> hier kann man dann User Access, Zeitsteuerung etc. regeln.

Beispiel htaccess:

Zugriff auf das Verzeichnis nur über php nicht über direktzugriff

order deny,allow
deny from all

Hierbei sind auf Bilder nur Zugriffe von der eigenen Domain erlaubt, ansonsten kommt ein Ersatzbild. Eignet sich z.B. um Traffic durch Bilderklau vorzubeugen.

<pre>
RewriteEngine on
RewriteCond %{HTTP_REFERER} !^$
RewriteCond %{HTTP_REFERER} !^http://(www.)?mydomain.de(/.*)?$ [NC]
RewriteRule .(gif|jpg|GIF|JPG)$ http://www.myDomain.de/images/ersatz.gif [R,L]
</pre>

<pre>
<?php
if ($_SESSION['eingeloggt'] == true) {
header('Content-Type: image/jpeg');
readfile('bild.jpg');
} else {
echo 'Kein Direktzugriff erlaubt';
}
?>
</pre>

Weitere Beispiele mit htaccess:

Beispiel mit Ersatzgrafik und mehreren URL's:
Kann ja sein, dass man mehrere Homepages hat, die darauf zurückgreifen dürfen. Folgendes überträgst Du ins Notepad und speicherst es als .htaccess ab:
<pre>
RewriteEngine on
RewriteCond %{HTTP_REFERER} !^$
RewriteCond %{HTTP_REFERER} !^http://(www.)?webmaster-eye.de(/.*)?$ [NC]
RewriteCond %{HTTP_REFERER} !^http://(www.)?mynickpage.de(/.*)?$ [NC]
RewriteRule .(gif|jpg|GIF|JPG)$ http://www.webmaster-eye.de/images/ersatz.gif [R,L]
</pre>

Beispiel mit dem roten X:
Folgendes überträgst Du ins Notepad und speicherst es als .htaccess ab:
<pre>
RewriteEngine on
RewriteCond %{HTTP_REFERER} !^$
RewriteCond %{HTTP_REFERER} !^http://(www.)?webmaster-eye.de(/.*)?$ [NC]
RewriteRule .(gif|jpg)$ - [F]
</pre>

Quelle der htaccess Beispiele: http://www.webmaster-eye.de/Traffic-sparen-mit-htaccess-als-Bilder-Schutz.242.artikel.html (11/2011)

== Weiterleitung mit PHP ==
<pre>
header("Location: http://www.myHomepage.net");
exit;
</pre>
== Ausgaben zwischenspeichern oder in Variablen umleiten ==
'''Problem: Die Ausgabe von echo oder von includes soll zuerst in einer Variablen gespeichert werden, damit Sie nicht gleich ausgegeben werden.'''

Das läßt sich lösen indem man die Ausgabe zunächst puffert und dann den Puffer in eine Variable lädt.
basicartsstudios at hotmail dot com
21-Jan-2007 10:39
Sometimes you might not want to include a php-file under the specifications defined in the functions include() or require(), but you might want to have in return the string that the script in the file "echoes".

Include() and require() both directly put out the evaluated code.

For avoiding this, try output-buffering:
<pre>
<?php
ob_start();
eval(file_get_contents($file));
$result = ob_get_contents();
ob_end_clean();
?>
</pre>

or

<pre>
<?php
ob_start();
include($file);
$result = ob_get_contents();
ob_end_clean();
?>
</pre>

which i consider the same, correct me if I'm wrong.

Best regards, BasicArtsStudios

== Umlaute, UTF-8 und PHP: wenn Sonderzeichen falsch dargestellt werden ==
Quelle: http://www.sjmfreelancing.de/devblog/umlaute-utf-8-und-php.html (15.10.2008)

Ich habe des öfteren das Problem gehabt, dass Sonderzeichen auf PHP-basierten Internetseiten nicht korrekt angezeigt wurden und Firefox ein gerahmtes Fragezeichen statt Ü, ü etc. ausgab, der Internet Explorer einen Kasten und auch Safari&Co. Probleme hatten.

Lange war ich auf der Suche nach der richtigen Lösung für dieses Problem und habe mich durch unterschiedliche Blogs, Foren und Internetseiten gewühlt bis ich letztendlich eine Ansammlung verschiedenster Tipps & Tricks aufgenommen und in Kombination angewandt habe. Und siehe da: Sonderzeichen sind korrekt :)

Hier ein paar Dinge, die jeder Programmierer beherzigen sollte, wenn er mit Umlauten umgeht:
'''1. Header korrekt setzen'''
Mit einem Einzeiler kann man PHP dazu bringen einen UTF-8-Header an den Browser zu senden. Einfach folgenden Code ganz oben in der Index-Datei setzen:

header('content-type: text/html; charset=UTF-8');

2. HTML-Header korrekt setzen

Folgenden Code in den HEAD-Bereich des HTML-Dokuments setzen:
view plaincopy to clipboardprint?

<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />

3. PHP-Dateien im UTF-8-Format speichern

Ganz wichtig ist es die PHP-Dateien die man verwendet im UTF-8-Format zu speichern. Sprich: den Editor dazu zu bringen, die Datei mit Umlauten zu speichern.
4. MySQL dazu bewegen UTF-8 zu nutzen

MySQL liefert auch nicht (immer) von Haus aus UTF-8-korrekte Ausgaben. Folgendes MySQL-Query einfach nach dem connecten mit der Datenbank ausführen:

mysql_query('set character set utf8;');

5. Das &-Zeichen immer escapen

Zwar nicht direkt ein Problem, aber: ü, ä, ß etc. sind auch dann korrektes HTML, wenn man sie nicht mittels htmlentities in Entitäten umgewandelt hat. Anders sieht es mit dem Kaufmanns-Und (&) aus: diesen IMMER mit & ausgeben. Auch bei Links gilt: & durch <code>&</code> ersetzen!

== Validieren von Werten aus Eingabefeldern ==
[[PHP - Validierung von Werten aus Eingabefeldern]]

== Sicherheit in PHP Skripts ==

PHP - E-Mail versenden

2012-03-13T10:33:42Z

178.7.132.100:

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.

<pre>
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!' );
}
}
</pre>

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:
<pre>
// 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!';
}

</pre>

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.
<pre>
$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";
</pre>
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:
<pre>
// 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";
</pre>
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.

PHP - E-Mail versenden

2012-03-13T10:32:32Z

178.7.132.100: Die Seite wurde neu angelegt: „Links http://www.phpbuddy.eu/emails-mit-php-versenden.html?start=4 Todo Quelle siehe oben Emails mit PHP versenden - HTML Email mit Anhang Beitragsseiten Ema…“

Links

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

Todo Quelle siehe oben

Emails mit PHP versenden - HTML Email mit Anhang
Beitragsseiten
Emails mit PHP versenden
Gemeinsam benutzte Funktionen
Einfache Text Email
HTML Email mit CSS Formatierung
HTML Email mit Anhang
Empfangsbestätigung an Absender
Alle Seiten
Seite 5 von 6
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.

<pre>
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!' );
}
}
</pre>

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:
<pre>
// 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!';
}

</pre>

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.
<pre>
$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";
</pre>
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:
<pre>
// 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";
</pre>
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.

PHP - Tipps und Tricks

2012-03-13T10:30:00Z

178.7.132.100:

== E-Mails mit php versenden ==
[[PHP - E-Mail versenden]]

== Bilder schützen und nur über php ausliefern ==
1a Schutz per htaccess, so daß nur Zugriffe vom eigenen Server zulässig sind.
1b. Verzeichnisrechte so setzen, daß nur php-Nutzer lesen kann (oder einfach ein schwer zu erratender Verzeichnisname) -> kann man aber z.B. mit iFrame umgehen ist also weniger als Schutz praktisch, reicht aber, wenn man zur Laufzeit eine andere Variante des Bildes liefern will.
2. PHP Skript liefert die Bilder -> hier kann man dann User Access, Zeitsteuerung etc. regeln.

Beispiel htaccess:

Zugriff auf das Verzeichnis nur über php nicht über direktzugriff

order deny,allow
deny from all

Hierbei sind auf Bilder nur Zugriffe von der eigenen Domain erlaubt, ansonsten kommt ein Ersatzbild. Eignet sich z.B. um Traffic durch Bilderklau vorzubeugen.

<pre>
RewriteEngine on
RewriteCond %{HTTP_REFERER} !^$
RewriteCond %{HTTP_REFERER} !^http://(www.)?mydomain.de(/.*)?$ [NC]
RewriteRule .(gif|jpg|GIF|JPG)$ http://www.myDomain.de/images/ersatz.gif [R,L]
</pre>

<pre>
<?php
if ($_SESSION['eingeloggt'] == true) {
header('Content-Type: image/jpeg');
readfile('bild.jpg');
} else {
echo 'Kein Direktzugriff erlaubt';
}
?>
</pre>

Weitere Beispiele mit htaccess:

Beispiel mit Ersatzgrafik und mehreren URL's:
Kann ja sein, dass man mehrere Homepages hat, die darauf zurückgreifen dürfen. Folgendes überträgst Du ins Notepad und speicherst es als .htaccess ab:
<pre>
RewriteEngine on
RewriteCond %{HTTP_REFERER} !^$
RewriteCond %{HTTP_REFERER} !^http://(www.)?webmaster-eye.de(/.*)?$ [NC]
RewriteCond %{HTTP_REFERER} !^http://(www.)?mynickpage.de(/.*)?$ [NC]
RewriteRule .(gif|jpg|GIF|JPG)$ http://www.webmaster-eye.de/images/ersatz.gif [R,L]
</pre>

Beispiel mit dem roten X:
Folgendes überträgst Du ins Notepad und speicherst es als .htaccess ab:
<pre>
RewriteEngine on
RewriteCond %{HTTP_REFERER} !^$
RewriteCond %{HTTP_REFERER} !^http://(www.)?webmaster-eye.de(/.*)?$ [NC]
RewriteRule .(gif|jpg)$ - [F]
</pre>

Quelle der htaccess Beispiele: http://www.webmaster-eye.de/Traffic-sparen-mit-htaccess-als-Bilder-Schutz.242.artikel.html (11/2011)

== Weiterleitung mit PHP ==
<pre>
header("Location: http://www.myHomepage.net");
exit;
</pre>
== Ausgaben zwischenspeichern oder in Variablen umleiten ==
'''Problem: Die Ausgabe von echo oder von includes soll zuerst in einer Variablen gespeichert werden, damit Sie nicht gleich ausgegeben werden.'''

Das läßt sich lösen indem man die Ausgabe zunächst puffert und dann den Puffer in eine Variable lädt.
basicartsstudios at hotmail dot com
21-Jan-2007 10:39
Sometimes you might not want to include a php-file under the specifications defined in the functions include() or require(), but you might want to have in return the string that the script in the file "echoes".

Include() and require() both directly put out the evaluated code.

For avoiding this, try output-buffering:
<pre>
<?php
ob_start();
eval(file_get_contents($file));
$result = ob_get_contents();
ob_end_clean();
?>
</pre>

or

<pre>
<?php
ob_start();
include($file);
$result = ob_get_contents();
ob_end_clean();
?>
</pre>

which i consider the same, correct me if I'm wrong.

Best regards, BasicArtsStudios

== Umlaute, UTF-8 und PHP: wenn Sonderzeichen falsch dargestellt werden ==
Quelle: http://www.sjmfreelancing.de/devblog/umlaute-utf-8-und-php.html (15.10.2008)

Ich habe des öfteren das Problem gehabt, dass Sonderzeichen auf PHP-basierten Internetseiten nicht korrekt angezeigt wurden und Firefox ein gerahmtes Fragezeichen statt Ü, ü etc. ausgab, der Internet Explorer einen Kasten und auch Safari&Co. Probleme hatten.

Lange war ich auf der Suche nach der richtigen Lösung für dieses Problem und habe mich durch unterschiedliche Blogs, Foren und Internetseiten gewühlt bis ich letztendlich eine Ansammlung verschiedenster Tipps & Tricks aufgenommen und in Kombination angewandt habe. Und siehe da: Sonderzeichen sind korrekt :)

Hier ein paar Dinge, die jeder Programmierer beherzigen sollte, wenn er mit Umlauten umgeht:
'''1. Header korrekt setzen'''
Mit einem Einzeiler kann man PHP dazu bringen einen UTF-8-Header an den Browser zu senden. Einfach folgenden Code ganz oben in der Index-Datei setzen:

header('content-type: text/html; charset=UTF-8');

2. HTML-Header korrekt setzen

Folgenden Code in den HEAD-Bereich des HTML-Dokuments setzen:
view plaincopy to clipboardprint?

<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />

3. PHP-Dateien im UTF-8-Format speichern

Ganz wichtig ist es die PHP-Dateien die man verwendet im UTF-8-Format zu speichern. Sprich: den Editor dazu zu bringen, die Datei mit Umlauten zu speichern.
4. MySQL dazu bewegen UTF-8 zu nutzen

MySQL liefert auch nicht (immer) von Haus aus UTF-8-korrekte Ausgaben. Folgendes MySQL-Query einfach nach dem connecten mit der Datenbank ausführen:

mysql_query('set character set utf8;');

5. Das &-Zeichen immer escapen

Zwar nicht direkt ein Problem, aber: ü, ä, ß etc. sind auch dann korrektes HTML, wenn man sie nicht mittels htmlentities in Entitäten umgewandelt hat. Anders sieht es mit dem Kaufmanns-Und (&) aus: diesen IMMER mit & ausgeben. Auch bei Links gilt: & durch <code>&</code> ersetzen!

== Validieren von Werten aus Eingabefeldern ==
[[PHP - Validierung von Werten aus Eingabefeldern]]

== Sicherheit in PHP Skripts ==

Typo3 - Mehrsprachige Seiten

2012-03-07T18:20:44Z

178.7.132.100: /* Quickstart */

Siehe auch: [[Typo3 - Standardeinstellungen]]

== Quickstart ==
=== One Tree Multilanguage Basic TS ===
Default Sprache wäre hier en (uid = 0)

<pre>
config{
// more properties for multilanguage pages
linkVars = L(1-10)
uniqueLinkVars = 1
sys_language_mode = content_fallback
}

// Language Settings for second language

[globalVar = GP:L=1]
config {
language = de
locale_all = de_DE
htmlTag_langKey = de
sys_language_uid = 1
}
[global]
[globalVar = GP:L=2]
config {
language = es
locale_all = es_ES
htmlTag_langKey = es
sys_language_uid = 2
}
[global]
[globalVar = GP:L=3]
config {
language = fr
locale_all = fr_FR
htmlTag_langKey = fr
sys_language_uid = 3
}
[global]
[globalVar = GP:L=4]
config {
language = it
locale_all = it_IT
htmlTag_langKey = it
sys_language_uid = 4
}
[global]
</pre>
=== Sprachmenü Textversion ===
<pre>
########################################
### Standard Sprachmenu (TS Version) ###
########################################

temp.langTextMenu = COA
temp.langTextMenu{
10 = TEXT
10 {
# Labels
#value = Language:
#lang.de = Sprache:
#lang.fr = Langue:
#wrap = <div id="nav-lang-label">|</div>
}
20 = HMENU
20{
wrap = <div id="nav-lang">|</div>
special = language
# Liste der Sprach IDs (0 = Deutsch, 1 = Englisch, 2 = Franzoesisch)
//special.value = 0,1,2
special.value = 0,1
1 = TMENU
1{
wrap = <ul class="nav">|</ul>
NO = 1
NO {
stdWrap.cObject = TEXT
stdWrap.cObject{
value = english || deutsch
# oder auf diese Weise:
#lang.de = Englisch || Deutsch || Franzoesich
#lang.fr = ...
}
allWrap = <li class = "no first"> | </li>|*|<li class = "no"> |  | </li>|*|<li class = "no last"> |  | </li>
}
ACT < .NO
ACT {
doNotLinkIt = 1
allWrap = <li class = "act first"> | </li>|*|<li class = "act"> |  | </li>|*|<li class = "act last"> |  | </li>
}
# Zustand NO wenn keine Uebersetzung vorliegt
USERDEF1 < .NO
USERDEF1 {
doNotLinkIt = 1
allWrap = <li class = "no empty first"> | </li>|*|<li class = "no empty"> |  | </li>|*|<li class = "no empty last"> |  | </li>
}
# Zustand ACT wenn keine Uebersetzung vorliegt
USERDEF2 < .NO
USERDEF2 {
doNotLinkIt = 1
allWrap = <li class="act empty first"> | </li>|*|<li class="act empty"> |  | </li>|*|<li class="act empty last"> |  | </li>
}
}
}
}

</pre>

=== Sprachmenü grafische Version ===
Möglichkeiten:

1. obiges Menü anpassen

2. siehe unten php Version

3. sr_language_menu Extension

siehe auch [[TYPO3 Sprachmenü mit sr_language_menu]]

== Einführung ==
* HTML-Template: Marker einbinden
* TypoScript: Marker mit Sprachskript füllen (PHP-Objekt)
* Dateien: Notwendige Dateien hochspielen (Skript und Grafiken)
* CSS anpassen damit Flaggen schön aussehen
* Backend: Sprache anlegen (Weltkugel)
* Evt. Spracheinstellungen im TypoScript (das meiste im vorgefertigten Template)
Hinweis: alles im Baukasten (Common - Ordner) ToDo

===2 Konzepte===
Um Mehrsprachigkeit zu realisieren gibt es zwei Ansätze:
# Multitree - Mehrere Navigationsbäume (für jede Sprache einen). In den Navigationsbäumen müssen die Templates entsprechend Variiert werden.
# One Tree Fits All - Mehrsprachigkeit mit den Typo3 Bordmitteln (der moderne Ansatz). Hierbei können im System mehrere Sprachen angelegt werden. Jede Sprache hat nachher in der Seitenansicht eine eigene Spalte. So hat man eine gute Übersicht welche Inhaltselemente bereits übersetzt sind.

===Welcher Ansatz ist der Richtige ?===
Kommt drauf an. Wer soll damit klar kommen? Wieviele Seiten sind es? Werden alle Seiten übersetzt?

===TypoScript Anpassungen===
Damit das System merkt in welcher Sprache es sich z.Zt. befindet wird der URL ein Parameter mitgegeben. Allgemein ist der Parameter L vereinbart. Das sollte auch eingehalten werden weil einige Extensions nur mit L als Variable arbeiten.

Damit das ganze funktioniert müssen Anpassungen mit TypoScript gemacht werden.

Am besten ein Zusätzliches Basis Template anlegen. Für eine deutsch-englische Seite kann das Setup z.B. so aussehen:
<pre>
### Parameter L definieren 0 soll die default Sprache (deutsch) sein ###
config.linkVars = L(0-2)
config.sys_language_uid = 0
config.language = de
config.locale_all = de_DE
#config.sys_language_mode = content_fallback;0 //sucht in default Sprache falls nichts vorhanden
#config.sys_language_mode = content_fallback : 1,0 // sucht in lang1 ansonsten in 0
config.sys_language_mode = strict
config.sys_language_overlay = hideNonTranslated

# Testen ob die Englische Seite gewünscht wird. In einem CASE Konstrukt wird dazu geprüft
# ob die globale Variable L=1 ist
[globalVar = GP:L = 1]
config.sys_language_uid = 1
config.language = en
config.locale_all = en_EN
[global]
</pre>

'''Erläuterung:'''

Im ersten Teil wird die globale Variable L definiert und dann Deutsch als default-Sprache festgelegt und mit L=0 gleichgesetzt. Danach wird getestet ob der Parameter L mit dem Wert 1 übergeben wird. Ist das der Fall wird die Systemsprache auf englisch gesetzt. Das führt später auch dazu, daß die Inhalte aus der Englischen Spalte ausgegeben werden.

Jetzt fehlt noch ein Auswahlmenü mit dem sich die Sprache auf der Webseite auswählen läßt.

===Sprachauswahlmenü programmieren===
In der Subpart definition (workOnSubparts) des Haupttemplates binden wir ein PHP-Skript ein, dass dafür sorgt, daß an der Stelle des Markers (hier LANGUAGE) das Menü eingebunden wird und das bei Klicks auf einen Link immer die richtige Nummer für die Sprache an die URL angehängt wird.

'''TypoScript:'''
#multilanguage-flags
marks.LANGUAGE=TEXT
marks.LANGUAGE= 
marks.LANGUAGE=PHP_SCRIPT
marks.LANGUAGE.file=fileadmin/scripts/languageMenu_d-e.php

'''php-Skript:'''
<?php
/**
* languageMenu_d-e.php basiert auf example_languageMenu.php
*
* @author Kasper Skårhøj <kasper@typo3.com>
* @modified by Stephan Schlegel www.geo-bit.de
*/
// First, select all pages_language_overlay records on the current page. Each represents a possibility for a language.
$query = "SELECT * FROM pages_language_overlay WHERE pid=".$GLOBALS["TSFE"]->id.$GLOBALS["TSFE"]->sys_page->enableFields("pages_language_overlay")." GROUP BY sys_language_uid";
$res = mysql(TYPO3_db,$query);
$langArr=array();
while($row=mysql_fetch_assoc($res)) {
$langArr[$row["sys_language_uid"]]=$row["title"];
}

// Little red arrow, which is inserted to the left of the flag-icon if the
// TSFE->sys_language_uid equals the language uid (notice that 0=deutsch, 1=englisch
// is SPECIFIC to this database, because these numbers refer to uid's of the table sys_language)
$pointer = '<img src="fileadmin/scripts/pointer.gif" width="7" height="10" align=middle>';
// Set each icon. If the language is the current, red arrow is printed to the left.
// If the language is NOT found (represented by a pages_language_overlay record on this page), the icon is dimmed.
$flags = array();
$flags[] = ($GLOBALS["TSFE"]->sys_language_uid==0?$pointer:"").'<a href="index.php?id='.$GLOBALS["TSFE"]->id.'&L=0" target=_top><img src="media/uploads/flag_de.gif" alt="deutsch" width="21" height="13" hspace=5 border="0"></a>';
$flags[] = ($GLOBALS["TSFE"]->sys_language_uid==1?$pointer:"").'<a href="index.php?id='.$GLOBALS["TSFE"]->id.'&L=1" target=_top><img src="media/uploads/flag_uk'.($langArr[1]?"":"_d").'.gif" alt="english" width="21" height="13" hspace=5 border="0"></a>';

// Make the little menu. Notice, the menu does ONLY transfer the page-id and the "L" variable (which is also SPECIFIC for this website because "L" has been used in the extension template used to control the language setup)
$content = '<span class="language_selector">'.implode("",$flags).'</span>';
?>
===Rootline für mehrere Sprachen einrichten===
temp.rootline = HMENU
temp.rootline.special = rootline
temp.rootline.special.range = 0|-1
temp.rootline.wrap = Sie sind hier:
temp.rootline.1 = TMENU
temp.rootline.1 {
target = _top
NO.linkWrap = || /
}
# evt. bestimte Seiten ausblenden...
temp.rootline.excludeUidList =

# Sprache mit der ID 3
[globalVar = GP:L = 3]
temp.rootline.wrap = You are here:
[global]

# Sprache mit der ID 4
[globalVar = GP:L = 4]
temp.rootline.wrap = bla bla:
[global]

# Sprache mit der ID X (X = beliebige zahl)
[globalVar = GP:L = X]
temp.rootline.wrap = hierher haben sie sich verirrt:
[global]

=== Ein Beispiel für ein vollständiges (zweisprachiges) TypoScript ===

<pre>
### Spracheinstellungen ###
config.linkVars = L
config.sys_language_mode = content_fallback;0

[globalVar = GP:L = 0]
config.sys_language_uid = 0
config.language = de
config.locale_all = de_DE

# Link to top
#content.linkToTop >
tt_content.stdWrap.innerWrap2 = |<br><div align="right"><A href="#top"><font color="#AB3C4B" face="Arial, Helvetica, sans-serif" size="1"><B>nach oben</b></font></a></div>

#Suchfunktion
tt_content.search{
20.layout.10.value = Suchergebnis: ###RANGELOW###-###RANGEHIGH### von ###TOTAL###
20.noResultObj.10.value = Keine Treffer.
20.next.value=nächste
20.prev.value=vorherige
30.dataArray.10.label = Suche nach:
30.dataArray.20.label = Suche in:
30.dataArray.20.valueArray.10.label = Überschriften und Schlüsselworten
30.dataArray.20.valueArray.20.label = Seiteninhalten
30.dataArray.40.value = Suche starten
}

[global]

# English language, sys_language.uid = 1
[globalVar = GP:L = 1]
config.sys_language_uid = 1
config.language = en
config.locale_all = english

# Link to top
#content.linkToTop >
tt_content.stdWrap.innerWrap2 = <br><div align="right"><A href="#top"><font color="#AB3C4B" face="Arial, Helvetica, sans-serif" size="1"><B>to top</b></font></a></div>

#Suchfunktion - englisch
tt_content.search{
20.layout.10.value = Suchergebnis: ###RANGELOW###-###RANGEHIGH### von ###TOTAL###
20.noResultObj.10.value = No hits.
20.next.value=next
20.prev.value=previous
30.dataArray.10.label = Searchwords:
30.dataArray.20.label = Search in:
30.dataArray.20.valueArray.10.label = Headlines & Keywords
30.dataArray.20.valueArray.20.label = Content
30.dataArray.40.value = Start search
}
[global]
</pre>
=== Schritt für Schritt Anleitung ===
* Mindestens eine weitere Sprache anlegen (Listenansicht - Weltkugel)
* TypoScript Sprachvariable und Template anpassen:
* Benötigte Skripte und Bilder(Flaggen) Uploaden<br>z.B. mulitlan_d-e.php, flag_uk.gif...
* Marker im TypoScript Template anlegen:z.B.
<pre>
### Multilanguage-Navi ###
marks.LANGUAGE=PHP_SCRIPT
marks.LANGUAGE.file=fileadmin/scripts/languageMenu_e-d.php
</pre>
* Marker im HTML-Template einbauen. Am besten in divs damit man es per CSS gestalten kann
<div id="languageSelector">###LANGUAGE###</div>

=== Probleme bei mehrsprachigen Seiten ===
Lösungen bei verschiedenen Problemen mit mehrsprachigen Seiten gibt es hier:

[[Typo3 - Probleme mit mehrsprachigen Seiten lösen]]

=== Skriptsammlung ===
==== php-Sprachskript ====
<pre>
<?php
/**
* languageMenu_d-e.php basiert auf example_languageMenu.php
*
* @author Kasper Skårhøj <kasper@typo3.com>
* @modified by Stephan Schlegel www.geo-bit.de
*/
// First, select all pages_language_overlay records on the current page.
// Each represents a possibility for a language.
$query = "SELECT * FROM pages_language_overlay WHERE pid=".$GLOBALS["TSFE"]->id.$GLOBALS["TSFE"]->sys_page->enableFields("pages_language_overlay")." GROUP BY sys_language_uid";
$res = mysql(TYPO3_db,$query);
$langArr=array();
while($row=mysql_fetch_assoc($res)) {
$langArr[$row["sys_language_uid"]]=$row["title"];
}

// Little red arrow, which is inserted to the left of the flag-icon if the
// TSFE->sys_language_uid equals the language uid (notice that 0=deutsch, 1=englisch
// is SPECIFIC to this database, because these numbers refer to uid's of the table sys_language)
//$pointer = '<img src="fileadmin/scripts/pointer.gif" width="7" height="10" align=middle>';
$pointer = "";
// Set each icon. If the language is the current, red arrow is printed to the left.
// If the language is NOT found (represented by a pages_language_overlay record on this page), the icon is dimmed.
$flags = array();
$flags[] = '<li><a href="index.php?id='.$GLOBALS["TSFE"]->id.'&L=0" target=_top><span class="flag"><img src="fileadmin/template/images/flag_de.gif" alt="deutsch" title="deutsch" border="0"></span></a></li>';
$flags[] = '<li><a href="index.php?id='.$GLOBALS["TSFE"]->id.'&L=1" target=_top><span class="flag"><img src="fileadmin/template/images/flag_uk'.($langArr[1]?"":"_d").'.gif" alt="english" title="english" border="0"><span></a></li>';

// Make the little menu. Notice, the menu does ONLY transfer the page-id and the "L" variable (which is also SPECIFIC for this website because "L" has been used in the extension template used to control the language setup)
$content = '<ul>'.implode("",$flags).'</ul>';
?>
</pre>

==== TypoScript multilanguage Extension ====
ext_multilang_d-e.tmpl

Setup:
<pre>
### Spracheinstellungen ###
config.linkVars = L
config.sys_language_mode = content_fallback;0

### ohne Sprachauswahl ###

# Standardsprache deutsch wird festgelegt
config.sys_language_uid = 0
config.language = de
config.locale_all = de_DE

# CSS
page.stylesheet = fileadmin/template/css/main.css

### DEUTSCH ###
[globalVar = GP:L = 0]
config.sys_language_uid = 0
config.language = de
config.locale_all = de_DE

# CSS
#page.stylesheet = fileadmin/template/main.css

# Link to top
#content.linkToTop >
tt_content.stdWrap.innerWrap2 = |<br><div class="toTop"><a href="#top">nach oben</a></div>
[global]

### ENGLISCH ###
[globalVar = GP:L = 1]
config.sys_language_uid = 1
config.language = en
config.locale_all = english

# CSS
#page.stylesheet = fileadmin/template/main_en.css

# Link to top
#content.linkToTop >
tt_content.stdWrap.innerWrap2 = <br><div class="toTop"><a href="#top">to top</a></div>

#...

[global]
</pre>

=== Übersetzung nur Anzeigen wenn sie vorhanden ist ===
Typo3 - Stuttgart Mailing List (Juli 2006)

<pre>
> >Hallo ihr alle,
> >
> >ich habe eine typo3 3.7.1 installation und möchte eine übersetzung nur dann anzeigen, wenn diese vorhanden ist.
> >Wenn sie nicht vorhanden ist soll der gesamte menüpunkt rausfliegen.
> >
> >Der untenstehende code sollte funktionieren - tut es aber nicht...
> >Weis da jemand bescheid?
> >...meine langwierige recherchen haben leider auch nichts ergeben ;-((
> >
> >config.linkVars = L
> >config.sys_language_uid = 0
> >config.language = de
> >config.sys_language_mode = strict
> >config.sys_language_overlay = hideNonTranslated
> >
> >lg niko
> >
> >
</pre>

Hallo Niko,

vielleicht hilft dir dies weiter:

http://www.datenwolken.de/index.php?id=221

und ein Beispiel hier

http://forum.typo3.fr/index.php?showtopic=4236

<pre>
// User defined
USERDEF1 = 1
USERDEF1.doNotLinkIt = 1
USERDEF1.linkWrap = <li class="disabled">|</li>
USERDEF1.stdWrap.override = EN || FR || DE
}
</pre>

li.disabled dann im stylesheet ausblenden ...

Grüße
Ines

_______________________________________________
TYPO3-stuttgart mailing list
TYPO3-stuttgart@lists.netfielders.de
http://lists.netfielders.de/cgi-bin/mailman/listinfo/typo3-stuttgart

== Datum und Zeit ==
Oft ist es schwierig herauszufinden wo gerade die Ausgabe von Zeit und Datum konfiguriert wird.

Wenn eine der Extensions ts_language_de oder ts_language_xx installiert ist wird dort der Standard einer andeen Extension (z.B. tt_news) überschrieben. Diese Einstellung kann wieder im eigenen TS überschrieben werden.

Im Template Analyser kann man die Reihenfolge gut sehen.

Beispiel zur Konfiguration:

'''Examples:'''
Your site is a "one-language-site" and you configured the site-language as default language of TYPO3. If you have a ts_language_xx extension installed, to set some country specific settings for other extensions, I suggest to copy the part which refers to tt_news in your main template or an ext template which is included. Here an example for german settings:

<pre>
# set the TYPO3 language to german
config.language = de
# set the PHP locale to german
config.locale_all = de_DE

# tt_news date & time formats
plugin.tt_news {
archiveTitleCObject {
10.strftime = %B - %Y
}
getRelatedCObject {
20.strftime = %d.%m.%Y %H:%M
}
displaySingle {
date_stdWrap.strftime= %d.%m.%y
time_stdWrap.strftime= %H:%M
}
displayLatest {
date_stdWrap.strftime= %d.%m.%y
time_stdWrap.strftime= %H:%M
}
displayList {
date_stdWrap.strftime= %A %d. %B %Y
time_stdWrap.strftime= %d.%m.%y %H:%M
}
}
</pre>

Hint: If the locale_all setting "de_DE" don't work on your WAMP installation, try to set it to "german". There are some differences in the handling of the php-locale on windows and linux.

If your site is a multilanguage site like the "one-tree-fits-all-languages" example from the "testsite" package (see: http://typo3.org/documentation/tips-tricks/multi-language-sites-in-typo3/ ) you can add the country specific settings to the language condition in your TS-setup:

<pre>
# Setting up the language variable "L" to be passed along with links
config.linkVars = L

# German language, sys_language.uid = 2
[globalVar = GP:L = 2]
config.sys_language_uid = 2
config.language = de
config.locale_all = de_DE

# set german date & time formats
plugin.tt_news {
archiveTitleCObject {
10.strftime = %B - %Y
}
getRelatedCObject {
20.strftime = %d.%m.%Y %H:%M
}
displaySingle {
date_stdWrap.strftime= %d.%m.%y
time_stdWrap.strftime= %H:%M
age_stdWrap.age = Minuten | Stunden | Tage | Jahre
}
displayLatest {
date_stdWrap.strftime= %d.%m.%y
time_stdWrap.strftime= %H:%M
}
displayList {
date_stdWrap.strftime= %A %d. %B %Y
time_stdWrap.strftime= %d.%m.%y %H:%M
}
}
[global]

# Danish language, sys_language.uid = 1
[globalVar = GP:L = 1]
config.sys_language_uid = 1
config.language = dk
config.locale_all = danish

# set danish date & time formats
plugin.tt_news {
# sorry, don't know the danish date & time settings ;-)
}
[global]
</pre>

== Felder im Backend für mehrere Sprachen benutzen ==

michael schuhmacher wrote:
> Hallo,
> weiss jemand wie ich es anstelle, dass bei einer eigenen extension, im backend bestimmte felder grundsaetzlich fuer alle sprachen stehen sollen? so dass man nicht zb. die selben bilder in den uebersetzungen nochmal angeben muss.

habs schon

in meinem fall in ext_tables.php (oder auch in tca.php)

"l10n_mode" => 'exclude',

== Sprachlabel für die Frontendausgabe anpassen ==
Stichwort Language Label, Sprachlabel, Mehrsprachigkeit
Bei Mehrsprachigen Extensions werden die Ausgaben für die verschiedenen Sprachen in der Regel in der Datei locallang.xml notiert. Oftmals möchte man diese Ausgaben anpassen, ohne diese Datei zu verändern. Denn nach einem Update würden die Änderungen wieder Rückgängig gemacht. Die Labels für die Sprache lassen sich aber auch über eigene Extensions oder über TypoScript anpassen.

Mit TypoScript funktioniert das etwa so:

plugin.tt_news._LOCAL_LANG.de.more = mehr >>
also nach dem Schema:
plugin.meinPlugin._LOCAL_LANG.sprachkürzel.labelnahme = meinLabel

== Sprachlabel im Backend anpassen ==
Quelle: http://typo3-freelancer-berlin.de/typo3-blog/artikel/typo3-backendformulare-label-aendern-per-typoscript.html (Zugriff: 09/2011)

Oftmals möchten Kunden die Bezeichnung einzelner Felder im backend anders benannt haben.

pageTSconfig

// Label in eigener locallang_db.php überschreiben
TCEFORM.table.column.label = LLL:typo3conf/override_locallang_db.php:table.column

// Label direkt in pageTSconfig überschreiben

TCEFORM.table.column.label = My Title
TCEFORM.table.column.label.de = Mein Titel

== Weiterleitung in Abhängigkeit der Browsersprache ==
Damit der Benutzer gleich auf der richtigen Sprache landet kann man die Extension
rlmp_language_detection benutzen.

Als Erweiterung gibt es noch die Extension Title Language Detection - Extended( sr_language_detect ) von Stanislas Rolland
=== Konfiguration für One-Tree Konzept ===
<pre>
plugin.tx_rlmplanguagedetection_pi1 {
defaultLang = de #ISO-Code der Standardsprache anpasssen
}
</pre>

=== Konfiguration für Multi-Tree Konzept ===
<pre>

plugin.tx_rlmplanguagedetection_pi1 {
useOneTreeMethod = 0
multipleTreesRootPages
{
#PID's der jeweiligen Sprachen anpassen, ggf. neue zufuegen
de = 216
en = 120
es = 482
}
}
=== Problem mit Browserseitigem Cache bei Einsatz von rlmplanguagedetection ===
Um die richtigen Werte für das Caching auszugeben muß in der Konfiguration stehen:

Typoscript: Zeilennummerierung: An / Aus

1.
config.sendCacheHeaders = 1

Diese Funktion bleibt aber unter anderem auf den Seiten wirkungslos, in denen USER_INT Objekte genutzt werden.

Mit der Extention 'rlmplanguagedetection' steckt dieses Object in jedem Seiten-Rendering. Das USER_INT Object braucht es aber für die Funktion der Extension.

Da die Extension keine neuen Header mit 'Location' und dem GetParameter ausgibt, wenn dieser Parameter bereits in der URL vorhanden ist, braucht es diese USER_INT funktion folglich auch nicht bei jedem Seitenaufruf. Um sie denn in diesem Falle aus den Seiten-Rendering auch auszuschließen habe ich mich für folgendes Konzept entschieden, in dem via TypoScript die Extension einfach ausgeschlossen wird, wenn der GetParameter bereits existiert:

Typoscript: Zeilennummerierung: An / Aus

1.
# send Cache Headers
2.
config.sendCacheHeaders = 1
3.
# disable USER_INT 'rlmplanguagedetection' when GP:L exists
4.
[globalVar=GP:L=0,GP:L>0]
5.
plugin.tx_rlmplanguagedetection_pi1 >
6.
[global]

Das funktioniert, und damit lässt sich die Extension auch wieder für Proxy- oder Clientseitiges Cachen nutzen.[/TS]
3. Testen (Browsersprache ändern. Anleitung unten.)
4. Falls es Probleme gibt und die Spracherkennung / -weiterleitung nicht funktioniert, kann folgendes im Setup des Root Templates hinzufügt werden. Hier wird die Erweiterung im Page-Element an Position 1000 inkludiert. Diese Einstellung muss ggf. angepasst werden.

page.1000 < plugin.tx_rlmplanguagedetection_pi1

Tipps zum Testen

Wie stellt man die Sprache des Browsers um? Das Umstellen der Browsersprache:

Firefox

* Extras > Einstellungen > Reiter Erweitert > Reiter Allgemein (Windowsversion) oder
Bearbeiten > Einstellungen > Reiter Erweitert > Reiter Allgemein (Linuxversion)
* im Unteren Bereich befindet sich der Abschnitt Sprache, in dem man über den Button "wählen" ein oder mehrere neue Sprachen hinzufügen kann. Die Sprache in der getestet wird steht immer oben.

Internet Explorer IE

* Extras > Internetoptionen
* im Unteren Bereich befindet sich der Button Sprache, mit dem man ein oder mehrere neue Sprachen hinzufügen kann. Die Sprache in der getestet wird steht immer oben.

Wenn es nicht funktioniert

Wenn es nicht funktioniert hat man eventuell die Sprachen nicht richtig eingerichtet. Hier sollte man noch mal die Konfiguration überprüfen.
Anleitung von rainer-grundel Datum des Zugriffs 1.4.2008, http://www.rainer-grundel.de/wissensdb/typo3/empfohlene_extensions/artikel/article/anzeige_der_website_nach_browsersprache.html</pre>

== Mehrsprachigkeit und TemplaVoila ==
Wenn man eine mehrsprachige Seite mit TemplaVoila nutzt. Kann man das Verhalten in der Datenstruktur der TemplaVoila Templates steuern.

TemplaVoila nutzt zur Darstellung seiner Inhalte Flexforms. Die dazugehörigen Parameter für die Darstellung der Mehrsprachigen Datensätze im Backend steuert man daher mit der Flexform T3DataStructure. Konkret sind hier folgende XML-Tags von Bedeutung:
<pre>
<meta type="array">
<langDisable type="integer">[0|1]</langDisable>
<langChildren type="integer">[0|1]</langChildren>
</meta>
</pre>
Wie gezeigt können diese also entweder den Wert 0 oder 1 enthalten
===langDisable===
'''0''' Sprachsteuerung durch das Flexform, technisch gesehen bedeutet das, daß die Übersetzungen im Flexform-Datensatz gespeichert werden. Siehe auch langChildren

'''1''' Die Sprachsteuerung durch das Flexform ist abgeschaltet. D.h. Typo3 übernimmt das selbst. Dies ist die geeignete Einstellung für Flexible Content Elemente die zur Gliederung (z.B. 2Spalter) genutzt werden.

===langChildren===
Hat nur Auswirkung wenn langDisable auf 0 steht.

'''1''' Die Inhalte der Flexforms lassen sich Direkt übersetzen (Flagge klicken) und werden zusammengezoge im Backend dargestellt.
Im Frontend wird die Standardsprache verwendet wenn keine Übersetzung vorhanden ist.

'''0''' Keine Direkte übersetzung. Das komplette Flexform wird übersetzt.

== Seiten ohne Übersetzung im Menü verstecken ==
Quelle:http://blog.undkonsorten.com/typo3-seite-uebersetzung-menue-verstecken

Datum des Zugriffs: 29.4.2009

16. Januar 2008

Für mehrsprachige TYPO3-Webseiten im One-Tree-Konzept werden standardgemäß die immer alle Menüeintäge in der Standardsprache ausgegeben, insofern für diese keine Übersetzung angelegt wurde. In der Regel ist eine Navigation in zwei verschiedenen Sprachen nicht erwünscht und man möchte Seiten ohne Übersetzungen verstecken. Es gibt zwei Wege, dies umzusetzen.

'''Lösung über das TYPO3-Backend'''

Am einfachsten lässen sich Seiten ohne Übersetzungen ausblenden, indem man unter Seiteneigenschaften > Spracheinstellungen das Verstecke Seiten wenn keine Übersetzung… mit einem kleinen Häckchen versieht.

TYPO3: Sprache verstecken, wenn keine Übersetzung existiert

Wenn für diese Seite - angenommen sie sei deutsche - keine Übersetzung angelegt wurde, man sich aber z.B. gerade im Frontend im englischen Bereich befindet, so wird diese Seite nicht angezeigt.

'''Lösung per Installtool bzw. localconf.php'''

Im Install-Tool > All Configuration gibt es den Eintrag [hidePagesIfNotTranslatedByDefault] . Wenn man hier den Wert TRUE einträgt werden alle Seiten ohne Übersetzung per default versteckt. Dies entspricht folgendem Eintrag in der localconf:

$TYPO3_CONF_VARS['FE']['hidePagesIfNotTranslatedByDefault'] = ‘TRUE’;

'''Standard-Übersetzung im Menü einblenden per TypoScript'''

Man kann per TypoScript-Setup umgekehrt für die Menükonfiguration angeben, dass Seiten generell in der default-Sprache ausgegeben werden, insofern keine Übersetzung vorliegt. Das sieht dann so aus:

temp.navigation = HMENU
temp.navigation {
…
protectLvar = all
…
}

protectLvar kennt die Werte 1 und all. Mit all wird der Wert des Kontrollkästchens überschrieben und Seiten ohne Übersetzungen werden immer ausgegegen.

Monopoly

2012-03-07T14:32:47Z

178.7.132.100: /* Geldverteilung deutsches Monopoly (DM) */

== Geldverteilung deutsches Monopoly (DM) ==

Startkapital 30.000 - in verschiedenen Versionen gibt es verschiedene Verteilungen. Die Variante ist die aus unserem Spiel

'''Variante 1'''
<pre>
1 x 10 000
6 x 2 000
4 x 1 000
3 x 400
10 x 200
7 x 100
5 x 20
</pre>
---------------------
'''Variante 2'''
<pre>
2x 10.000
4x 2000
1x 1000
1x 400
2x 200
1x 100
5x 20
</pre>
----------------------
'''Variante 3 (mit 50ern)'''
<pre>
2 x 10.000
3 x 2.000
2 x 1.000
2 x 500
6 x 100
6 x 50
5 x 20
</pre>

Monopoly

2012-03-07T14:31:46Z

178.7.132.100: Die Seite wurde neu angelegt: „ == Geldverteilung deutsches Monopoly (DM) == Startkapital 30.000 - in verschiedenen Versionen gibt es verschiedene Verteilungen. Die Variante ist die aus unser…“

== Geldverteilung deutsches Monopoly (DM) ==

Startkapital 30.000 - in verschiedenen Versionen gibt es verschiedene Verteilungen. Die Variante ist die aus unserem Spiel

'''Variante 1'''

1 x 10 000
6 x 2 000
4 x 1 000
3 x 400
10 x 200
7 x 100
5 x 20

---------------------

2x 10.000
4x 2000
1x 1000
1x 400
2x 200
1x 100
5x 20

----------------------

2 x 10.000
3 x 2.000
2 x 1.000
2 x 500
6 x 100
6 x 50
5 x 20

Gesundheitsregion-rtz

2012-03-06T14:53:50Z

178.7.132.100: /* Benutzer anlegen */

Dies ist eine alte Version die neue Seite liegt unter

[[Gesundheitsregion_Reutlingen_Tübingen_Zollernalb]]

== Benutzer anlegen ==
Im Backend:
# Unter Gesundheitskalender > Assets den '''Veranstalter anlegen''' (List Ansicht). Am besten gleich die ID des neuen Veranstalters merken.
# '''Ordner für die Datensätze''' anlegen, in den Eigenschaften muß unter "Allgemeine Datensatzsammlung" der '''Ordner Assets''' ausgewählt werden, sonst können keine Veranstalter ausgewählt werden.
# Neue '''Benutzergruppe Bereich: [meinBereich]''' anlegen wobei [meinBereich] ein frei wählbarer Name ist. In dieser den '''DB-Mount''' für den neu erstellten Ordner angeben und im '''UserTS''' die Voreinstellung für den Veranstalter festlegen (ID des im 1. Schritt angelegten Veranstalters: TCAdefaults.tx_gbseminars_seminars.organizerid = [id des Veranstalters]
# Neuen '''Backend Benutzer''' anlegen und die Gruppen "Rolle: Kalender Redakteur" und die neu angelegte Gruppe Bereich: [meinBereich]
# '''Zugriffsrechte''' im Modul Zugriff so Einstellen das der neue Benutzer dort Datensätze anlegen kann (Gruppe und Besitzer auf entsprechenden Bereich bzw. User und Rechte für Seite anzeigen und Inhalte bearbeiten)