12.2. Zend_Mime_Message

12.2.1. Einführung

Zend_Mime_Message repräsentiert eine Mime konforme Nachricht, welche einen oder mehrere Abschnitte (Repräsentiert durch Zend_Mime_Part Objekte) beinhalten kann. Mit MimeMessage können Mime konforme Nachrichten, durch die Klasse, erstellt werden. Verschlüsselungs- und BoundaryGrenzbehandlung werden transparent durch die Klasse behandelt. MimeMessage Objekte können auch durch übergebene Strings rekonstruiert werden (Experimentell). Verwendet durch Zend_Mail.

12.2.2. Instanziierung

Es gibt keinen expliziten Konstruktor für Zend_Mime_Message.

12.2.3. MIME Abschnitte hinzufügen

Zend_Mime_Part Objekte können zu einem bestehenden Zend_Mime_Message Objekt hinzugefügt werden durch aufruf von ->addPart($part)

Ein Array mit allen Zend_Mime_Part Objekten der Zend_Mime_Message wird von der Methode ->getParts() zurück gegeben. Das Zend_Mime_Part Objekt kann dann geändert werden, da es im Array als Referenz gespeichert wird. Wenn Abschnitte zum Array hinzugefügt werden oder die Sequenz geändert wird, muß das Array dem Zend_Mime_Message Objekt zurückgegeben werden, durch Aufruf von ->setParts($partsArray)

Die Funktion ->isMultiPart() gibt true zurück, wenn mehr als ein Abschnitt im Zend_Mime_Message Objekt registriert wurde, und das Objekt deshalb bei der Erstellung des aktuellen Outputs eine Multipart-Mime-Message erstellen würde.

12.2.4. Grenzbehandlung

Zend_Mime_Message erzeugt und verwendet normalerweise sein eigenes Zend_Mime Objekt zur Erstellung einer Grenze. Wenn eine eigene granze erstellt werden, oder das das Verhalten des Zend_Mime Objekts geändert werden muß, welches von Zend_Mime_Message verwendet wird, kann ein eigenes Zend Mime Objekt instanziiert und bei Zend_Mime_Message registriert werden. Normalerweise muß das nicht gemacht werden. ->setMime(Zend_Mime $mime) setzt eine spezielle Instanz von Zend_Mime welche durch diese Zend_Mime_Message verwendet wird.

->getMime() gibt eine Instanz von Zend_Mime zurück, welche zur Wiedergabe der Nachricht verwendet wird, wenn generateMessage() aufgerufen wird.

->generateMessage() gibt den Zend_Mime_Message Inhalt in einem String wieder.

12.2.5. Parst einen String um ein Zend_Mime_Message Objekt zu erstellen (Experimentell)

Eine übergebene MIME konforme Nachricht in einem String kann dazu verwendet werden, um daraus ein Zend_Mime_Message Objekt wieder herzustellen. Zend_Mime_Message hat eine statische Factory Methode um den String zu parsen und gibt ein Zend_Mime_Message Objekt zurück.

Zend_Mime_Message::createFromMessage($str, $boundary) entschlüsselt einen übergebenen String und gibt ein Zend_Mime_Message Objekt zurück welches anschließend durch ->getParts() überprüft werden kann