## Mail MIME

Provides a class for creating MIME messages.

- NOTE: This module does not send mail.
    If you came here looking for a mail-sending module, try HTML Mail (which can use this module for MIME-handling) or Mime Mail (which comes with its own MIME-handling library).

Mail Mime extends certain PEAR mail-handling classes to provide a drupal-friendly library for creating and parsing MIME messages. Neither Mail Mime nor the original PEAR classes send mail nor do anything useful on their own. They are intended as code libraries to be used by other programs that send or receive mail.

Mail Mime started out as part of HTML Mail. I separated into its own module for two reasons:

1. The separation helped clarify in my own mind which parts of the mail-sending process require MIME and which do not. The resulting code is simpler and easier to maintain.

2. It is possible that another mail-sending or mail-reading module may find the Mail Mime library useful.

### Requirements

The following files, available from PEAR, must be installed and available somewhere on the `include_path`.

- `Mail/mime.php`
- `Mail/mimeDecode.php`
- `Mail/mimePart.php`
- `PEAR.php`

- `PEAR5.php`

- One way to satisfy the requirements is to run the following command from a Unix root shell prompt:

  `pear install -a Mail_Mime`

  The `-a` parameter ensures that dependencies, including `Mail/mimeDecode.php` and `Mail/mimePart.php`, are also installed.

- Another way is to install and enable the Include module before enabling the Mail MIME module.

### Installation

1. Download and install as usual.

2. When enabled, Mail Mime will

   - Auto-detect whether the required files are present.

   - If any files are missing, and the Include module is available, Mail Mime will use Include to auto-download and enable the missing files.

   - If all of the above fails, Mail Mime will disable itself and print a warning to both the screen and the error log.