ilMimeMail Class Reference

this class encapsulates the PHP mail() function. More...

Collaboration diagram for ilMimeMail:

Public Member Functions
	ilMimeMail ()
	Mail contructor.
	autoCheck ($bool)
	activate or desactivate the email addresses validator ex: autoCheck( true ) turn the validator on by default autoCheck feature is on
	Subject ($subject)
	Define the subject line of the email.
	From ($from)
	set the sender of the mail
	ReplyTo ($address)
	set the Reply-to header
	Receipt ()
	add a receipt to the mail ie.
	To ($to)
	set the mail recipient
	Cc ($cc)
	Cc() cc : email address(es), accept both array and string.
	Bcc ($bcc)
	Bcc() set the Bcc headers ( blank carbon copy ).
	Body ($body, $charset="")
	Body( text [, charset] ) set the body (message) of the mail define the charset if the message contains extended characters (accents) default to us-ascii $mail->Body( "m�l en fran�ais avec des accents", "iso-8859-1" );.
	Organization ($org)
	Organization( $org ) set the Organization header.
	Priority ($priority)
	Priority( $priority ) set the mail priority $priority : integer taken between 1 (highest) and 5 ( lowest ) ex: $mail->Priority(1) ; => Highest.
	Attach ($filename, $filetype="", $disposition="inline")
	Attach a file to the mail.
	BuildMail ()
	Build the email message public.
	Send ()
	fornat and send the mail public
	Get ()
	return the whole e-mail , headers + message can be used for displaying the message in plain text or logging it
	ValidEmail ($address)
	check an email address validity public
	CheckAdresses ($aad)
	check validity of email addresses return if unvalid, output an error message and exit, this may -should- be customized
	_build_attachement ()
	check and encode attach file(s) .
	_mimeEncode ($a_string)

Data Fields
	$sendto = array()
	$acc = array()
	$abcc = array()
	$aattach = array()
	$xheaders = array()
	$priorities = array( '1 (Highest)', '2 (High)', '3 (Normal)', '4 (Low)', '5 (Lowest)' )
	$charset = "utf-8"
	$ctencoding = "8bit"
	$receipt = 0

Detailed Description

this class encapsulates the PHP mail() function.

implements CC, Bcc, Priority headers include "libmail.php"; $m= new Mail; // create the mail $m->From( "leo@isp.com" ); $m->To( "destination@somewhere.fr" ); $m->Subject( "the subject of the mail" ); $message= "Hello world!\nthis is a test of the Mail class\nplease ignore\nThanks."; $m->Body( $message); // set the body $m->Cc( "someone@somewhere.fr"); $m->Bcc( "someoneelse@somewhere.fr"); $m->Priority(4) ; // set the priority to Low m->Attach( "/home/leo/toto.gif", "image/gif" ) ; // attach a file of type image/gif $m->Send(); // send the mail echo "the mail below has been sent:<br><pre>", $m->Get(), "</pre>";

Author

Leo West - lwest.nosp@m.@fre.nosp@m.e.fr

Version

Id:

class.ilMimeMail.php 24039 2010-06-01 12:49:37Z mjansen

Definition at line 47 of file class.ilMimeMail.php.

Member Function Documentation

ilMimeMail::_build_attachement

(

)

check and encode attach file(s) .

internal use only private

Definition at line 435 of file class.ilMimeMail.php.

References $filename, and exit.

Referenced by BuildMail().

        {

                $this->xheaders["Content-Type"] = "multipart/mixed;\n boundary=\"$this->boundary\"";

                $this->fullBody = "This is a multi-part message in MIME format.\n--$this->boundary\n";
                $this->fullBody .= "Content-Type: text/plain; charset=$this->charset\nContent-Transfer-Encoding: $this->ctencoding\n\n".
                        $this->body ."\n";
        
                $sep= chr(13) . chr(10);
        
                $ata= array();
                $k=0;
        
                // for each attached file, do...
                for( $i=0; $i < count( $this->aattach); $i++ ) {
                
                        $filename = $this->aattach[$i];
                        $basename = basename($filename);
                        $ctype = $this->actype[$i];     // content-type
                        $disposition = $this->adispo[$i];
                
                        if( ! file_exists( $filename) ) {
                                echo "Class Mail, method attach : file $filename can't be found"; exit;
                        }
                        $subhdr= "--$this->boundary\nContent-type: $ctype;\n name=\"$basename\"\nContent-Transfer-Encoding:".
                                "base64\nContent-Disposition: $disposition;\n  filename=\"$basename\"\n\n";
                        $ata[$k++] = $subhdr;
                        // non encoded line length
                        $linesz= filesize( $filename)+1;
                        $fp= fopen( $filename, 'r' );
                        $ata[$k++] = chunk_split(base64_encode(fread( $fp, $linesz)));
                        fclose($fp);
                }
                $this->fullBody .= implode($sep, $ata);
        }

