[Summary view] [Print] [Text view]

   1  <?php
   2  /*~ class.smtp.php
   3  .---------------------------------------------------------------------------.
   4  |  Software: PHPMailer - PHP email class                                    |
   5  |   Version: 5.1                                                            |
   6  |   Contact: via sourceforge.net support pages (also www.codeworxtech.com)  |
   7  |      Info: http://phpmailer.sourceforge.net                               |
   8  |   Support: http://sourceforge.net/projects/phpmailer/                     |
   9  | ------------------------------------------------------------------------- |
  10  |     Admin: Andy Prevost (project admininistrator)                         |
  11  |   Authors: Andy Prevost (codeworxtech) codeworxtech@users.sourceforge.net |
  12  |          : Marcus Bointon (coolbru) coolbru@users.sourceforge.net         |
  13  |   Founder: Brent R. Matzelle (original founder)                           |
  14  | Copyright (c) 2004-2009, Andy Prevost. All Rights Reserved.               |
  15  | Copyright (c) 2001-2003, Brent R. Matzelle                                |
  16  | ------------------------------------------------------------------------- |
  17  |   License: Distributed under the Lesser General Public License (LGPL)     |
  18  |            http://www.gnu.org/copyleft/lesser.html                        |
  19  | This program is distributed in the hope that it will be useful - WITHOUT  |
  20  | ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or     |
  21  | FITNESS FOR A PARTICULAR PURPOSE.                                         |
  22  | ------------------------------------------------------------------------- |
  23  | We offer a number of paid services (www.codeworxtech.com):                |
  24  | - Web Hosting on highly optimized fast and secure servers                 |
  25  | - Technology Consulting                                                   |
  26  | - Oursourcing (highly qualified programmers and graphic designers)        |
  27  '---------------------------------------------------------------------------'
  28  */
  29  
  30  /**
  31   * PHPMailer - PHP SMTP email transport class
  32   * NOTE: Designed for use with PHP version 5 and up
  33   * @package PHPMailer
  34   * @author Andy Prevost
  35   * @author Marcus Bointon
  36   * @copyright 2004 - 2008 Andy Prevost
  37   * @license http://www.gnu.org/copyleft/lesser.html Distributed under the Lesser General Public License (LGPL)
  38   * @version $Id: class.smtp.php 444 2009-05-05 11:22:26Z coolbru $
  39   */
  40  
  41  /**
  42   * SMTP is rfc 821 compliant and implements all the rfc 821 SMTP
  43   * commands except TURN which will always return a not implemented
  44   * error. SMTP also provides some utility methods for sending mail
  45   * to an SMTP server.
  46   * original author: Chris Ryan
  47   */
  48  
  49  class SMTP {
  50    /**
  51     *  SMTP server port
  52     *  @var int
  53     */
  54    public $SMTP_PORT = 25;
  55  
  56    /**
  57     *  SMTP reply line ending
  58     *  @var string
  59     */
  60    public $CRLF = "\r\n";
  61  
  62    /**
  63     *  Sets whether debugging is turned on
  64     *  @var bool
  65     */
  66    public $do_debug;       // the level of debug to perform
  67  
  68    /**
  69     *  Sets VERP use on/off (default is off)
  70     *  @var bool
  71     */
  72    public $do_verp = false;
  73  
  74    /////////////////////////////////////////////////
  75    // PROPERTIES, PRIVATE AND PROTECTED
  76    /////////////////////////////////////////////////
  77  
  78    private $smtp_conn; // the socket to the server
  79    private $error;     // error if any on the last call
  80    private $helo_rply; // the reply the server sent to us for HELO
  81  
  82    /**
  83     * Initialize the class so that the data is in a known state.
  84     * @access public
  85     * @return void
  86     */
  87    public function __construct() {
  88      $this->smtp_conn = 0;
  89      $this->error = null;
  90      $this->helo_rply = null;
  91  
  92      $this->do_debug = 0;
  93    }
  94  
  95    /////////////////////////////////////////////////
  96    // CONNECTION FUNCTIONS
  97    /////////////////////////////////////////////////
  98  
  99    /**
 100     * Connect to the server specified on the port specified.
 101     * If the port is not specified use the default SMTP_PORT.
 102     * If tval is specified then a connection will try and be
 103     * established with the server for that number of seconds.
 104     * If tval is not specified the default is 30 seconds to
 105     * try on the connection.
 106     *
 107     * SMTP CODE SUCCESS: 220
 108     * SMTP CODE FAILURE: 421
 109     * @access public
 110     * @return bool
 111     */
 112    public function Connect($host, $port = 0, $tval = 30) {
 113      // set the error val to null so there is no confusion
 114      $this->error = null;
 115  
 116      // make sure we are __not__ connected
 117      if($this->connected()) {
 118        // already connected, generate error
 119        $this->error = array("error" => "Already connected to a server");
 120        return false;
 121      }
 122  
 123      if(empty($port)) {
 124        $port = $this->SMTP_PORT;
 125      }
 126  
 127      // connect to the smtp server
 128      $this->smtp_conn = @fsockopen($host,    // the host of the server
 129                                   $port,    // the port to use
 130                                   $errno,   // error number if any
 131                                   $errstr,  // error message if any
 132                                   $tval);   // give up after ? secs
 133      // verify we connected properly
 134      if(empty($this->smtp_conn)) {
 135        $this->error = array("error" => "Failed to connect to server",
 136                             "errno" => $errno,
 137                             "errstr" => $errstr);
 138        if($this->do_debug >= 1) {
 139          echo "SMTP -> ERROR: " . $this->error["error"] . ": $errstr ($errno)" . $this->CRLF . '<br />';
 140        }
 141        return false;
 142      }
 143  
 144      // SMTP server can take longer to respond, give longer timeout for first read
 145      // Windows does not have support for this timeout function
 146      if(substr(PHP_OS, 0, 3) != "WIN")
 147       socket_set_timeout($this->smtp_conn, $tval, 0);
 148  
 149      // get any announcement
 150      $announce = $this->get_lines();
 151  
 152      if($this->do_debug >= 2) {
 153        echo "SMTP -> FROM SERVER:" . $announce . $this->CRLF . '<br />';
 154      }
 155  
 156      return true;
 157    }
 158  
 159    /**
 160     * Initiate a TLS communication with the server.
 161     *
 162     * SMTP CODE 220 Ready to start TLS
 163     * SMTP CODE 501 Syntax error (no parameters allowed)
 164     * SMTP CODE 454 TLS not available due to temporary reason
 165     * @access public
 166     * @return bool success
 167     */
 168    public function StartTLS() {
 169      $this->error = null; # to avoid confusion
 170  
 171      if(!$this->connected()) {
 172        $this->error = array("error" => "Called StartTLS() without being connected");
 173        return false;
 174      }
 175  
 176      fputs($this->smtp_conn,"STARTTLS" . $this->CRLF);
 177  
 178      $rply = $this->get_lines();
 179      $code = substr($rply,0,3);
 180  
 181      if($this->do_debug >= 2) {
 182        echo "SMTP -> FROM SERVER:" . $rply . $this->CRLF . '<br />';
 183      }
 184  
 185      if($code != 220) {
 186        $this->error =
 187           array("error"     => "STARTTLS not accepted from server",
 188                 "smtp_code" => $code,
 189                 "smtp_msg"  => substr($rply,4));
 190        if($this->do_debug >= 1) {
 191          echo "SMTP -> ERROR: " . $this->error["error"] . ": " . $rply . $this->CRLF . '<br />';
 192        }
 193        return false;
 194      }
 195  
 196      // Begin encrypted connection
 197      if(!stream_socket_enable_crypto($this->smtp_conn, true, STREAM_CRYPTO_METHOD_TLS_CLIENT)) {
 198        return false;
 199      }
 200  
 201      return true;
 202    }
 203  
 204    /**
 205     * Performs SMTP authentication.  Must be run after running the
 206     * Hello() method.  Returns true if successfully authenticated.
 207     * @access public
 208     * @return bool
 209     */
 210    public function Authenticate($username, $password) {
 211      // Start authentication
 212      fputs($this->smtp_conn,"AUTH LOGIN" . $this->CRLF);
 213  
 214      $rply = $this->get_lines();
 215      $code = substr($rply,0,3);
 216  
 217      if($code != 334) {
 218        $this->error =
 219          array("error" => "AUTH not accepted from server",
 220                "smtp_code" => $code,
 221                "smtp_msg" => substr($rply,4));
 222        if($this->do_debug >= 1) {
 223          echo "SMTP -> ERROR: " . $this->error["error"] . ": " . $rply . $this->CRLF . '<br />';
 224        }
 225        return false;
 226      }
 227  
 228      // Send encoded username
 229      fputs($this->smtp_conn, base64_encode($username) . $this->CRLF);
 230  
 231      $rply = $this->get_lines();
 232      $code = substr($rply,0,3);
 233  
 234      if($code != 334) {
 235        $this->error =
 236          array("error" => "Username not accepted from server",
 237                "smtp_code" => $code,
 238                "smtp_msg" => substr($rply,4));
 239        if($this->do_debug >= 1) {
 240          echo "SMTP -> ERROR: " . $this->error["error"] . ": " . $rply . $this->CRLF . '<br />';
 241        }
 242        return false;
 243      }
 244  
 245      // Send encoded password
 246      fputs($this->smtp_conn, base64_encode($password) . $this->CRLF);
 247  
 248      $rply = $this->get_lines();
 249      $code = substr($rply,0,3);
 250  
 251      if($code != 235) {
 252        $this->error =
 253          array("error" => "Password not accepted from server",
 254                "smtp_code" => $code,
 255                "smtp_msg" => substr($rply,4));
 256        if($this->do_debug >= 1) {
 257          echo "SMTP -> ERROR: " . $this->error["error"] . ": " . $rply . $this->CRLF . '<br />';
 258        }
 259        return false;
 260      }
 261  
 262      return true;
 263    }
 264  
 265    /**
 266     * Returns true if connected to a server otherwise false
 267     * @access public
 268     * @return bool
 269     */
 270    public function Connected() {
 271      if(!empty($this->smtp_conn)) {
 272        $sock_status = socket_get_status($this->smtp_conn);
 273        if($sock_status["eof"]) {
 274          // the socket is valid but we are not connected
 275          if($this->do_debug >= 1) {
 276              echo "SMTP -> NOTICE:" . $this->CRLF . "EOF caught while checking if connected";
 277          }
 278          $this->Close();
 279          return false;
 280        }
 281        return true; // everything looks good
 282      }
 283      return false;
 284    }
 285  
 286    /**
 287     * Closes the socket and cleans up the state of the class.
 288     * It is not considered good to use this function without
 289     * first trying to use QUIT.
 290     * @access public
 291     * @return void
 292     */
 293    public function Close() {
 294      $this->error = null; // so there is no confusion
 295      $this->helo_rply = null;
 296      if(!empty($this->smtp_conn)) {
 297        // close the connection and cleanup
 298        fclose($this->smtp_conn);
 299        $this->smtp_conn = 0;
 300      }
 301    }
 302  
 303    /////////////////////////////////////////////////
 304    // SMTP COMMANDS
 305    /////////////////////////////////////////////////
 306  
 307    /**
 308     * Issues a data command and sends the msg_data to the server
 309     * finializing the mail transaction. $msg_data is the message
 310     * that is to be send with the headers. Each header needs to be
 311     * on a single line followed by a <CRLF> with the message headers
 312     * and the message body being seperated by and additional <CRLF>.
 313     *
 314     * Implements rfc 821: DATA <CRLF>
 315     *
 316     * SMTP CODE INTERMEDIATE: 354
 317     *     [data]
 318     *     <CRLF>.<CRLF>
 319     *     SMTP CODE SUCCESS: 250
 320     *     SMTP CODE FAILURE: 552,554,451,452
 321     * SMTP CODE FAILURE: 451,554
 322     * SMTP CODE ERROR  : 500,501,503,421
 323     * @access public
 324     * @return bool
 325     */
 326    public function Data($msg_data) {
 327      $this->error = null; // so no confusion is caused
 328  
 329      if(!$this->connected()) {
 330        $this->error = array(
 331                "error" => "Called Data() without being connected");
 332        return false;
 333      }
 334  
 335      fputs($this->smtp_conn,"DATA" . $this->CRLF);
 336  
 337      $rply = $this->get_lines();
 338      $code = substr($rply,0,3);
 339  
 340      if($this->do_debug >= 2) {
 341        echo "SMTP -> FROM SERVER:" . $rply . $this->CRLF . '<br />';
 342      }
 343  
 344      if($code != 354) {
 345        $this->error =
 346          array("error" => "DATA command not accepted from server",
 347                "smtp_code" => $code,
 348                "smtp_msg" => substr($rply,4));
 349        if($this->do_debug >= 1) {
 350          echo "SMTP -> ERROR: " . $this->error["error"] . ": " . $rply . $this->CRLF . '<br />';
 351        }
 352        return false;
 353      }
 354  
 355      /* the server is ready to accept data!
 356       * according to rfc 821 we should not send more than 1000
 357       * including the CRLF
 358       * characters on a single line so we will break the data up
 359       * into lines by \r and/or \n then if needed we will break
 360       * each of those into smaller lines to fit within the limit.
 361       * in addition we will be looking for lines that start with
 362       * a period '.' and append and additional period '.' to that
 363       * line. NOTE: this does not count towards limit.
 364       */
 365  
 366      // normalize the line breaks so we know the explode works
 367      $msg_data = str_replace("\r\n","\n",$msg_data);
 368      $msg_data = str_replace("\r","\n",$msg_data);
 369      $lines = explode("\n",$msg_data);
 370  
 371      /* we need to find a good way to determine is headers are
 372       * in the msg_data or if it is a straight msg body
 373       * currently I am assuming rfc 822 definitions of msg headers
 374       * and if the first field of the first line (':' sperated)
 375       * does not contain a space then it _should_ be a header
 376       * and we can process all lines before a blank "" line as
 377       * headers.
 378       */
 379  
 380      $field = substr($lines[0],0,strpos($lines[0],":"));
 381      $in_headers = false;
 382      if(!empty($field) && !strstr($field," ")) {
 383        $in_headers = true;
 384      }
 385  
 386      $max_line_length = 998; // used below; set here for ease in change
 387  
 388      while(list(,$line) = @each($lines)) {
 389        $lines_out = null;
 390        if($line == "" && $in_headers) {
 391          $in_headers = false;
 392        }
 393        // ok we need to break this line up into several smaller lines
 394        while(strlen($line) > $max_line_length) {
 395          $pos = strrpos(substr($line,0,$max_line_length)," ");
 396  
 397          // Patch to fix DOS attack
 398          if(!$pos) {
 399            $pos = $max_line_length - 1;
 400            $lines_out[] = substr($line,0,$pos);
 401            $line = substr($line,$pos);
 402          } else {
 403            $lines_out[] = substr($line,0,$pos);
 404            $line = substr($line,$pos + 1);
 405          }
 406  
 407          /* if processing headers add a LWSP-char to the front of new line
 408           * rfc 822 on long msg headers
 409           */
 410          if($in_headers) {
 411            $line = "\t" . $line;
 412          }
 413        }
 414        $lines_out[] = $line;
 415  
 416        // send the lines to the server
 417        while(list(,$line_out) = @each($lines_out)) {
 418          if(strlen($line_out) > 0)
 419          {
 420            if(substr($line_out, 0, 1) == ".") {
 421              $line_out = "." . $line_out;
 422            }
 423          }
 424          fputs($this->smtp_conn,$line_out . $this->CRLF);
 425        }
 426      }
 427  
 428      // message data has been sent
 429      fputs($this->smtp_conn, $this->CRLF . "." . $this->CRLF);
 430  
 431      $rply = $this->get_lines();
 432      $code = substr($rply,0,3);
 433  
 434      if($this->do_debug >= 2) {
 435        echo "SMTP -> FROM SERVER:" . $rply . $this->CRLF . '<br />';
 436      }
 437  
 438      if($code != 250) {
 439        $this->error =
 440          array("error" => "DATA not accepted from server",
 441                "smtp_code" => $code,
 442                "smtp_msg" => substr($rply,4));
 443        if($this->do_debug >= 1) {
 444          echo "SMTP -> ERROR: " . $this->error["error"] . ": " . $rply . $this->CRLF . '<br />';
 445        }
 446        return false;
 447      }
 448      return true;
 449    }
 450  
 451    /**
 452     * Sends the HELO command to the smtp server.
 453     * This makes sure that we and the server are in
 454     * the same known state.
 455     *
 456     * Implements from rfc 821: HELO <SP> <domain> <CRLF>
 457     *
 458     * SMTP CODE SUCCESS: 250
 459     * SMTP CODE ERROR  : 500, 501, 504, 421
 460     * @access public
 461     * @return bool
 462     */
 463    public function Hello($host = '') {
 464      $this->error = null; // so no confusion is caused
 465  
 466      if(!$this->connected()) {
 467        $this->error = array(
 468              "error" => "Called Hello() without being connected");
 469        return false;
 470      }
 471  
 472      // if hostname for HELO was not specified send default
 473      if(empty($host)) {
 474        // determine appropriate default to send to server
 475        $host = "localhost";
 476      }
 477  
 478      // Send extended hello first (RFC 2821)
 479      if(!$this->SendHello("EHLO", $host)) {
 480        if(!$this->SendHello("HELO", $host)) {
 481          return false;
 482        }
 483      }
 484  
 485      return true;
 486    }
 487  
 488    /**
 489     * Sends a HELO/EHLO command.
 490     * @access private
 491     * @return bool
 492     */
 493    private function SendHello($hello, $host) {
 494      fputs($this->smtp_conn, $hello . " " . $host . $this->CRLF);
 495  
 496      $rply = $this->get_lines();
 497      $code = substr($rply,0,3);
 498  
 499      if($this->do_debug >= 2) {
 500        echo "SMTP -> FROM SERVER: " . $rply . $this->CRLF . '<br />';
 501      }
 502  
 503      if($code != 250) {
 504        $this->error =
 505          array("error" => $hello . " not accepted from server",
 506                "smtp_code" => $code,
 507                "smtp_msg" => substr($rply,4));
 508        if($this->do_debug >= 1) {
 509          echo "SMTP -> ERROR: " . $this->error["error"] . ": " . $rply . $this->CRLF . '<br />';
 510        }
 511        return false;
 512      }
 513  
 514      $this->helo_rply = $rply;
 515  
 516      return true;
 517    }
 518  
 519    /**
 520     * Starts a mail transaction from the email address specified in
 521     * $from. Returns true if successful or false otherwise. If True
 522     * the mail transaction is started and then one or more Recipient
 523     * commands may be called followed by a Data command.
 524     *
 525     * Implements rfc 821: MAIL <SP> FROM:<reverse-path> <CRLF>
 526     *
 527     * SMTP CODE SUCCESS: 250
 528     * SMTP CODE SUCCESS: 552,451,452
 529     * SMTP CODE SUCCESS: 500,501,421
 530     * @access public
 531     * @return bool
 532     */
 533    public function Mail($from) {
 534      $this->error = null; // so no confusion is caused
 535  
 536      if(!$this->connected()) {
 537        $this->error = array(
 538                "error" => "Called Mail() without being connected");
 539        return false;
 540      }
 541  
 542      $useVerp = ($this->do_verp ? "XVERP" : "");
 543      fputs($this->smtp_conn,"MAIL FROM:<" . $from . ">" . $useVerp . $this->CRLF);
 544  
 545      $rply = $this->get_lines();
 546      $code = substr($rply,0,3);
 547  
 548      if($this->do_debug >= 2) {
 549        echo "SMTP -> FROM SERVER:" . $rply . $this->CRLF . '<br />';
 550      }
 551  
 552      if($code != 250) {
 553        $this->error =
 554          array("error" => "MAIL not accepted from server",
 555                "smtp_code" => $code,
 556                "smtp_msg" => substr($rply,4));
 557        if($this->do_debug >= 1) {
 558          echo "SMTP -> ERROR: " . $this->error["error"] . ": " . $rply . $this->CRLF . '<br />';
 559        }
 560        return false;
 561      }
 562      return true;
 563    }
 564  
 565    /**
 566     * Sends the quit command to the server and then closes the socket
 567     * if there is no error or the $close_on_error argument is true.
 568     *
 569     * Implements from rfc 821: QUIT <CRLF>
 570     *
 571     * SMTP CODE SUCCESS: 221
 572     * SMTP CODE ERROR  : 500
 573     * @access public
 574     * @return bool
 575     */
 576    public function Quit($close_on_error = true) {
 577      $this->error = null; // so there is no confusion
 578  
 579      if(!$this->connected()) {
 580        $this->error = array(
 581                "error" => "Called Quit() without being connected");
 582        return false;
 583      }
 584  
 585      // send the quit command to the server
 586      fputs($this->smtp_conn,"quit" . $this->CRLF);
 587  
 588      // get any good-bye messages
 589      $byemsg = $this->get_lines();
 590  
 591      if($this->do_debug >= 2) {
 592        echo "SMTP -> FROM SERVER:" . $byemsg . $this->CRLF . '<br />';
 593      }
 594  
 595      $rval = true;
 596      $e = null;
 597  
 598      $code = substr($byemsg,0,3);
 599      if($code != 221) {
 600        // use e as a tmp var cause Close will overwrite $this->error
 601        $e = array("error" => "SMTP server rejected quit command",
 602                   "smtp_code" => $code,
 603                   "smtp_rply" => substr($byemsg,4));
 604        $rval = false;
 605        if($this->do_debug >= 1) {
 606          echo "SMTP -> ERROR: " . $e["error"] . ": " . $byemsg . $this->CRLF . '<br />';
 607        }
 608      }
 609  
 610      if(empty($e) || $close_on_error) {
 611        $this->Close();
 612      }
 613  
 614      return $rval;
 615    }
 616  
 617    /**
 618     * Sends the command RCPT to the SMTP server with the TO: argument of $to.
 619     * Returns true if the recipient was accepted false if it was rejected.
 620     *
 621     * Implements from rfc 821: RCPT <SP> TO:<forward-path> <CRLF>
 622     *
 623     * SMTP CODE SUCCESS: 250,251
 624     * SMTP CODE FAILURE: 550,551,552,553,450,451,452
 625     * SMTP CODE ERROR  : 500,501,503,421
 626     * @access public
 627     * @return bool
 628     */
 629    public function Recipient($to) {
 630      $this->error = null; // so no confusion is caused
 631  
 632      if(!$this->connected()) {
 633        $this->error = array(
 634                "error" => "Called Recipient() without being connected");
 635        return false;
 636      }
 637  
 638      fputs($this->smtp_conn,"RCPT TO:<" . $to . ">" . $this->CRLF);
 639  
 640      $rply = $this->get_lines();
 641      $code = substr($rply,0,3);
 642  
 643      if($this->do_debug >= 2) {
 644        echo "SMTP -> FROM SERVER:" . $rply . $this->CRLF . '<br />';
 645      }
 646  
 647      if($code != 250 && $code != 251) {
 648        $this->error =
 649          array("error" => "RCPT not accepted from server",
 650                "smtp_code" => $code,
 651                "smtp_msg" => substr($rply,4));
 652        if($this->do_debug >= 1) {
 653          echo "SMTP -> ERROR: " . $this->error["error"] . ": " . $rply . $this->CRLF . '<br />';
 654        }
 655        return false;
 656      }
 657      return true;
 658    }
 659  
 660    /**
 661     * Sends the RSET command to abort and transaction that is
 662     * currently in progress. Returns true if successful false
 663     * otherwise.
 664     *
 665     * Implements rfc 821: RSET <CRLF>
 666     *
 667     * SMTP CODE SUCCESS: 250
 668     * SMTP CODE ERROR  : 500,501,504,421
 669     * @access public
 670     * @return bool
 671     */
 672    public function Reset() {
 673      $this->error = null; // so no confusion is caused
 674  
 675      if(!$this->connected()) {
 676        $this->error = array(
 677                "error" => "Called Reset() without being connected");
 678        return false;
 679      }
 680  
 681      fputs($this->smtp_conn,"RSET" . $this->CRLF);
 682  
 683      $rply = $this->get_lines();
 684      $code = substr($rply,0,3);
 685  
 686      if($this->do_debug >= 2) {
 687        echo "SMTP -> FROM SERVER:" . $rply . $this->CRLF . '<br />';
 688      }
 689  
 690      if($code != 250) {
 691        $this->error =
 692          array("error" => "RSET failed",
 693                "smtp_code" => $code,
 694                "smtp_msg" => substr($rply,4));
 695        if($this->do_debug >= 1) {
 696          echo "SMTP -> ERROR: " . $this->error["error"] . ": " . $rply . $this->CRLF . '<br />';
 697        }
 698        return false;
 699      }
 700  
 701      return true;
 702    }
 703  
 704    /**
 705     * Starts a mail transaction from the email address specified in
 706     * $from. Returns true if successful or false otherwise. If True
 707     * the mail transaction is started and then one or more Recipient
 708     * commands may be called followed by a Data command. This command
 709     * will send the message to the users terminal if they are logged
 710     * in and send them an email.
 711     *
 712     * Implements rfc 821: SAML <SP> FROM:<reverse-path> <CRLF>
 713     *
 714     * SMTP CODE SUCCESS: 250
 715     * SMTP CODE SUCCESS: 552,451,452
 716     * SMTP CODE SUCCESS: 500,501,502,421
 717     * @access public
 718     * @return bool
 719     */
 720    public function SendAndMail($from) {
 721      $this->error = null; // so no confusion is caused
 722  
 723      if(!$this->connected()) {
 724        $this->error = array(
 725            "error" => "Called SendAndMail() without being connected");
 726        return false;
 727      }
 728  
 729      fputs($this->smtp_conn,"SAML FROM:" . $from . $this->CRLF);
 730  
 731      $rply = $this->get_lines();
 732      $code = substr($rply,0,3);
 733  
 734      if($this->do_debug >= 2) {
 735        echo "SMTP -> FROM SERVER:" . $rply . $this->CRLF . '<br />';
 736      }
 737  
 738      if($code != 250) {
 739        $this->error =
 740          array("error" => "SAML not accepted from server",
 741                "smtp_code" => $code,
 742                "smtp_msg" => substr($rply,4));
 743        if($this->do_debug >= 1) {
 744          echo "SMTP -> ERROR: " . $this->error["error"] . ": " . $rply . $this->CRLF . '<br />';
 745        }
 746        return false;
 747      }
 748      return true;
 749    }
 750  
 751    /**
 752     * This is an optional command for SMTP that this class does not
 753     * support. This method is here to make the RFC821 Definition
 754     * complete for this class and __may__ be implimented in the future
 755     *
 756     * Implements from rfc 821: TURN <CRLF>
 757     *
 758     * SMTP CODE SUCCESS: 250
 759     * SMTP CODE FAILURE: 502
 760     * SMTP CODE ERROR  : 500, 503
 761     * @access public
 762     * @return bool
 763     */
 764    public function Turn() {
 765      $this->error = array("error" => "This method, TURN, of the SMTP ".
 766                                      "is not implemented");
 767      if($this->do_debug >= 1) {
 768        echo "SMTP -> NOTICE: " . $this->error["error"] . $this->CRLF . '<br />';
 769      }
 770      return false;
 771    }
 772  
 773    /**
 774    * Get the current error
 775    * @access public
 776    * @return array
 777    */
 778    public function getError() {
 779      return $this->error;
 780    }
 781  
 782    /////////////////////////////////////////////////
 783    // INTERNAL FUNCTIONS
 784    /////////////////////////////////////////////////
 785  
 786    /**
 787     * Read in as many lines as possible
 788     * either before eof or socket timeout occurs on the operation.
 789     * With SMTP we can tell if we have more lines to read if the
 790     * 4th character is '-' symbol. If it is a space then we don't
 791     * need to read anything else.
 792     * @access private
 793     * @return string
 794     */
 795    private function get_lines() {
 796      $data = "";
 797      while($str = @fgets($this->smtp_conn,515)) {
 798        if($this->do_debug >= 4) {
 799          echo "SMTP -> get_lines(): \$data was \"$data\"" . $this->CRLF . '<br />';
 800          echo "SMTP -> get_lines(): \$str is \"$str\"" . $this->CRLF . '<br />';
 801        }
 802        $data .= $str;
 803        if($this->do_debug >= 4) {
 804          echo "SMTP -> get_lines(): \$data is \"$data\"" . $this->CRLF . '<br />';
 805        }
 806        // if 4th character is a space, we are done reading, break the loop
 807        if(substr($str,3,1) == " ") { break; }
 808      }
 809      return $data;
 810    }
 811  
 812  }
 813  
 814  ?>