Forums
C
C++
PHP
Perl
Python
Javascript
Advertisement
Browse Code
C
C++
PHP
PERL
PYTHON
JAVASCRIPT
Links
The Code Project
Developer.com
Site Point
Blue Parrot
Game Dev
 PHP Mail Class
2003-06-06 01:08:55
Category: php:internet
Description: A class to send html code, plain text and attachments to an email address using MIME. You can attach as many files as you want and modify the headers.
Author: detour
Viewed: 13576
Rating: (45 votes)


 
Have a question or comment about this code? Post here.
This example has multiple files, click here to download. 
#!/usr/bin/php -q
<?php
/* mshell_mail class by detour@metalshell.com
 *
 * This is an example on how to use the mshell_mail class
 * included with this project.  Basically makes attaching
 * files, and sending messages painless.
 *
 * Functions:
 *  # get_body() - returns the current message body.
 *  # get_header() - returns the current header.
 *  # set_header($name, $value) - alter the value of a header tag or add a 
 *    new header tag. ie $Mail->set_header("CC", "Carbon Copy <carbon@copy.com>");
 *  # attachfile($file, $type) - add a file attachment to the message.  The
 *    default type is "application/octetstream".
 *  # bodytext($text) - add a plain text entry to the email.
 *  # htmltext($text) - add an html entry to the message.
 *  # clear_bodytext() - remove the plain text entry.
 *  # clear_htmltext() - remove the html text enry.
 *  # get_error() - retrieve any error messages.
 *  # sendmail($to, $subject) - Give the headers and body to your default mail
 *    program, usually sendmail.  Make sure your settings in php.ini have
 *    the correct sendmail location.
 *
 *  http://www.metalshell.com/
 */
 
include('mshell_mail.php');
 
$to = "someones@email.com";
$from = "John Doe <return@email.com>";
$file = "file_to_attach.ext";
 
// Create an instance of the mshell_mail class.
$Mail = new mshell_mail();
 
// You can modify predefined headers or set new ones
$Mail->set_header("From", $from);
 
// Send a plain text message.
$Mail->bodytext("Hello\n\nThis is a plain text message.\n-bye");
$Mail->sendmail($to, "Plain Text Message");
 
// Send an html message.
$Mail->clear_bodytext();
$Mail->htmltext("<html><body text=\"#FF0000\">" . 
                "<H1>Html Message</H1></body></html>");
$Mail->sendmail($to, "Html Message");
 
// Send a plain text with an attachment.
$Mail->clear_htmltext();
$Mail->bodytext("Plain text message with an attached file.");
// You may attach as many files as you want.
if(!$Mail->attachfile($file))
  print $Mail->get_error();
$Mail->sendmail($to, "Plain Text with Attachment");
 
?>
<?php
 
class mshell_mail {
  var $errstr;
  var $headers;
  var $textbody;
  var $htmlbody;
  var $attachments;
  var $boundary;
 
  // Default constructor, sets up default header and boundary.
  function mshell_mail() {
    $this->attachments = array();
    $this->boundary = '_mshell_mail_boundary_';
    $this->headers = array(
         'From' => 'Metalshell Mail Class <default@mshell_mail.com>',
         'MIME-Version' => '1.0',
         'Content-Type' => "multipart/mixed; boundary=\"$this->boundary\""
    );
 
    $this->bodytext("Default Mail Message.");
  }
 
  // For debugging purposes you can display the body you are about
  // to send.
  function get_body() {
    $retval = $textbody;
    $retval .= $htmlbody;
    foreach($this->attachments as $tblck)
      $retval .= $tblck;
 
    return $retval;
  }
 
  // Convert the values in the header array into the correct format.
  function get_header() {
    $retval = "";
    foreach($this->headers as $key => $value)
      $retval .= "$key: $value\n";
 
    return $retval;
  }
 
  // Add your own header entry or modify a header.
  function set_header($name, $value) {
    $this->headers[$name] = $value;
  }
 
  // Attach a file to the message.
  function attachfile($file, $type = "application/octetstream")  {
    if(!($fd = fopen($file, "r"))) {
      $this->errstr = "Error opening $file for reading.";
      return 0;
    }
    $_buf = fread($fd, filesize($file));
    fclose($fd);
 
    $fname = $file;
    for($x = strlen($file); $x > 0; $x--)
      if($file[$x] == "/")
        $fname = substr($file, $x, strlen($file) - $x);
 
    // Convert to base64 becuase mail attachments are not binary safe.
    $_buf = chunk_split(base64_encode($_buf));
 
    $this->attachments[$file] = "\n--" . $this->boundary . "\n";
    $this->attachments[$file] .= "Content-Type: $type; name=\"$fname\"\n";
    $this->attachments[$file] .= "Content-Transfer-Encoding: base64\n";
    $this->attachments[$file] .= "Content-Disposition: attachment; " .
                                     "filename=\"$fname\"\n\n";
    $this->attachments[$file] .= $_buf;
 
    return 1;
  }
 
  function bodytext($text) {
    // Set the content type to text/plain for the text message.
    // 7bit encoding is simple ASCII characters, this is default.
    $this->textbody = "\n--" . $this->boundary . "\n";
    $this->textbody .= "Content-Type: text/plain\n";
    $this->textbody .= "Content-Transfer-Encoding: 7bit\n\n";
    $this->textbody .= $text;
  }
 
  function htmltext($text) {
    // Set the content type to text/html for the html message.
    // Also uses 7bit encoding.
    $this->htmlbody = "\n--" . $this->boundary . "\n";
    $this->htmlbody .= "Content-Type: text/html\n";
    $this->htmlbody .= "Content-Transfer-Encoding: 7bit\n\n";
    $this->htmlbody .= $text;
  }
 
  function clear_bodytext() { $this->textbody = ""; }
  function clear_htmltext() { $this->htmlbody = ""; }
  function get_error() { return $this->errstr; }
 
  // Send the headers and body using php's built in mail.
  function sendmail($to = "root@localhost", $subject = "Default Subject") {
    if(isset($this->textbody)) $_body .= $this->textbody;
    if(isset($this->htmlbody)) $_body .= $this->htmlbody;
 
    foreach($this->attachments as $tblck)
      $_body .= $tblck;
 
    $_body .= "\n--$this->boundary--";
 
    mail($to, $subject, $_body, $this->get_header());
  }
}
?>