Here is the caller graph for this function:

ilMimeMail::_mimeEncode

(

$a_string

)

Definition at line 472 of file class.ilMimeMail.php.

Referenced by ilMail\addFullname(), ilMail\getIliasMailerAddress(), and Subject().

        {
                $encoded = '=?utf-8?b?';
                $encoded .= base64_encode($a_string);
                $encoded .= '?=';

                return $encoded;
        }

Here is the caller graph for this function:

ilMimeMail::Attach	(		$filename,
			$filetype = "",
			$disposition = "inline"
	)

Attach a file to the mail.

Parameters

string	filename : path of the file to attach
string	filetype : MIME-type of the file. default to 'application/x-unknown-content-type'
string	disposition : instruct the Mailclient to display the file if possible ("inline") or always as a link ("attachment") possible values are "inline", "attachment"

Definition at line 296 of file class.ilMimeMail.php.

References $filename.

        {
                // TODO : si filetype="", alors chercher dans un tablo de MT connus / extension du fichier
                if( $filetype == "" )
                        $filetype = "application/octet-stream";
                
                $this->aattach[] = $filename;
                $this->actype[] = $filetype;
                $this->adispo[] = $disposition;
        }

ilMimeMail::autoCheck

(

$bool

)

activate or desactivate the email addresses validator ex: autoCheck( true ) turn the validator on by default autoCheck feature is on

Parameters

boolean

set to true to turn on the auto validation public

Definition at line 110 of file class.ilMimeMail.php.

Referenced by ilMimeMail().

        {
                if( $bool )
                        $this->checkAddress = true;
                else
                        $this->checkAddress = false;
        }

Here is the caller graph for this function:

ilMimeMail::Bcc

(

$bcc

)

Bcc() set the Bcc headers ( blank carbon copy ).

bcc : email address(es), accept both array and string

Parameters

string

bcc

Definition at line 221 of file class.ilMimeMail.php.

References CheckAdresses().

        {
                if( is_array($bcc) ) {
                        $this->abcc = $bcc;
                } else {
                        $this->abcc[]= $bcc;
                }

                if( $this->checkAddress == true )
                        $this->CheckAdresses( $this->abcc );
        }

Here is the call graph for this function:

ilMimeMail::Body	(		$body,
			$charset = ""
	)

Body( text [, charset] ) set the body (message) of the mail define the charset if the message contains extended characters (accents) default to us-ascii $mail->Body( "m�l en fran�ais avec des accents", "iso-8859-1" );.

Parameters

string	body
string	charset (optional)

Definition at line 243 of file class.ilMimeMail.php.

References $charset.

        {
                $this->body = $body;
        
                if( $charset != "" ) {
                        $this->charset = strtolower($charset);
                        if( $this->charset == "us-ascii" )
                                $this->ctencoding = "7bit";
                }
        }

ilMimeMail::BuildMail

(

)

Build the email message public.

Definition at line 311 of file class.ilMimeMail.php.

References $ctencoding, and _build_attachement().

