From ab6f8077e9b719db230798e658ba37f1f386b26b Mon Sep 17 00:00:00 2001 From: thomascube Date: Wed, 21 Mar 2007 09:54:10 +0000 Subject: Updated PEAR::Mail_mime package --- program/lib/Mail/mime.php | 426 +++++++++++++++++++++++++--------------- program/lib/Mail/mimeDecode.php | 186 ++++++++++-------- program/lib/Mail/mimePart.php | 180 ++++++++--------- 3 files changed, 449 insertions(+), 343 deletions(-) (limited to 'program/lib/Mail') diff --git a/program/lib/Mail/mime.php b/program/lib/Mail/mime.php index e7129db23..62cf18270 100644 --- a/program/lib/Mail/mime.php +++ b/program/lib/Mail/mime.php @@ -1,112 +1,176 @@ | -// | Tomas V.V.Cox (port to PEAR) | -// +-----------------------------------------------------------------------+ -// -// $Id$ +/** + * The Mail_Mime class is used to create MIME E-mail messages + * + * The Mail_Mime class provides an OO interface to create MIME + * enabled email messages. This way you can create emails that + * contain plain-text bodies, HTML bodies, attachments, inline + * images and specific headers. + * + * Compatible with PHP versions 4 and 5 + * + * LICENSE: This LICENSE is in the BSD license style. + * Copyright (c) 2002-2003, Richard Heyes + * Copyright (c) 2003-2006, PEAR + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or + * without modification, are permitted provided that the following + * conditions are met: + * + * - Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * - Redistributions in binary form must reproduce the above copyright + * notice, this list of conditions and the following disclaimer in the + * documentation and/or other materials provided with the distribution. + * - Neither the name of the authors, nor the names of its contributors + * may be used to endorse or promote products derived from this + * software without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" + * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE + * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE + * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE + * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR + * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF + * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS + * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN + * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) + * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF + * THE POSSIBILITY OF SUCH DAMAGE. + * + * @category Mail + * @package Mail_Mime + * @author Richard Heyes + * @author Tomas V.V. Cox + * @author Cipriano Groenendal + * @author Sean Coates + * @copyright 2003-2006 PEAR + * @license http://www.opensource.org/licenses/bsd-license.php BSD License + * @version CVS: $Id$ + * @link http://pear.php.net/package/Mail_mime + * @notes This class is based on HTML Mime Mail class from + * Richard Heyes which was based also + * in the mime_mail.class by Tobias Ratschiller + * and Sascha Schumann + */ + +/** + * require PEAR + * + * This package depends on PEAR to raise errors. + */ require_once('PEAR.php'); -require_once('Mail/mimePart.php'); /** - * Mime mail composer class. Can handle: text and html bodies, embedded html - * images and attachments. - * Documentation and examples of this class are avaible here: - * http://pear.php.net/manual/ + * require Mail_mimePart * - * @notes This class is based on HTML Mime Mail class from - * Richard Heyes which was based also - * in the mime_mail.class by Tobias Ratschiller and - * Sascha Schumann + * Mail_mimePart contains the code required to + * create all the different parts a mail can + * consist of. + */ +require_once('Mail/mimePart.php'); + + +/** + * The Mail_Mime class provides an OO interface to create MIME + * enabled email messages. This way you can create emails that + * contain plain-text bodies, HTML bodies, attachments, inline + * images and specific headers. * - * @author Richard Heyes - * @author Tomas V.V.Cox - * @package Mail - * @access public + * @category Mail + * @package Mail_Mime + * @author Richard Heyes + * @author Tomas V.V. Cox + * @author Cipriano Groenendal + * @author Sean Coates + * @copyright 2003-2006 PEAR + * @license http://www.opensource.org/licenses/bsd-license.php BSD License + * @version Release: @package_version@ + * @link http://pear.php.net/package/Mail_mime */ class Mail_mime { /** * Contains the plain text part of the email + * * @var string + * @access private */ var $_txtbody; + /** * Contains the html part of the email + * * @var string + * @access private */ var $_htmlbody; + /** * contains the mime encoded text + * * @var string + * @access private */ var $_mime; + /** * contains the multipart content + * * @var string + * @access private */ var $_multipart; + /** * list of the attached images + * * @var array + * @access private */ var $_html_images = array(); + /** * list of the attachements + * * @var array + * @access private */ var $_parts = array(); + /** * Build parameters + * * @var array + * @access private */ var $_build_params = array(); + /** * Headers for the mail + * * @var array + * @access private */ var $_headers = array(); + /** * End Of Line sequence (for serialize) + * * @var string + * @access private */ var $_eol; /** - * Constructor function + * Constructor function. + * + * @param string $crlf what type of linebreak to use. + * Defaults to "\r\n" + * @return void * * @access public */ @@ -125,7 +189,7 @@ class Mail_mime } /** - * Wakeup (unserialize) - re-sets EOL constant + * wakeup function called by unserialize. It re-sets the EOL constant * * @access private */ @@ -134,6 +198,7 @@ class Mail_mime $this->_setEOL($this->_eol); } + /** * Accessor function to set the body text. Body text is used if * it's not an html mail being sent or else is used to fill the @@ -141,12 +206,12 @@ class Mail_mime * html should show. * * @param string $data Either a string or - * the file name with the contents + * the file name with the contents * @param bool $isfile If true the first param should be treated - * as a file name, else as a string (default) + * as a file name, else as a string (default) * @param bool $append If true the text or file is appended to - * the existing body, else the old body is - * overwritten + * the existing body, else the old body is + * overwritten * @return mixed true on success or PEAR_Error object * @access public */ @@ -173,13 +238,13 @@ class Mail_mime } /** - * Adds a html part to the mail + * Adds a html part to the mail. * - * @param string $data Either a string or the file name with the - * contents - * @param bool $isfile If true the first param should be treated - * as a file name, else as a string (default) - * @return mixed true on success or PEAR_Error object + * @param string $data either a string or the file name with the + * contents + * @param bool $isfile a flag that determines whether $data is a + * filename, or a string(false, default) + * @return bool true on success * @access public */ function setHTMLBody($data, $isfile = false) @@ -197,36 +262,24 @@ class Mail_mime return true; } - /** - * returns the HTML body portion of the message - * @return string HTML body of the message - * @access public - */ - function getHTMLBody() - { - return $this->_htmlbody; - } - /** * Adds an image to the list of embedded images. * - * @param string $file The image file name OR image data itself - * @param string $c_type The content type - * @param string $name The filename of the image. - * Only use if $file is the image data - * @param bool $isfilename Whether $file is a filename or not - * Defaults to true - * @param string $contentid Desired Content-ID of MIME part - * Defaults to generated unique ID - * @return mixed true on success or PEAR_Error object + * @param string $file the image file name OR image data itself + * @param string $c_type the content type + * @param string $name the filename of the image. + * Only use if $file is the image data. + * @param bool $isfile whether $file is a filename or not. + * Defaults to true + * @return bool true on success * @access public */ function addHTMLImage($file, $c_type='application/octet-stream', - $name = '', $isfilename = true, $contentid = '') + $name = '', $isfile = true) { - $filedata = ($isfilename === true) ? $this->_file2str($file) + $filedata = ($isfile === true) ? $this->_file2str($file) : $file; - if ($isfilename === true) { + if ($isfile === true) { $filename = ($name == '' ? $file : $name); } else { $filename = $name; @@ -234,14 +287,11 @@ class Mail_mime if (PEAR::isError($filedata)) { return $filedata; } - if ($contentid == '') { - $contentid = md5(uniqid(time())); - } $this->_html_images[] = array( 'body' => $filedata, 'name' => $filename, 'c_type' => $c_type, - 'cid' => $contentid + 'cid' => md5(uniqid(time())) ); return true; } @@ -254,7 +304,7 @@ class Mail_mime * @param string $c_type The content type * @param string $name The filename of the attachment * Only use if $file is the contents - * @param bool $isFilename Whether $file is a filename or not + * @param bool $isfile Whether $file is a filename or not * Defaults to true * @param string $encoding The type of encoding to use. * Defaults to base64. @@ -269,13 +319,13 @@ class Mail_mime * @access public */ function addAttachment($file, $c_type = 'application/octet-stream', - $name = '', $isfilename = true, + $name = '', $isfile = true, $encoding = 'base64', $disposition = 'attachment', $charset = '') { - $filedata = ($isfilename === true) ? $this->_file2str($file) + $filedata = ($isfile === true) ? $this->_file2str($file) : $file; - if ($isfilename === true) { + if ($isfile === true) { // Force the name the user supplied, otherwise use $file $filename = (!empty($name)) ? $name : $file; } else { @@ -477,7 +527,7 @@ class Mail_mime $params['encoding'] = $value['encoding']; if ($value['disposition'] != "inline") { $fname = array("fname" => $value['name']); - $fname_enc = $this->_encodeHeaders($fname); + $fname_enc = $this->_encodeHeaders($fname, array('head_charset' => $value['charset'] ? $value['charset'] : 'iso-8859-1')); $params['dfilename'] = $fname_enc['fname']; } if ($value['charset']) { @@ -796,90 +846,146 @@ class Mail_mime /** * Encodes a header as per RFC2047 * - * @param array $input The header data to encode + * @param array $input The header data to encode + * @param array $params Extra build parameters * @return array Encoded data * @access private */ - function _encodeHeaders($input) + function _encodeHeaders($input, $params = array()) { - $maxlen = 73; + + $build_params = $this->_build_params; + while (list($key, $value) = each($params)) { + $build_params[$key] = $value; + } + foreach ($input as $hdr_name => $hdr_value) { - // if header contains e-mail addresses - if (preg_match('/\s<.+@[a-z0-9\-\.]+\.[a-z]+>/U', $hdr_value)) - $chunks = $this->_explode_quoted_string(',', $hdr_value); - else - $chunks = array($hdr_value); - - $hdr_value = ''; - $line_len = 0; - - foreach ($chunks as $i => $value) { - $value = trim($value); - - //This header contains non ASCII chars and should be encoded. - if (preg_match('#[\x80-\xFF]{1}#', $value)) { - $suffix = ''; - // Don't encode e-mail address - if (preg_match('/(.+)\s(<.+@[a-z0-9\-\.]+>)$/Ui', $value, $matches)) { - $value = $matches[1]; - $suffix = ' '.$matches[2]; + $hdr_vals = preg_split("|(\s)|", $hdr_value, -1, PREG_SPLIT_DELIM_CAPTURE); + $hdr_value_out=""; + $previous = ""; + foreach ($hdr_vals as $hdr_val){ + if (!trim($hdr_val)){ + //whitespace needs to be handled with another string, or it + //won't show between encoded strings. Prepend this to the next item. + $previous .= $hdr_val; + continue; + }else{ + $hdr_val = $previous . $hdr_val; + $previous = ""; + } + if (function_exists('iconv_mime_encode') && preg_match('#[\x80-\xFF]{1}#', $hdr_val)){ + $imePref = array(); + if ($build_params['head_encoding'] == 'base64'){ + $imePrefs['scheme'] = 'B'; + }else{ + $imePrefs['scheme'] = 'Q'; } - - switch ($this->_build_params['head_encoding']) { + $imePrefs['input-charset'] = $build_params['head_charset']; + $imePrefs['output-charset'] = $build_params['head_charset']; + $hdr_val = iconv_mime_encode($hdr_name, $hdr_val, $imePrefs); + $hdr_val = preg_replace("#^{$hdr_name}\:\ #", "", $hdr_val); + }elseif (preg_match('#[\x80-\xFF]{1}#', $hdr_val)){ + //This header contains non ASCII chars and should be encoded. + switch ($build_params['head_encoding']) { case 'base64': - // Base64 encoding has been selected. - $mode = 'B'; - $encoded = base64_encode($value); + //Base64 encoding has been selected. + + //Generate the header using the specified params and dynamicly + //determine the maximum length of such strings. + //75 is the value specified in the RFC. The first -2 is there so + //the later regexp doesn't break any of the translated chars. + //The -2 on the first line-regexp is to compensate for the ": " + //between the header-name and the header value + $prefix = '=?' . $build_params['head_charset'] . '?B?'; + $suffix = '?='; + $maxLength = 75 - strlen($prefix . $suffix) - 2; + $maxLength1stLine = $maxLength - strlen($hdr_name) - 2; + + //Base64 encode the entire string + $hdr_val = base64_encode($hdr_val); + + //This regexp will break base64-encoded text at every + //$maxLength but will not break any encoded letters. + $reg1st = "|.{0,$maxLength1stLine}[^\=][^\=]|"; + $reg2nd = "|.{0,$maxLength}[^\=][^\=]|"; break; - case 'quoted-printable': default: - // quoted-printable encoding has been selected - $mode = 'Q'; - $encoded = preg_replace('/([\x2C\x3F\x80-\xFF])/e', "'='.sprintf('%02X', ord('\\1'))", $value); - // replace spaces with _ - $encoded = str_replace(' ', '_', $encoded); + //quoted-printable encoding has been selected + + //Generate the header using the specified params and dynamicly + //determine the maximum length of such strings. + //75 is the value specified in the RFC. The -2 is there so + //the later regexp doesn't break any of the translated chars. + //The -2 on the first line-regexp is to compensate for the ": " + //between the header-name and the header value + $prefix = '=?' . $build_params['head_charset'] . '?Q?'; + $suffix = '?='; + $maxLength = 75 - strlen($prefix . $suffix) - 2; + $maxLength1stLine = $maxLength - strlen($hdr_name) - 2; + + //Replace all special characters used by the encoder. + $search = array("=", "_", "?", " "); + $replace = array("=3D", "=5F", "=3F", "_"); + $hdr_val = str_replace($search, $replace, $hdr_val); + + //Replace all extended characters (\x80-xFF) with their + //ASCII values. + $hdr_val = preg_replace( + '#([\x80-\xFF])#e', + '"=" . strtoupper(dechex(ord("\1")))', + $hdr_val + ); + //This regexp will break QP-encoded text at every $maxLength + //but will not break any encoded letters. + $reg1st = "|(.{0,$maxLength1stLine})[^\=]|"; + $reg2nd = "|(.{0,$maxLength})[^\=]|"; + break; } - - $value = '=?' . $this->_build_params['head_charset'] . '?' . $mode . '?' . $encoded . '?=' . $suffix; - } - - // add chunk to output string by regarding the header maxlen - $len = strlen($value); - if ($line_len + $len < $maxlen) { - $hdr_value .= ($i>0?', ':'') . $value; - $line_len += $len + ($i>0?2:0); - } - else { - $hdr_value .= ($i>0?', ':'') . "\n " . $value; - $line_len = $len; + //Begin with the regexp for the first line. + $reg = $reg1st; + //Prevent lins that are just way to short; + if ($maxLength1stLine >1){ + $reg = $reg2nd; + } + $output = ""; + while ($hdr_val) { + //Split translated string at every $maxLength + //But make sure not to break any translated chars. + $found = preg_match($reg, $hdr_val, $matches); + + //After this first line, we need to use a different + //regexp for the first line. + $reg = $reg2nd; + + //Save the found part and encapsulate it in the + //prefix & suffix. Then remove the part from the + //$hdr_val variable. + if ($found){ + $part = $matches[0]; + $hdr_val = substr($hdr_val, strlen($matches[0])); + }else{ + $part = $hdr_val; + $hdr_val = ""; + } + + //RFC 2047 specifies that any split header should be seperated + //by a CRLF SPACE. + if ($output){ + $output .= "\r\n "; + } + $output .= $prefix . $part . $suffix; + } + $hdr_val = $output; } + $hdr_value_out .= $hdr_val; } - - $input[$hdr_name] = $hdr_value; + $input[$hdr_name] = $hdr_value_out; } return $input; } - - function _explode_quoted_string($delimiter, $string) - { - $quotes = explode("\"", $string); - foreach ($quotes as $key => $val) - if (($key % 2) == 1) - $quotes[$key] = str_replace($delimiter, "_!@!_", $quotes[$key]); - - $string = implode("\"", $quotes); - - $result = explode($delimiter, $string); - foreach ($result as $key => $val) - $result[$key] = str_replace("_!@!_", $delimiter, $result[$key]); - - return $result; - } - - /** * Set the object's end-of-line and define the constant if applicable * @@ -897,5 +1003,3 @@ class Mail_mime } // End of class -?> - diff --git a/program/lib/Mail/mimeDecode.php b/program/lib/Mail/mimeDecode.php index 963c86009..46eabd82f 100644 --- a/program/lib/Mail/mimeDecode.php +++ b/program/lib/Mail/mimeDecode.php @@ -1,136 +1,149 @@ | -// +-----------------------------------------------------------------------+ +/** + * The Mail_mimeDecode class is used to decode mail/mime messages + * + * This class will parse a raw mime email and return + * the structure. Returned structure is similar to + * that returned by imap_fetchstructure(). + * + * +----------------------------- IMPORTANT ------------------------------+ + * | Usage of this class compared to native php extensions such as | + * | mailparse or imap, is slow and may be feature deficient. If available| + * | you are STRONGLY recommended to use the php extensions. | + * +----------------------------------------------------------------------+ + * + * Compatible with PHP versions 4 and 5 + * + * LICENSE: This LICENSE is in the BSD license style. + * Copyright (c) 2002-2003, Richard Heyes + * Copyright (c) 2003-2006, PEAR + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or + * without modification, are permitted provided that the following + * conditions are met: + * + * - Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * - Redistributions in binary form must reproduce the above copyright + * notice, this list of conditions and the following disclaimer in the + * documentation and/or other materials provided with the distribution. + * - Neither the name of the authors, nor the names of its contributors + * may be used to endorse or promote products derived from this + * software without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" + * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE + * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE + * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE + * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR + * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF + * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS + * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN + * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) + * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF + * THE POSSIBILITY OF SUCH DAMAGE. + * + * @category Mail + * @package Mail_Mime + * @author Richard Heyes + * @author George Schlossnagle + * @author Cipriano Groenendal + * @author Sean Coates + * @copyright 2003-2006 PEAR + * @license http://www.opensource.org/licenses/bsd-license.php BSD License + * @version CVS: $Id$ + * @link http://pear.php.net/package/Mail_mime + */ + +/** + * require PEAR + * + * This package depends on PEAR to raise errors. + */ require_once 'PEAR.php'; + /** -* +----------------------------- IMPORTANT ------------------------------+ -* | Usage of this class compared to native php extensions such as | -* | mailparse or imap, is slow and may be feature deficient. If available| -* | you are STRONGLY recommended to use the php extensions. | -* +----------------------------------------------------------------------+ -* -* Mime Decoding class -* -* This class will parse a raw mime email and return -* the structure. Returned structure is similar to -* that returned by imap_fetchstructure(). -* -* USAGE: (assume $input is your raw email) -* -* $decode = new Mail_mimeDecode($input, "\r\n"); -* $structure = $decode->decode(); -* print_r($structure); -* -* Or statically: -* -* $params['input'] = $input; -* $structure = Mail_mimeDecode::decode($params); -* print_r($structure); -* -* TODO: -* o UTF8: ??? - - > 4. We have also found a solution for decoding the UTF-8 - > headers. Therefore I made the following function: - > - > function decode_utf8($txt) { - > $trans=array("‘"=>"õ","ű"=>"û","Ő"=>"•","Ű" - =>"›"); - > $txt=strtr($txt,$trans); - > return(utf8_decode($txt)); - > } - > - > And I have inserted the following line to the class: - > - > if (strtolower($charset)=="utf-8") $text=decode_utf8($text); - > - > ... before the following one in the "_decodeHeader" function: - > - > $input = str_replace($encoded, $text, $input); - > - > This way from now on it can easily decode the UTF-8 headers too. - -* -* @author Richard Heyes -* @version $Revision$ -* @package Mail -*/ + * The Mail_mimeDecode class is used to decode mail/mime messages + * + * This class will parse a raw mime email and return the structure. + * Returned structure is similar to that returned by imap_fetchstructure(). + * + * +----------------------------- IMPORTANT ------------------------------+ + * | Usage of this class compared to native php extensions such as | + * | mailparse or imap, is slow and may be feature deficient. If available| + * | you are STRONGLY recommended to use the php extensions. | + * +----------------------------------------------------------------------+ + * + * @category Mail + * @package Mail_Mime + * @author Richard Heyes + * @author George Schlossnagle + * @author Cipriano Groenendal + * @author Sean Coates + * @copyright 2003-2006 PEAR + * @license http://www.opensource.org/licenses/bsd-license.php BSD License + * @version Release: @package_version@ + * @link http://pear.php.net/package/Mail_mime + */ class Mail_mimeDecode extends PEAR { /** * The raw email to decode + * * @var string + * @access private */ var $_input; /** * The header part of the input + * * @var string + * @access private */ var $_header; /** * The body part of the input + * * @var string + * @access private */ var $_body; /** * If an error occurs, this is used to store the message + * * @var string + * @access private */ var $_error; /** * Flag to determine whether to include bodies in the * returned object. + * * @var boolean + * @access private */ var $_include_bodies; /** * Flag to determine whether to decode bodies + * * @var boolean + * @access private */ var $_decode_bodies; /** * Flag to determine whether to decode headers + * * @var boolean + * @access private */ var $_decode_headers; @@ -834,4 +847,3 @@ class Mail_mimeDecode extends PEAR } } // End of class -?> diff --git a/program/lib/Mail/mimePart.php b/program/lib/Mail/mimePart.php index b429b905e..04c4a9789 100644 --- a/program/lib/Mail/mimePart.php +++ b/program/lib/Mail/mimePart.php @@ -1,125 +1,115 @@ | -// +-----------------------------------------------------------------------+ - /** -* -* Raw mime encoding class -* -* What is it? -* This class enables you to manipulate and build -* a mime email from the ground up. -* -* Why use this instead of mime.php? -* mime.php is a userfriendly api to this class for -* people who aren't interested in the internals of -* mime mail. This class however allows full control -* over the email. -* -* Eg. -* -* // Since multipart/mixed has no real body, (the body is -* // the subpart), we set the body argument to blank. -* -* $params['content_type'] = 'multipart/mixed'; -* $email = new Mail_mimePart('', $params); -* -* // Here we add a text part to the multipart we have -* // already. Assume $body contains plain text. -* -* $params['content_type'] = 'text/plain'; -* $params['encoding'] = '7bit'; -* $text = $email->addSubPart($body, $params); -* -* // Now add an attachment. Assume $attach is -* the contents of the attachment -* -* $params['content_type'] = 'application/zip'; -* $params['encoding'] = 'base64'; -* $params['disposition'] = 'attachment'; -* $params['dfilename'] = 'example.zip'; -* $attach =& $email->addSubPart($body, $params); -* -* // Now build the email. Note that the encode -* // function returns an associative array containing two -* // elements, body and headers. You will need to add extra -* // headers, (eg. Mime-Version) before sending. -* -* $email = $message->encode(); -* $email['headers'][] = 'Mime-Version: 1.0'; -* -* -* Further examples are available at http://www.phpguru.org -* -* TODO: -* - Set encode() to return the $obj->encoded if encode() -* has already been run. Unless a flag is passed to specifically -* re-build the message. -* -* @author Richard Heyes -* @version $Revision$ -* @package Mail -*/ + * The Mail_mimePart class is used to create MIME E-mail messages + * + * This class enables you to manipulate and build a mime email + * from the ground up. The Mail_Mime class is a userfriendly api + * to this class for people who aren't interested in the internals + * of mime mail. + * This class however allows full control over the email. + * + * Compatible with PHP versions 4 and 5 + * + * LICENSE: This LICENSE is in the BSD license style. + * Copyright (c) 2002-2003, Richard Heyes + * Copyright (c) 2003-2006, PEAR + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or + * without modification, are permitted provided that the following + * conditions are met: + * + * - Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * - Redistributions in binary form must reproduce the above copyright + * notice, this list of conditions and the following disclaimer in the + * documentation and/or other materials provided with the distribution. + * - Neither the name of the authors, nor the names of its contributors + * may be used to endorse or promote products derived from this + * software without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" + * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE + * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE + * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE + * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR + * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF + * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS + * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN + * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) + * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF + * THE POSSIBILITY OF SUCH DAMAGE. + * + * @category Mail + * @package Mail_Mime + * @author Richard Heyes + * @author Cipriano Groenendal + * @author Sean Coates + * @copyright 2003-2006 PEAR + * @license http://www.opensource.org/licenses/bsd-license.php BSD License + * @version CVS: $Id$ + * @link http://pear.php.net/package/Mail_mime + */ + +/** + * The Mail_mimePart class is used to create MIME E-mail messages + * + * This class enables you to manipulate and build a mime email + * from the ground up. The Mail_Mime class is a userfriendly api + * to this class for people who aren't interested in the internals + * of mime mail. + * This class however allows full control over the email. + * + * @category Mail + * @package Mail_Mime + * @author Richard Heyes + * @author Cipriano Groenendal + * @author Sean Coates + * @copyright 2003-2006 PEAR + * @license http://www.opensource.org/licenses/bsd-license.php BSD License + * @version Release: @package_version@ + * @link http://pear.php.net/package/Mail_mime + */ class Mail_mimePart { /** * The encoding type of this part + * * @var string + * @access private */ var $_encoding; /** * An array of subparts + * * @var array + * @access private */ var $_subparts; /** * The output of this part after being built + * * @var string + * @access private */ var $_encoded; /** * Headers for this part + * * @var array + * @access private */ var $_headers; /** * The body of this part (not encoded) + * * @var string + * @access private */ var $_body; @@ -234,7 +224,7 @@ class Mail_mimePart { $encoded['body'] = '--' . $boundary . MAIL_MIMEPART_CRLF . implode('--' . $boundary . MAIL_MIMEPART_CRLF, $subparts) . - '--' . $boundary.'--' . MAIL_MIMEPART_CRLF; + '--' . $boundary.'--' . MAIL_MIMEPART_CRLF . MAIL_MIMEPART_CRLF; } else { $encoded['body'] = $this->_getEncodedData($this->_body, $this->_encoding) . MAIL_MIMEPART_CRLF; @@ -299,7 +289,7 @@ class Mail_mimePart { } /** - * quoteadPrintableEncode() + * quotedPrintableEncode() * * Encodes data to quoted-printable standard. * @@ -318,11 +308,12 @@ class Mail_mimePart { while(list(, $line) = each($lines)){ - $linlen = strlen($line); + $line = preg_split('||', $line, -1, PREG_SPLIT_NO_EMPTY); + $linlen = count($line); $newline = ''; for ($i = 0; $i < $linlen; $i++) { - $char = substr($line, $i, 1); + $char = $line[$i]; $dec = ord($char); if (($dec == 32) AND ($i == ($linlen - 1))){ // convert space at eol only @@ -348,4 +339,3 @@ class Mail_mimePart { return $output; } } // End of class -?> -- cgit v1.2.3