Chapter 13. Zend_Mime

Table of Contents

13.1. Zend_Mime
13.1.1. Introduction
13.1.2. Static Methods and Constants
13.1.3. Instantiating Zend_Mime
13.2. Zend_Mime_Message
13.2.1. Introduction
13.2.2. Instantiation
13.2.3. Adding MIME Parts
13.2.4. Boundary handling
13.2.5. parsing a string to create a Zend_Mime_Message object (experimental)
13.3. Zend_Mime_Part
13.3.1. Introduction
13.3.2. Instantiation
13.3.3. Methods for rendering the message part to a string

13.1. Zend_Mime

13.1.1. Introduction

Zend_Mime is a support class for handling multipart MIME messages. It is used by Zend_Mail and Zend_Mime_Message and may be used by applications requiring MIME support.

13.1.2. Static Methods and Constants

Zend_Mime provides a simple set of static helper methods to work with MIME:

  • Zend_Mime::isPrintable(): Returns TRUE if the given string contains no unprintable characters, FALSE otherwise.
  • Zend_Mime::encodeBase64(): Encodes a string into base64 encoding.
  • Zend_Mime::encodeQuotedPrintable(): Encodes a string with the quoted-printable mechanism.

Zend_Mime defines a set of constants commonly used with MIME Messages:

  • Zend_Mime::TYPE_OCTETSTREAM: 'application/octet-stream'
  • Zend_Mime::TYPE_TEXT: 'text/plain'
  • Zend_Mime::TYPE_HTML: 'text/html'
  • Zend_Mime::ENCODING_7BIT: '7bit'
  • Zend_Mime::ENCODING_8BIT: '8bit'
  • Zend_Mime::ENCODING_QUOTEDPRINTABLE: 'quoted-printable'
  • Zend_Mime::ENCODING_BASE64: 'base64'
  • Zend_Mime::DISPOSITION_ATTACHMENT: 'attachment'
  • Zend_Mime::DISPOSITION_INLINE: 'inline'

13.1.3. Instantiating Zend_Mime

When Instantiating a Zend_Mime Object, a MIME boundary is stored that is used for all subsequent non-static method calls on that object. If the constructor is called with a string parameter, this value is used as a MIME boundary. If not, a random MIME boundary is generated during construction time.

A Zend_Mime object has the following Methods:

  • boundary(): Returns the MIME boundary string.
  • boundaryLine(): Returns the complete MIME boundary line.
  • mimeEnd(): Returns the complete MIME end boundary line.