| | |
| | | } |
| | | } else { |
| | | $cont = $this->_file2str($data); |
| | | if (PEAR::isError($cont)) { |
| | | if ($this->_isError($cont)) { |
| | | return $cont; |
| | | } |
| | | if (!$append) { |
| | |
| | | $this->_txtbody .= $cont; |
| | | } |
| | | } |
| | | |
| | | return true; |
| | | } |
| | | |
| | |
| | | $this->_htmlbody = $data; |
| | | } else { |
| | | $cont = $this->_file2str($data); |
| | | if (PEAR::isError($cont)) { |
| | | if ($this->_isError($cont)) { |
| | | return $cont; |
| | | } |
| | | $this->_htmlbody = $cont; |
| | |
| | | $filedata = null; |
| | | $bodyfile = $file; |
| | | } else { |
| | | if (PEAR::isError($filedata = $this->_file2str($file))) { |
| | | if ($this->_isError($filedata = $this->_file2str($file))) { |
| | | return $filedata; |
| | | } |
| | | } |
| | |
| | | } |
| | | |
| | | if (!$content_id) { |
| | | $content_id = md5(uniqid(time())); |
| | | $content_id = preg_replace('/[^0-9a-zA-Z]/', '', uniqid(time(), true)); |
| | | } |
| | | |
| | | $this->_html_images[] = array( |
| | |
| | | * @param string $description Content-Description header |
| | | * @param string $h_charset The character set of the headers e.g. filename |
| | | * If not specified, $charset will be used |
| | | * @param array $add_headers Additional part headers. Array keys can be in form |
| | | * of <header_name>:<parameter_name> |
| | | * |
| | | * @return mixed True on success or PEAR_Error object |
| | | * @access public |
| | |
| | | $n_encoding = null, |
| | | $f_encoding = null, |
| | | $description = '', |
| | | $h_charset = null |
| | | $h_charset = null, |
| | | $add_headers = array() |
| | | ) { |
| | | $bodyfile = null; |
| | | |
| | |
| | | $filedata = null; |
| | | $bodyfile = $file; |
| | | } else { |
| | | if (PEAR::isError($filedata = $this->_file2str($file))) { |
| | | if ($this->_isError($filedata = $this->_file2str($file))) { |
| | | return $filedata; |
| | | } |
| | | } |
| | | // Force the name the user supplied, otherwise use $file |
| | | $filename = ($name ? $name : $file); |
| | | $filename = ($name ? $name : $this->_basename($file)); |
| | | } else { |
| | | $filedata = $file; |
| | | $filename = $name; |
| | |
| | | |
| | | if (!strlen($filename)) { |
| | | $msg = "The supplied filename for the attachment can't be empty"; |
| | | $err = PEAR::raiseError($msg); |
| | | return $err; |
| | | return $this->_raiseError($msg); |
| | | } |
| | | $filename = $this->_basename($filename); |
| | | |
| | | $this->_parts[] = array( |
| | | 'body' => $filedata, |
| | |
| | | 'location' => $location, |
| | | 'disposition' => $disposition, |
| | | 'description' => $description, |
| | | 'add_headers' => $add_headers, |
| | | 'name_encoding' => $n_encoding, |
| | | 'filename_encoding' => $f_encoding, |
| | | 'headers_charset' => $h_charset, |
| | |
| | | * @return string Contents of $file_name |
| | | * @access private |
| | | */ |
| | | function &_file2str($file_name) |
| | | function _file2str($file_name) |
| | | { |
| | | // 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 |
| | |
| | | * @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']; |
| | |
| | | |
| | | if (is_object($obj)) { |
| | | $ret = $obj->addSubpart($text, $params); |
| | | return $ret; |
| | | } else { |
| | | $ret = new Mail_mimePart($text, $params); |
| | | return $ret; |
| | | } |
| | | |
| | | return $ret; |
| | | } |
| | | |
| | | /** |
| | |
| | | * @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']; |
| | |
| | | |
| | | if (is_object($obj)) { |
| | | $ret = $obj->addSubpart($this->_htmlbody, $params); |
| | | return $ret; |
| | | } else { |
| | | $ret = new Mail_mimePart($this->_htmlbody, $params); |
| | | return $ret; |
| | | } |
| | | |
| | | return $ret; |
| | | } |
| | | |
| | | /** |
| | |
| | | */ |
| | | function &_addMixedPart() |
| | | { |
| | | $params = array(); |
| | | $params['content_type'] = 'multipart/mixed'; |
| | | $params['eol'] = $this->_build_params['eol']; |
| | | |
| | |
| | | * @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; |
| | | } |
| | | |
| | | /** |
| | |
| | | * @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; |
| | | } |
| | | |
| | | /** |
| | |
| | | if (!empty($value['description'])) { |
| | | $params['description'] = $value['description']; |
| | | } |
| | | if (is_array($value['add_headers'])) { |
| | | $params['headers'] = $value['add_headers']; |
| | | } |
| | | |
| | | $ret = $obj->addSubpart($value['body'], $params); |
| | | return $ret; |
| | |
| | | * |
| | | * @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. |
| | | * |
| | |
| | | |
| | | $body = $this->get($params); |
| | | |
| | | if (PEAR::isError($body)) { |
| | | if ($this->_isError($body)) { |
| | | return $body; |
| | | } |
| | | |
| | | $head = $this->txtHeaders($headers, $overwrite); |
| | | $mail = $head . $separation . $body; |
| | | return $mail; |
| | | return $this->txtHeaders($headers, $overwrite) . $separation . $body; |
| | | } |
| | | |
| | | /** |
| | |
| | | * 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 |
| | |
| | | * |
| | | * @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. |
| | | * |
| | |
| | | { |
| | | // 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 |
| | |
| | | } |
| | | |
| | | 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); |
| | |
| | | |
| | | /** |
| | | * 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 |
| | |
| | | { |
| | | // 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 |
| | |
| | | } |
| | | |
| | | 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 |
| | |
| | | * @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)) { |
| | |
| | | } |
| | | |
| | | if (!isset($message)) { |
| | | $ret = null; |
| | | return $ret; |
| | | return null; |
| | | } |
| | | |
| | | // Use saved boundary |
| | |
| | | if ($filename) { |
| | | // Append mimePart message headers and body into file |
| | | $headers = $message->encodeToFile($filename, $boundary, $skip_head); |
| | | if (PEAR::isError($headers)) { |
| | | if ($this->_isError($headers)) { |
| | | return $headers; |
| | | } |
| | | $this->_headers = array_merge($this->_headers, $headers); |
| | | $ret = null; |
| | | return $ret; |
| | | return null; |
| | | } else { |
| | | $output = $message->encode($boundary, $skip_head); |
| | | if (PEAR::isError($output)) { |
| | | if ($this->_isError($output)) { |
| | | return $output; |
| | | } |
| | | $this->_headers = array_merge($this->_headers, $output['headers']); |
| | | $body = $output['body']; |
| | | return $body; |
| | | return $output['body']; |
| | | } |
| | | } |
| | | |
| | |
| | | * @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'; |
| | |
| | | ? $this->_build_params['eol'] : "\r\n"; |
| | | |
| | | // add parameters |
| | | $token_regexp = '#([^\x21,\x23-\x27,\x2A,\x2B,\x2D' |
| | | . ',\x2E,\x30-\x39,\x41-\x5A,\x5E-\x7E])#'; |
| | | $token_regexp = '#([^\x21\x23-\x27\x2A\x2B\x2D' |
| | | . '\x2E\x30-\x39\x41-\x5A\x5E-\x7E])#'; |
| | | if (is_array($params)) { |
| | | foreach ($params as $name => $value) { |
| | | if ($name == 'boundary') { |
| | |
| | | */ |
| | | function encodeHeader($name, $value, $charset, $encoding) |
| | | { |
| | | return Mail_mimePart::encodeHeader( |
| | | $mime_part = new Mail_mimePart; |
| | | return $mime_part->encodeHeader( |
| | | $name, $value, $charset, $encoding, $this->_build_params['eol'] |
| | | ); |
| | | } |
| | |
| | | } |
| | | } |
| | | |
| | | /** |
| | | * PEAR::isError implementation |
| | | * |
| | | * @param mixed $data Object |
| | | * |
| | | * @return bool True if object is an instance of PEAR_Error |
| | | * @access private |
| | | */ |
| | | function _isError($data) |
| | | { |
| | | // PEAR::isError() is not PHP 5.4 compatible (see Bug #19473) |
| | | if (is_object($data) && is_a($data, 'PEAR_Error')) { |
| | | return true; |
| | | } |
| | | |
| | | 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 |