Thomas
2013-10-14 566747af00ae413c942a7c6702e24c044af36f17
program/lib/Mail/mime.php
@@ -48,7 +48,7 @@
 * @author    Aleksander Machniak <alec@php.net>
 * @copyright 2003-2006 PEAR <pear-group@php.net>
 * @license   http://www.opensource.org/licenses/bsd-license.php BSD License
 * @version   Release: 1.8.7
 * @version   CVS: $Id$
 * @link      http://pear.php.net/package/Mail_mime
 *
 *            This class is based on HTML Mime Mail class from
@@ -89,7 +89,7 @@
 * @author    Sean Coates <sean@php.net>
 * @copyright 2003-2006 PEAR <pear-group@php.net>
 * @license   http://www.opensource.org/licenses/bsd-license.php BSD License
 * @version   Release: 1.8.7
 * @version   Release: @package_version@
 * @link      http://pear.php.net/package/Mail_mime
 */
class Mail_mime
@@ -254,6 +254,7 @@
                $this->_txtbody .= $cont;
            }
        }
        return true;
    }
@@ -347,7 +348,7 @@
        }
        if (!$content_id) {
            $content_id = md5(uniqid(time()));
            $content_id = preg_replace('/[^0-9a-zA-Z]/', '', uniqid(time(), true));
        }
        $this->_html_images[] = array(
@@ -429,8 +430,7 @@
        if (!strlen($filename)) {
            $msg = "The supplied filename for the attachment can't be empty";
            $err = PEAR::raiseError($msg);
            return $err;
            return $this->_raiseError($msg);
        }
        $this->_parts[] = array(
@@ -465,16 +465,13 @@
    {
        // Check state of file and raise an error properly
        if (!file_exists($file_name)) {
            $err = PEAR::raiseError('File not found: ' . $file_name);
            return $err;
            return $this->_raiseError('File not found: ' . $file_name);
        }
        if (!is_file($file_name)) {
            $err = PEAR::raiseError('Not a regular file: ' . $file_name);
            return $err;
            return $this->_raiseError('Not a regular file: ' . $file_name);
        }
        if (!is_readable($file_name)) {
            $err = PEAR::raiseError('File is not readable: ' . $file_name);
            return $err;
            return $this->_raiseError('File is not readable: ' . $file_name);
        }
        // Temporarily reset magic_quotes_runtime and read file contents
@@ -500,7 +497,7 @@
     * @return object      The text mimePart object
     * @access private
     */
    function _addTextPart(&$obj, $text)
    function &_addTextPart(&$obj = null, $text = '')
    {
        $params['content_type'] = 'text/plain';
        $params['encoding']     = $this->_build_params['text_encoding'];
@@ -509,11 +506,11 @@
        if (is_object($obj)) {
            $ret = $obj->addSubpart($text, $params);
            return $ret;
        } else {
            $ret = new Mail_mimePart($text, $params);
            return $ret;
        }
        return $ret;
    }
    /**
@@ -526,7 +523,7 @@
     * @return object     The html mimePart object
     * @access private
     */
    function _addHtmlPart(&$obj)
    function &_addHtmlPart(&$obj = null)
    {
        $params['content_type'] = 'text/html';
        $params['encoding']     = $this->_build_params['html_encoding'];
@@ -535,11 +532,11 @@
        if (is_object($obj)) {
            $ret = $obj->addSubpart($this->_htmlbody, $params);
            return $ret;
        } else {
            $ret = new Mail_mimePart($this->_htmlbody, $params);
            return $ret;
        }
        return $ret;
    }
    /**
@@ -550,9 +547,8 @@
     * @return object The multipart/mixed mimePart object
     * @access private
     */
    function _addMixedPart()
    function &_addMixedPart()
    {
        $params                 = array();
        $params['content_type'] = 'multipart/mixed';
        $params['eol']          = $this->_build_params['eol'];
@@ -572,17 +568,18 @@
     * @return object     The multipart/mixed mimePart object
     * @access private
     */
    function _addAlternativePart(&$obj)
    function &_addAlternativePart(&$obj = null)
    {
        $params['content_type'] = 'multipart/alternative';
        $params['eol']          = $this->_build_params['eol'];
        if (is_object($obj)) {
            return $obj->addSubpart('', $params);
            $ret = $obj->addSubpart('', $params);
        } else {
            $ret = new Mail_mimePart('', $params);
            return $ret;
        }
        return $ret;
    }
    /**
@@ -596,17 +593,18 @@
     * @return object     The multipart/mixed mimePart object
     * @access private
     */
    function _addRelatedPart(&$obj)
    function &_addRelatedPart(&$obj = null)
    {
        $params['content_type'] = 'multipart/related';
        $params['eol']          = $this->_build_params['eol'];
        if (is_object($obj)) {
            return $obj->addSubpart('', $params);
            $ret = $obj->addSubpart('', $params);
        } else {
            $ret = new Mail_mimePart('', $params);
            return $ret;
        }
        return $ret;
    }
    /**
@@ -619,7 +617,7 @@
     * @return object       The image mimePart object
     * @access private
     */
    function _addHtmlImagePart(&$obj, $value)
    function &_addHtmlImagePart(&$obj, $value)
    {
        $params['content_type'] = $value['c_type'];
        $params['encoding']     = 'base64';
@@ -650,7 +648,7 @@
     * @return object       The image mimePart object
     * @access private
     */
    function _addAttachmentPart(&$obj, $value)
    function &_addAttachmentPart(&$obj, $value)
    {
        $params['eol']          = $this->_build_params['eol'];
        $params['filename']     = $value['name'];
@@ -700,9 +698,9 @@
     * 
     * @param string $separation The separation between these two parts.
     * @param array  $params     The Build parameters passed to the
     *                           &get() function. See &get for more info.
     *                           get() function. See get() for more info.
     * @param array  $headers    The extra headers that should be passed
     *                           to the &headers() function.
     *                           to the headers() method.
     *                           See that function for more info.
     * @param bool   $overwrite  Overwrite the existing headers with new.
     *
@@ -722,9 +720,7 @@
            return $body;
        }
        $head = $this->txtHeaders($headers, $overwrite);
        $mail = $head . $separation . $body;
        return $mail;
        return $this->txtHeaders($headers, $overwrite) . $separation . $body;
    }
    /**
@@ -732,7 +728,7 @@
     * mail delivery method.
     * 
     * @param array $params The Build parameters passed to the
     *                      &get() function. See &get for more info.
     *                      get() method. See get() for more info.
     *
     * @return mixed The e-mail body or PEAR error object
     * @access public
@@ -748,9 +744,9 @@
     * 
     * @param string $filename  Output file location
     * @param array  $params    The Build parameters passed to the
     *                          &get() function. See &get for more info.
     *                          get() method. See get() for more info.
     * @param array  $headers   The extra headers that should be passed
     *                          to the &headers() function.
     *                          to the headers() function.
     *                          See that function for more info.
     * @param bool   $overwrite Overwrite the existing headers with new.
     *
@@ -762,8 +758,7 @@
    {
        // Check state of file and raise an error properly
        if (file_exists($filename) && !is_writable($filename)) {
            $err = PEAR::raiseError('File is not writable: ' . $filename);
            return $err;
            return $this->_raiseError('File is not writable: ' . $filename);
        }
        // Temporarily reset magic_quotes_runtime and read file contents
@@ -772,15 +767,13 @@
        }
        if (!($fh = fopen($filename, 'ab'))) {
            $err = PEAR::raiseError('Unable to open file: ' . $filename);
            return $err;
            return $this->_raiseError('Unable to open file: ' . $filename);
        }
        // Write message headers into file (skipping Content-* headers)
        $head = $this->txtHeaders($headers, $overwrite, true);
        if (fwrite($fh, $head) === false) {
            $err = PEAR::raiseError('Error writing to file: ' . $filename);
            return $err;
            return $this->_raiseError('Error writing to file: ' . $filename);
        }
        fclose($fh);
@@ -797,10 +790,10 @@
    /**
     * Writes (appends) the complete e-mail body into file.
     *
     *
     * @param string $filename Output file location
     * @param array  $params   The Build parameters passed to the
     *                         &get() function. See &get for more info.
     *                         get() method. See get() for more info.
     *
     * @return mixed True or PEAR error object
     * @access public
@@ -810,8 +803,7 @@
    {
        // Check state of file and raise an error properly
        if (file_exists($filename) && !is_writable($filename)) {
            $err = PEAR::raiseError('File is not writable: ' . $filename);
            return $err;
            return $this->_raiseError('File is not writable: ' . $filename);
        }
        // Temporarily reset magic_quotes_runtime and read file contents
@@ -820,8 +812,7 @@
        }
        if (!($fh = fopen($filename, 'ab'))) {
            $err = PEAR::raiseError('Unable to open file: ' . $filename);
            return $err;
            return $this->_raiseError('Unable to open file: ' . $filename);
        }
        // Write the rest of the message into file
@@ -844,7 +835,7 @@
     * @return mixed The MIME message content string, null or PEAR error object
     * @access public
     */
    function &get($params = null, $filename = null, $skip_head = false)
    function get($params = null, $filename = null, $skip_head = false)
    {
        if (isset($params)) {
            while (list($key, $value) = each($params)) {
@@ -1004,8 +995,7 @@
        }
        if (!isset($message)) {
            $ret = null;
            return $ret;
            return null;
        }
        // Use saved boundary
@@ -1023,16 +1013,14 @@
                return $headers;
            }
            $this->_headers = array_merge($this->_headers, $headers);
            $ret = null;
            return $ret;
            return null;
        } else {
            $output = $message->encode($boundary, $skip_head);
            if ($this->_isError($output)) {
                return $output;
            }
            $this->_headers = array_merge($this->_headers, $output['headers']);
            $body = $output['body'];
            return $body;
            return $output['body'];
        }
    }
@@ -1050,7 +1038,7 @@
     * @return array              Assoc array with the mime headers
     * @access public
     */
    function &headers($xtra_headers = null, $overwrite = false, $skip_content = false)
    function headers($xtra_headers = null, $overwrite = false, $skip_content = false)
    {
        // Add mime version header
        $headers['MIME-Version'] = '1.0';
@@ -1473,7 +1461,7 @@
    }
    /**
     * PEAR::isError wrapper
     * PEAR::isError implementation
     *
     * @param mixed $data Object
     *
@@ -1490,4 +1478,18 @@
        return false;
    }
    /**
     * PEAR::raiseError implementation
     *
     * @param $message A text error message
     *
     * @return PEAR_Error Instance of PEAR_Error
     * @access private
     */
    function _raiseError($message)
    {
        // PEAR::raiseError() is not PHP 5.4 compatible
        return new PEAR_Error($message);
    }
} // End of class