Referenced by Get(), and Send().

        {

                // build the headers
                $this->headers = "";
                //      $this->xheaders['To'] = implode( ", ", $this->sendto );
        
                if( count($this->acc) > 0 )
                        $this->xheaders['CC'] = implode( ", ", $this->acc );
        
                if( count($this->abcc) > 0 ) 
                        $this->xheaders['BCC'] = implode( ", ", $this->abcc );
        

                if( $this->receipt ) {
                        if( isset($this->xheaders["Reply-To"] ) )
                                $this->xheaders["Disposition-Notification-To"] = $this->xheaders["Reply-To"];
                        else 
                                $this->xheaders["Disposition-Notification-To"] = $this->xheaders['From'];
                }
        
                if( $this->charset != "" ) {
                        $this->xheaders["Mime-Version"] = "1.0";
                        $this->xheaders["Content-Type"] = "text/plain; charset=$this->charset";
                        $this->xheaders["Content-Transfer-Encoding"] = $this->ctencoding;
                }

                $this->xheaders["X-Mailer"] = "Php/libMailv1.3";
        
                // include attached files
                if( count( $this->aattach ) > 0 ) {
                        $this->_build_attachement();
                } else {
                        $this->fullBody = $this->body;
                }

                reset($this->xheaders);
                while( list( $hdr,$value ) = each( $this->xheaders )  ) {
                        if( $hdr != "Subject" )
                                $this->headers .= "$hdr: $value\n";
                }
        

        }

Here is the call graph for this function:

Here is the caller graph for this function:

ilMimeMail::Cc

(

$cc

)

Cc() cc : email address(es), accept both array and string.

Parameters

string

cc set the CC headers ( carbon copy )

Definition at line 200 of file class.ilMimeMail.php.

References CheckAdresses().

        {
                if( is_array($cc) )
                        $this->acc= $cc;
                else 
                        $this->acc[]= $cc;
                
                if( $this->checkAddress == true )
                        $this->CheckAdresses( $this->acc );
        
        }

Here is the call graph for this function:

ilMimeMail::CheckAdresses

(

$aad

)

check validity of email addresses return if unvalid, output an error message and exit, this may -should- be customized

Parameters

array

aad -

Definition at line 419 of file class.ilMimeMail.php.

References exit, and ValidEmail().

Referenced by Bcc(), Cc(), and To().

        {
                for($i=0;$i< count( $aad); $i++ ) {
                        if( ! $this->ValidEmail( $aad[$i]) ) {
                                echo "Class Mail, method Mail : invalid address $aad[$i]";      
                                exit;
                        }
                }
        }

Here is the call graph for this function:

Here is the caller graph for this function:

ilMimeMail::From

(

$from

)

set the sender of the mail

Parameters

string

from should be an email address

Definition at line 134 of file class.ilMimeMail.php.

References exit.

Referenced by ilPurchaseBaseGUI\__sendBill().

        {

                if( ! is_string($from) ) {
                        echo "Class Mail: error, From is not a string";
                        exit;
                }
                
                //  base64_encode fullname but not email
                
                $this->xheaders['From'] = $from;
        }

Here is the caller graph for this function:

ilMimeMail::Get

(

)

return the whole e-mail , headers + message can be used for displaying the message in plain text or logging it

Definition at line 384 of file class.ilMimeMail.php.

References BuildMail().

        {
                $this->BuildMail();
                $mail = "To: " . $this->strTo . "\n";
                $mail .= $this->headers . "\n";
                $mail .= $this->fullBody;
                return $mail;
        }

Here is the call graph for this function:

ilMimeMail::ilMimeMail

(

)

Mail contructor.

Definition at line 96 of file class.ilMimeMail.php.

References autoCheck().

        {
                $this->autoCheck( false);
                $this->boundary= "--" . md5( uniqid("myboundary") );
        }

Here is the call graph for this function:

ilMimeMail::Organization

(

$org

)

Organization( $org ) set the Organization header.

Parameters

string

organization

Definition at line 260 of file class.ilMimeMail.php.

        {
                if( trim( $org != "" )  )
                        $this->xheaders['Organization'] = $org;
        }

ilMimeMail::Priority

(

$priority

)

Priority( $priority ) set the mail priority $priority : integer taken between 1 (highest) and 5 ( lowest ) ex: $mail->Priority(1) ; => Highest.

Parameters

integer

priority

Definition at line 274 of file class.ilMimeMail.php.

        {
                if( ! intval( $priority ) )
                        return false;
                
                if( ! isset( $this->priorities[$priority-1]) )
                        return false;

                $this->xheaders["X-Priority"] = $this->priorities[$priority-1];
        
                return true;
        
        }

