class.ilMimeMail.php

Go to the documentation of this file.

<?php
/*
        +-----------------------------------------------------------------------------+
        | ILIAS open source                                                           |
        +-----------------------------------------------------------------------------+
        | Copyright (c) 1998-2001 ILIAS open source, University of Cologne            |
        |                                                                             |
        | This program is free software; you can redistribute it and/or               |
        | modify it under the terms of the GNU General Public License                 |
        | as published by the Free Software Foundation; either version 2              |
        | of the License, or (at your option) any later version.                      |
        |                                                                             |
        | This program is distributed in the hope that it will be useful,             |
        | but WITHOUT ANY WARRANTY; without even the implied warranty of              |
        | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the               |
        | GNU General Public License for more details.                                |
        |                                                                             |
        | You should have received a copy of the GNU General Public License           |
        | along with this program; if not, write to the Free Software                 |
        | Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA  02111-1307, USA. |
        +-----------------------------------------------------------------------------+
*/


class ilMimeMail
{
        var $sendto = array();
        
        var $acc = array();

        var $abcc = array();

        var $aattach = array();

        var $xheaders = array();

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

        var $charset = "utf-8";
        var $ctencoding = "8bit";
        var $receipt = 0;
        

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


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


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


        function From($from )
        {

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

        function ReplyTo( $address )
        {

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


        function Receipt()
        {
                $this->receipt = 1;
        }


        function To( $to )
        {

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

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

        }


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



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

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


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


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


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

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


        function Attach( $filename, $filetype = "", $disposition = "inline" )
        {
                // 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;
        }

        function BuildMail()
        {

                // 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";
                }
        

        }

        function Send()
        {
                #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);
        }



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


        function ValidEmail($address)
        {
                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;
        }


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


        function _build_attachement()
        {

                $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);
        }

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

                return $encoded;
        }

} // class Mail
?>