Zend_Mime_Message
représente un message compatible MIME
qui peut contenir une ou plusieurs parties séparées (représentées par
des objets Zend_Mime_Part
)
Avec Zend_Mime_Message
, les messages multiparts compatibles MIME
peuvent être générés à partir de Zend_Mime_Part
. L'encodage et
la gestion des frontières sont gérées de manière transparente par la classe.
Les objets Zend_Mime_Message
peuvent aussi être reconstruits à
partir de chaînes de caractères données (expérimental).
Utilisés par Zend_Mail
.
Les objets Zend_Mime_Part
peuvent êtres ajoutés à un objet Zend_Mime_Message
donné en appelant
->addPart($part)
.
Un tableau avec toutes les objets Zend_Mime_Part
du Zend_Mime_Message
est retourné dans un tableau
grâce à ->getParts()
. Les objets Zend_Mime_Part peuvent ainsi être changés
car ils sont stockés dans le tableau comme références. Si des parties sont ajoutées
au tableau, ou que la séquence est changée, le tableau à besoin d'être retourné à l'objet
Zend_Mime_Part
en appelant
->setParts($partsArray)
.
La fonction ->isMultiPart()
retournera true si plus d'une partie
est enregistrée avec l'objet Zend_Mime_Message, l'objet pourra ainsi regénérer un
objet Multipart-Mime-Message lors de la génération de la sortie.
Zend_Mime_Message
crée et utilise généralement son propre objet
Zend_Mime
pour générer une frontière. Si vous avez besoin de définir
une frontière ou si vous voulez changer le comportement de l'objet Zend_Mime
utilisé par
Zend_Mime_Message
, vous pouvez instantier l'objet Zend_Mime
vous-même
et l'enregistrer ensuite dans Zend_Mime_Message
.
Généralement, vous n'aurez pas besoin de faire cela.
->setMime(Zend_Mime $mime)
définit une instance spéciale de Zend_Mime
pour qu'elle soit utilisée par ce Message.
->getMime()
retourne l'instance de Zend_Mime
qui sera utilisée pour générer le message lorsque generateMessage()
est appelée.
->generateMessage()
génère le contenu ZZend_Mime_Message
en une chaîne de caractères.
Un message compatible MIME donné sous forme de chaîne de caractère peut
être utilisé pour reconstruire un objet Zend_Mime_Message
.
Zend_Mime_Message
a une factory Method statique pour parser
cette chaîne et retourner un objet Zend_Mime_Message
.
Zend_Mime_Message::createFromMessage($str, $boundary)
décode la chaîne
de caractères donnée et retourne un objet Zend_Mime_Message
qui peut
ensuite être examiné en utilisant ->getParts()
.