ilMimeMail::Receipt

(

)

add a receipt to the mail ie.

a confirmation is returned to the "From" address (or "ReplyTo" if defined) when the receiver opens the message.

Warning

this functionality is not a standard, thus only some mail clients are compliants.

Definition at line 168 of file class.ilMimeMail.php.

        {
                $this->receipt = 1;
        }

ilMimeMail::ReplyTo

(

$address

)

set the Reply-to header

Parameters

string

address should be an email address

Definition at line 151 of file class.ilMimeMail.php.

        {

                if( ! is_string($address) ) 
                        return false;
        
                $this->xheaders["Reply-To"] = $address;
                
        }

ilMimeMail::Send

(

)

fornat and send the mail public

Definition at line 360 of file class.ilMimeMail.php.

References $ilSetting, $res, and BuildMail().

        {
                #global $ilLog;
                global $ilSetting;

                $this->BuildMail();
        
                $this->strTo = implode( ", ", $this->sendto );
        
                // envoie du mail
                if(!(int)$ilSetting->get('prevent_smtp_globally'))
                {
                        $res = @mail( $this->strTo, $this->xheaders['Subject'], $this->fullBody, $this->headers );              
                }
                #$ilLog->write($this->strTo.' '. $this->xheaders['Subject'].' '. $this->fullBody.' '. $this->headers);
        }

Here is the call graph for this function:

ilMimeMail::Subject

(

$subject

)

Define the subject line of the email.

Parameters

string

subject any monoline string

Definition at line 123 of file class.ilMimeMail.php.

References _mimeEncode().

        {
                $this->xheaders['Subject'] = ilMimeMail::_mimeEncode(strtr($subject,"\r\n"," "));
        }

Here is the call graph for this function:

ilMimeMail::To

(

$to

)

set the mail recipient

Parameters

string

to email address, accept both a single address or an array of addresses

Definition at line 179 of file class.ilMimeMail.php.

References CheckAdresses().

        {

                // TODO : test validit� sur to
                if( is_array( $to ) )
                        $this->sendto= $to;
                else 
                        $this->sendto[] = $to;

                if( $this->checkAddress == true )
                        $this->CheckAdresses( $this->sendto );

        }

Here is the call graph for this function:

ilMimeMail::ValidEmail

(

$address

)

check an email address validity public

Parameters

string

address : email address to check

Returns

boolean true if email adress is ok

Definition at line 401 of file class.ilMimeMail.php.

Referenced by CheckAdresses().

        {
                if( ereg( ".*<(.+)>", $address, $regs ) ) {
                        $address = $regs[1];
                }
                if(ereg( "^[^@  ]+@([a-zA-Z0-9\-]+\.)+([a-zA-Z0-9\-]{2}|net|com|gov|mil|org|edu|int)\$",$address) ) 
                        return true;
                else
                        return false;
        }

Here is the caller graph for this function:

Field Documentation

ilMimeMail::$aattach = array()

Definition at line 69 of file class.ilMimeMail.php.

ilMimeMail::$abcc = array()

Definition at line 63 of file class.ilMimeMail.php.

ilMimeMail::$acc = array()

Definition at line 58 of file class.ilMimeMail.php.

ilMimeMail::$charset = "utf-8"

Definition at line 87 of file class.ilMimeMail.php.

Referenced by Body().

ilMimeMail::$ctencoding = "8bit"

Definition at line 88 of file class.ilMimeMail.php.

Referenced by BuildMail().

ilMimeMail::$priorities = array( '1 (Highest)', '2 (High)', '3 (Normal)', '4 (Low)', '5 (Lowest)' )

Definition at line 81 of file class.ilMimeMail.php.

ilMimeMail::$receipt = 0

Definition at line 89 of file class.ilMimeMail.php.

ilMimeMail::$sendto = array()

Definition at line 53 of file class.ilMimeMail.php.

ilMimeMail::$xheaders = array()

Definition at line 75 of file class.ilMimeMail.php.

---

The documentation for this class was generated from the following file:

• Services/Mail/classes/class.ilMimeMail.php