File Source for EMail.class.php

<?php
/**
* @package communication
*/
/**
*
*/
include_once CLASSPATH."RegExpConstants.inc.php";
/**
*
*/
require_once CLASSPATH."core/Arrays.class.php";
/**
* This class can be used to create emails of the type text or html. If you
* want you can add attachments.
*
* @package communication
*
* @version 0.1.96
* @author Daniel Plücken <daniel@debakel.net>
* @license http://www.gnu.org/copyleft/lesser.html
* GNU Lesser General Public License
* @copyright Copyright (C) 2005 Daniel Plücken <daniel@debakel.net>
*
* This library is free software; you can redistribute it and/or
* modify it under the terms of the GNU Lesser General Public
* License as published by the Free Software Foundation; either
* version 2.1 of the License.
*
* This library 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 Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General
* Public License along with this library; if not, write to the
* Free Software Foundation, Inc., 59 Temple Place, Suite 330,
* Boston, MA 02111-1307 USA
*/
class EMail
{
/**
* Stores the e-mail address of the recipient.
*
* @var string $target_email
* @access public
*/
var $target_email = "";
/**
* Stores the e-mail address of the recipient on reply.
*
* @var string $reply_email
* @access public
*/
var $reply_email = "";
/**
* Stores the e-mail addresses of the recipients in carbon copy.
*
* @var array $target_email_copy_arr
* @access public
*/
var $target_email_copy_arr = array();
/**
* Stores the e-mail addresses of the recipients in blind carbon copy.
*
* @var array $target_email_blindcopy_arr
* @access public
*/
var $target_email_blindcopy_arr = array();
/**
* Stores the subject of the e-mail.
*
* @var string $subject
* @access public
*/
var $subject = "Contact form";
/**
* Stores the content of the e-mail.
*
* @var string $content
* @access public
*/
var $content = "";
/**
* Stores the type of content of the e-mail. Possible values are
* "text/plain" or "text/html" for plain text e-mail or html e-email.
*
* @var string $content_type
* @access private
*/
var $content_type = "text/plain";
/**
* Stores the filenames of attached files.
*
* @var array $attachment_filename_arr
* @access public
*/
var $attachment_filename_arr = array ();
/**
* Stores the content of the attachments.
*
* @var array $attachment_data_arr
* @access public
*/
var $attachment_data_arr = array ();
/**
* Stores the boundary for attachments.
*
* @var string $str_attachment_boundary
* @access public
*/
var $str_attachment_boundary = "";
/**
* Stores the chars to seperate header information. It is immediatly adviced
* to let it the character "\n", because some email-provider can't handle
* header information separated by "\r\n" correctly!
*
* @var string $str_header_separator
* @access public
*/
var $str_header_separator = "\n";
/**
* Constructor
*
* @version 1.1
* @since 0.1.0
* @author Daniel Plücken <daniel@debakel.net>
* @access public
* @param string $target_email
*/
function EMail( $target_email )
{ $this->target_email = $target_email; }
/**
* Sets the type of content of the e-mail. Possible values are
* "text/plain" or "text/html" for plain text e-mail or html e-email.
*
* @version 1.0
* @since 0.1.6
* @author Daniel Plücken <daniel@debakel.net>
* @access public
* @param $type
* @return void
*/
function setContentType( $type )
{
if ( preg_match( "!html!i", $type ) )
$this->content_type = "text/html";
else
$this->content_type = "text/plain";
}
/**
* Returns whether the given email is valid.
*
* @version 1.0
* @since 0.1.9
* @author Daniel Plücken <daniel@debakel.net>
* @static
* @access public
* @param string $string The email to validate.
* @return boolean
*/
function is_valid( $string )
{ return preg_match( "!^".EMAIL."$!", $string ); }
/**
* Returns whether the given email is valid.
* The function name is a result of my bad english :P - sorry for that!
*
* @deprecated
* @version 1.0
* @since 0.1.2
* @author Daniel Plücken <daniel@debakel.net>
* @static
* @access public
* @param string $string The email to validate.
* @return boolean
*/
function is_guilty( $string )
{ return EMail::is_valid( $string ); }
/**
* Returns the stored email.
*
* @version 1.0
* @since 0.1.2
* @author Daniel Plücken <daniel@debakel.net>
* @access public
* @return string
*/
function getTargetEmail()
{ return $this->target_email; }
/**
* Adds an attachment to this email.
*
* @version 1.0
* @since 0.1.2
* @author Daniel Plücken <daniel@debakel.net>
* @access public
* @param string $filename
* @param string $data
* @return void
*/
function addAttachment( $filename, $data )
{
$this->str_attachment_boundary = strtoupper(md5(uniqid(time())));
$this->attachment_filename_arr[] = $filename;
$this->attachment_data_arr[] = chunk_split(base64_encode($data));
}
/**
* Stores the email where the message should be send.
*
* @version 1.1
* @since 0.1.2
* @author Daniel Plücken <daniel@debakel.net>
* @access public
* @param string $string
* @return void
*/
function setTargetEmail( $string )
{ $this->target_email = $string; }
/**
* Stores the email where the message should be send on reply.
*
* @version 1.0
* @since 0.1.8
* @author Daniel Plücken <daniel@debakel.net>
* @access public
* @param string $string
* @return void
*/
function setReplyEmail( $string )
{ $this->reply_email = $string; }
/**
* Adds an email to the array of emails where the message should be send in
* copy.
*
* @version 1.0
* @since 0.1.2
* @author Daniel Plücken <daniel@debakel.net>
* @access public
* @param string $string
* @return void
*/
function addTargetEmailCopy( $string )
{ $this->target_email_copy_arr[] = $string; }
/**
* Stores the emails where the message should be send in copy.
*
* @version 1.0
* @since 0.1.2
* @author Daniel Plücken <daniel@debakel.net>
* @access public
* @param array $array
* @return void
*/
function setTargetEmailCopyArray( $array )
{ $this->target_email_copy_arr = $array; }
/**
* Adds an email to the array of emails where the message should be send in
* blind copy.
*
* @version 1.0
* @since 0.1.2
* @author Daniel Plücken <daniel@debakel.net>
* @access public
* @param string $string
* @return void
*/
function addTargetEmailBlindCopy( $string )
{ $this->target_email_blindcopy_arr[] = $string; }
/**
* Stores the emails where the message should be send in blind copy.
*
* @version 1.0
* @since 0.1.2
* @author Daniel Plücken <daniel@debakel.net>
* @access public
* @param array $array
* @return void
*/
function setTargetEmailBlindCopyArray( $array )
{ $this->target_email_blindcopy_arr = $array; }
/**
* Returns the generated attachment data as header information in mime
* type.
*
* @version 1.0
* @since 0.1.52
* @author Daniel Plücken <daniel@debakel.net>
* @access public
* @return string
*/
function getAttachmentContent()
{
$out = "";
for ( $i = 0; $i < count( $this->attachment_filename_arr ); $i++ )
{
$out .= "--".$this->str_attachment_boundary
.$this->str_header_separator;
$out .= "Content-Type: application/octetstream; "
."name=\"".$this->attachment_filename_arr[$i]."\""
.$this->str_header_separator;
$out .= "Content-Transfer-Encoding: base64"
.$this->str_header_separator;
$out .= "Content-Disposition: attachment; "
."filename=\"".$this->attachment_filename_arr[$i]."\""
.$this->str_header_separator.$this->str_header_separator;
$out .= $this->attachment_data_arr[$i].$this->str_header_separator;
}
return $out;
}
/**
* Sends the email with values of the form to the addressee stored in
* $this->target_email.
*
* @version 1.32
* @since 0.1.2
* @author Daniel Plücken <daniel@debakel.net>
* @access public
* @param string $sender_email
* @param string $subject
* @param string $content
* @return boolean
*/
function send( $sender_email, $subject = "", $content = "" )
{
if( empty( $subject ) )
$subject = $this->subject;
if( empty( $content ) )
$content = $this->content;
/* DEBUG
echo "<pre>";
echo "Header:".
"From: ".$sender_email."\r\n"
."Reply-To: ".$sender_email."\r\n"
.(
!Arrays::is_empty( $this->target_email_copy_arr )
? "Cc: ".implode(
", ", $this->target_email_copy_arr
)."\r\n"
: ""
)
.(
!Arrays::is_empty( $this->target_email_blindcopy_arr )
? "Bcc: ".implode(
", ", $this->target_email_blindcopy_arr
)."\r\n"
: ""
)
.(
count( $this->attachment_filename_arr ) > 0
? "MIME-Version: 1.0\r\n"
."Content-Type: multipart/mixed; boundary="
.$this->str_attachment_boundary."\r\n\r\n"
."--".$this->str_attachment_boundary."\r\n"
."Content-Type: ".$this->content_type."\r\n"
."Content-Transfer-Encoding: 8bit\r\n\r\n"
.$content."\r\n"
.$this->getAttachmentContent()
."--".$this->str_attachment_boundary."--"
: "Content-Type: ".$this->content_type."\r\n"
);
echo "--------------------------------\r\n";
echo "Sender: ".$sender_email."\r\n";
echo "--------------------------------\r\n";
echo "Receiver: ".preg_replace(
"!^.+?\b(".EMAIL.")\b.+?$!i",
"$1", $this->target_email
)."\r\n";
echo "--------------------------------\r\n";
echo "Subject: ".$subject."\r\n";
echo "--------------------------------\r\n";
echo "Content: ".$content."\r\n";
echo "</pre>";
// DEBUG */
return mail(
preg_replace(
"!^.+?\b(".EMAIL.")\b.+?$!i",
"$1", $this->target_email
),
$subject, $content,
"From: ".$sender_email.$this->str_header_separator
."Reply-To: ".(
empty( $this->reply_email )
? $sender_email
: $this->reply_email
).$this->str_header_separator
.(
!Arrays::is_empty( $this->target_email_copy_arr )
? "Cc: ".implode(
", ", $this->target_email_copy_arr
).$this->str_header_separator
: ""
)
.(
!Arrays::is_empty( $this->target_email_blindcopy_arr )
? "Bcc: ".implode(
", ", $this->target_email_blindcopy_arr
).$this->str_header_separator
: ""
)
.(
count( $this->attachment_filename_arr ) > 0
? "MIME-Version: 1.0".$this->str_header_separator
."Content-Type: multipart/mixed; boundary="
.$this->str_attachment_boundary
.$this->str_header_separator
.$this->str_header_separator
."--".$this->str_attachment_boundary
.$this->str_header_separator
."Content-Type: ".$this->content_type
.$this->str_header_separator
."Content-Transfer-Encoding: 8bit"
.$this->str_header_separator.$this->str_header_separator
.$content.$this->str_header_separator
.$this->getAttachmentContent()
."--".$this->str_attachment_boundary."--"
: "Content-Type: ".$this->content_type
.$this->str_header_separator
)
);
}
} // END of class EMail
?>

Source for file EMail.class.php