

   API docs

   



Only public methods are documented. All properties are considered private except for

is_built, which is a boolean and determines whether the message is built or not. This

can be reset after sending to false, to force rebuilding if sending multiple times.

If the content of the message doesn't change, rebuilding shouldn't be necessary.







void htmlMimeMail()



  Constructor. Simply sets up some defaults. In particular the smtp parameters

  are initialised to:



    host -> localhost

    port -> 25

    helo -> Either HTTP_HOST, SERVER_NAME, or localhost in that order

    auth -> false

    user -> blank

    pass -> blank



  Also, the build parameters are initialised to:



    html_encoding -> quoted-printable

    text_encoding -> 7bit

    html_charset  -> ISO-8859-1

    text_charset  -> ISO-8859-1

    head_charset  -> ISO-8859-1

    text_wrap     -> 998







void setCrlf(string CRLF style)



  Sets the type of CRLF to use. Usually either \r\n, \n or \r. Don't normally

  need to call this as the send() function will set it according to what method

  of sending you're using (SMTP versus PHP mail()).







void setSMTPParams(string host, integer port, string helo, boolean auth, string user, string pass)



  Use this if you need to alter the SMTP details. All arguments default to NULL so you

  if you only need to set one thing you can set the rest to NULL.







void setTextEncoding(string encoding)



  Use this method to set the style of encoding for the text part of the message. Can be

  one of 7bit, 8bit, quoted-printable, and base64. Defaults to 7bit.







void setHTMLEncoding(string encoding)



  As above except it applies to the HTML part of the message. Defaults to quoted-printable.







void setTextCharset(string charset)



  The character set to use for the text part of the message. Defaults ISO-8859-1.







void setHTMLCharset(string charset)



  The character set to use for the HTML part of the message. Defaults ISO-8859-1.







void setHeadCharset(string charset)



  The characer set to use when headers are encoded (RFC2047). Defaults to ISO-8859-1.







void setSubject(string subject)



  Sets the Subject: header.







void setFrom(string from)



  Sets the From: header. This is also used if the return path is not set when sending via

  SMTP.







void setCc(string Cc)



  Sets the Cc: header. This can be multiple addresses.







void setBcc(string bcc)



  Sets the Bcc: header. This can be multiple addresses.







void setText(string text)



  Sets the text part of the message. Should ONLY be used if you're sending a TEXT ONLY

  email. See the setHTML() method  for setting the text alternative to a HTML/text email.







void setHTML(string html, string text, string images_path)



  Use this method to set the HTML part of your message. The 2nd and 3rd arguments are

  optional. The second sets the alternative text to the HTML in your message. The third

  sets a path for the class to look in for any image references it finds in the HTML. If

  you want to avoid multiple calls to addHTMLImage() you can use this third argument to

  get the class to look for and auto add images referenced by the HTML. It has restrictions

  in that the image refs must be quoted (eg. <img src="foo.gif" and not <img src=foo.gif).

  The extension/content-type mappings are set in the constructor in the property image_types.

  This property can be added to if necessary, and is not restricted to mere images.







void addHTMLImage(string filedata, string name, string content_type)



  Use this method to add an embedded image to your message. The first argument is the file

  itself (you can use the getFile() method if you have a filename). The second the name of

  the file, commonly the filename (eg foo.gif). This name must match precisely the name it

  is referenced by in the HTML. The third argument is the content-type of the file, eg.

  image/gif.







void addAttachment(string filedata, string filename, string content_type, string encoding)



  Use this method to add an attachment to the message. The first three arguments are the

  same as the method above. The fourth can be used to specify an alternate encoding to

  base64. This is useful when you're adding attached messages which are better encoded as

  7bit, (an example of this is in example.5.php).







boolean buildMessage(array params)



  Usually you don't need to call this method as it's automatically called by the send()

  method. However, if you're using the send() method in a loop sending to multiple recipients

  AND changing the HTML/text/headers each time, then you will need to call this method before

  calling the send() method to force the email to be rebuilt. The argument is an associative

  array containing the following options to alter the way the email is built:



    Array key       Purpose

    =========       =======

    html_encoding   Sets the encoding type for HTML. See setHTMLEncoding()

    text_encoding   Sets the encoding type for text. See setTextEncoding()

    text_wrap       Sets the default wrap for text parts. Defaults to 998.

    html_charset    Sets the charset for the HTML part. See setHTMLCharset().

    text_charset    Sets the charset for the text part. See setTextCharset().

    head_charset    Sets the charset for encoded headers. See setHeadCharset().







boolean send(array recipients, string type)



  This method sends the message. The recipients array is what becomes the To: header. This

  can be simply an empty array if you've set Cc: or Bcc: headers instead. The second argument

  determines what method to send the mail via. This can be 'mail' (the default) or 'smtp' to

  send direct via an SMTP server. In this case the smtp parameters are used to connect to the

  server. The return value is true or false indicating a successful send or not. With SMTP if

  there are errors they will be set in the errors property (an array) ie. $obj->errors.







string getRFC822(array recipients)



  This method can be used to return a message as a string suitable for adding to another mail

  object using addAttachment(). The recipients argument is as with the send() method.







string getFile(string filename)



  Reads the given filename in and returns it. Use this to read files and add them

  as attachments or embedded images/objects. See the examples for usages.



