Projects : mp-wp : mp-wp_genesis
1 | <?php |
2 | /*~ class.smtp.php |
3 | .---------------------------------------------------------------------------. |
4 | | Software: PHPMailer - PHP email class | |
5 | | Version: 2.0.2 | |
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 | | Author: Andy Prevost (project admininistrator) | |
11 | | Author: Brent R. Matzelle (original founder) | |
12 | | Copyright (c) 2004-2007, Andy Prevost. All Rights Reserved. | |
13 | | Copyright (c) 2001-2003, Brent R. Matzelle | |
14 | | ------------------------------------------------------------------------- | |
15 | | License: Distributed under the Lesser General Public License (LGPL) | |
16 | | http://www.gnu.org/copyleft/lesser.html | |
17 | | This program is distributed in the hope that it will be useful - WITHOUT | |
18 | | ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or | |
19 | | FITNESS FOR A PARTICULAR PURPOSE. | |
20 | | ------------------------------------------------------------------------- | |
21 | | We offer a number of paid services (www.codeworxtech.com): | |
22 | | - Web Hosting on highly optimized fast and secure servers | |
23 | | - Technology Consulting | |
24 | | - Oursourcing (highly qualified programmers and graphic designers) | |
25 | '---------------------------------------------------------------------------' |
26 | */ |
27 | /** |
28 | * SMTP is rfc 821 compliant and implements all the rfc 821 SMTP |
29 | * commands except TURN which will always return a not implemented |
30 | * error. SMTP also provides some utility methods for sending mail |
31 | * to an SMTP server. |
32 | * @package PHPMailer |
33 | * @author Chris Ryan |
34 | */ |
35 | |
36 | class SMTP |
37 | { |
38 | /** |
39 | * SMTP server port |
40 | * @var int |
41 | */ |
42 | var $SMTP_PORT = 25; |
43 | |
44 | /** |
45 | * SMTP reply line ending |
46 | * @var string |
47 | */ |
48 | var $CRLF = "\r\n"; |
49 | |
50 | /** |
51 | * Sets whether debugging is turned on |
52 | * @var bool |
53 | */ |
54 | var $do_debug; # the level of debug to perform |
55 | |
56 | /** |
57 | * Sets VERP use on/off (default is off) |
58 | * @var bool |
59 | */ |
60 | var $do_verp = false; |
61 | |
62 | /**#@+ |
63 | * @access private |
64 | */ |
65 | var $smtp_conn; # the socket to the server |
66 | var $error; # error if any on the last call |
67 | var $helo_rply; # the reply the server sent to us for HELO |
68 | /**#@-*/ |
69 | |
70 | /** |
71 | * Initialize the class so that the data is in a known state. |
72 | * @access public |
73 | * @return void |
74 | */ |
75 | function SMTP() { |
76 | $this->smtp_conn = 0; |
77 | $this->error = null; |
78 | $this->helo_rply = null; |
79 | |
80 | $this->do_debug = 0; |
81 | } |
82 | |
83 | /************************************************************* |
84 | * CONNECTION FUNCTIONS * |
85 | ***********************************************************/ |
86 | |
87 | /** |
88 | * Connect to the server specified on the port specified. |
89 | * If the port is not specified use the default SMTP_PORT. |
90 | * If tval is specified then a connection will try and be |
91 | * established with the server for that number of seconds. |
92 | * If tval is not specified the default is 30 seconds to |
93 | * try on the connection. |
94 | * |
95 | * SMTP CODE SUCCESS: 220 |
96 | * SMTP CODE FAILURE: 421 |
97 | * @access public |
98 | * @return bool |
99 | */ |
100 | function Connect($host,$port=0,$tval=30) { |
101 | # set the error val to null so there is no confusion |
102 | $this->error = null; |
103 | |
104 | # make sure we are __not__ connected |
105 | if($this->connected()) { |
106 | # ok we are connected! what should we do? |
107 | # for now we will just give an error saying we |
108 | # are already connected |
109 | $this->error = array("error" => "Already connected to a server"); |
110 | return false; |
111 | } |
112 | |
113 | if(empty($port)) { |
114 | $port = $this->SMTP_PORT; |
115 | } |
116 | |
117 | #connect to the smtp server |
118 | $this->smtp_conn = fsockopen($host, # the host of the server |
119 | $port, # the port to use |
120 | $errno, # error number if any |
121 | $errstr, # error message if any |
122 | $tval); # give up after ? secs |
123 | # verify we connected properly |
124 | if(empty($this->smtp_conn)) { |
125 | $this->error = array("error" => "Failed to connect to server", |
126 | "errno" => $errno, |
127 | "errstr" => $errstr); |
128 | if($this->do_debug >= 1) { |
129 | echo "SMTP -> ERROR: " . $this->error["error"] . |
130 | ": $errstr ($errno)" . $this->CRLF; |
131 | } |
132 | return false; |
133 | } |
134 | |
135 | # sometimes the SMTP server takes a little longer to respond |
136 | # so we will give it a longer timeout for the first read |
137 | // Windows still does not have support for this timeout function |
138 | if(substr(PHP_OS, 0, 3) != "WIN") |
139 | socket_set_timeout($this->smtp_conn, $tval, 0); |
140 | |
141 | # get any announcement stuff |
142 | $announce = $this->get_lines(); |
143 | |
144 | # set the timeout of any socket functions at 1/10 of a second |
145 | //if(function_exists("socket_set_timeout")) |
146 | // socket_set_timeout($this->smtp_conn, 0, 100000); |
147 | |
148 | if($this->do_debug >= 2) { |
149 | echo "SMTP -> FROM SERVER:" . $this->CRLF . $announce; |
150 | } |
151 | |
152 | return true; |
153 | } |
154 | |
155 | /** |
156 | * Performs SMTP authentication. Must be run after running the |
157 | * Hello() method. Returns true if successfully authenticated. |
158 | * @access public |
159 | * @return bool |
160 | */ |
161 | function Authenticate($username, $password) { |
162 | // Start authentication |
163 | fputs($this->smtp_conn,"AUTH LOGIN" . $this->CRLF); |
164 | |
165 | $rply = $this->get_lines(); |
166 | $code = substr($rply,0,3); |
167 | |
168 | if($code != 334) { |
169 | $this->error = |
170 | array("error" => "AUTH not accepted from server", |
171 | "smtp_code" => $code, |
172 | "smtp_msg" => substr($rply,4)); |
173 | if($this->do_debug >= 1) { |
174 | echo "SMTP -> ERROR: " . $this->error["error"] . |
175 | ": " . $rply . $this->CRLF; |
176 | } |
177 | return false; |
178 | } |
179 | |
180 | // Send encoded username |
181 | fputs($this->smtp_conn, base64_encode($username) . $this->CRLF); |
182 | |
183 | $rply = $this->get_lines(); |
184 | $code = substr($rply,0,3); |
185 | |
186 | if($code != 334) { |
187 | $this->error = |
188 | array("error" => "Username not accepted from server", |
189 | "smtp_code" => $code, |
190 | "smtp_msg" => substr($rply,4)); |
191 | if($this->do_debug >= 1) { |
192 | echo "SMTP -> ERROR: " . $this->error["error"] . |
193 | ": " . $rply . $this->CRLF; |
194 | } |
195 | return false; |
196 | } |
197 | |
198 | // Send encoded password |
199 | fputs($this->smtp_conn, base64_encode($password) . $this->CRLF); |
200 | |
201 | $rply = $this->get_lines(); |
202 | $code = substr($rply,0,3); |
203 | |
204 | if($code != 235) { |
205 | $this->error = |
206 | array("error" => "Password not accepted from server", |
207 | "smtp_code" => $code, |
208 | "smtp_msg" => substr($rply,4)); |
209 | if($this->do_debug >= 1) { |
210 | echo "SMTP -> ERROR: " . $this->error["error"] . |
211 | ": " . $rply . $this->CRLF; |
212 | } |
213 | return false; |
214 | } |
215 | |
216 | return true; |
217 | } |
218 | |
219 | /** |
220 | * Returns true if connected to a server otherwise false |
221 | * @access private |
222 | * @return bool |
223 | */ |
224 | function Connected() { |
225 | if(!empty($this->smtp_conn)) { |
226 | $sock_status = socket_get_status($this->smtp_conn); |
227 | if($sock_status["eof"]) { |
228 | # hmm this is an odd situation... the socket is |
229 | # valid but we are not connected anymore |
230 | if($this->do_debug >= 1) { |
231 | echo "SMTP -> NOTICE:" . $this->CRLF . |
232 | "EOF caught while checking if connected"; |
233 | } |
234 | $this->Close(); |
235 | return false; |
236 | } |
237 | return true; # everything looks good |
238 | } |
239 | return false; |
240 | } |
241 | |
242 | /** |
243 | * Closes the socket and cleans up the state of the class. |
244 | * It is not considered good to use this function without |
245 | * first trying to use QUIT. |
246 | * @access public |
247 | * @return void |
248 | */ |
249 | function Close() { |
250 | $this->error = null; # so there is no confusion |
251 | $this->helo_rply = null; |
252 | if(!empty($this->smtp_conn)) { |
253 | # close the connection and cleanup |
254 | fclose($this->smtp_conn); |
255 | $this->smtp_conn = 0; |
256 | } |
257 | } |
258 | |
259 | /*************************************************************** |
260 | * SMTP COMMANDS * |
261 | *************************************************************/ |
262 | |
263 | /** |
264 | * Issues a data command and sends the msg_data to the server |
265 | * finializing the mail transaction. $msg_data is the message |
266 | * that is to be send with the headers. Each header needs to be |
267 | * on a single line followed by a <CRLF> with the message headers |
268 | * and the message body being seperated by and additional <CRLF>. |
269 | * |
270 | * Implements rfc 821: DATA <CRLF> |
271 | * |
272 | * SMTP CODE INTERMEDIATE: 354 |
273 | * [data] |
274 | * <CRLF>.<CRLF> |
275 | * SMTP CODE SUCCESS: 250 |
276 | * SMTP CODE FAILURE: 552,554,451,452 |
277 | * SMTP CODE FAILURE: 451,554 |
278 | * SMTP CODE ERROR : 500,501,503,421 |
279 | * @access public |
280 | * @return bool |
281 | */ |
282 | function Data($msg_data) { |
283 | $this->error = null; # so no confusion is caused |
284 | |
285 | if(!$this->connected()) { |
286 | $this->error = array( |
287 | "error" => "Called Data() without being connected"); |
288 | return false; |
289 | } |
290 | |
291 | fputs($this->smtp_conn,"DATA" . $this->CRLF); |
292 | |
293 | $rply = $this->get_lines(); |
294 | $code = substr($rply,0,3); |
295 | |
296 | if($this->do_debug >= 2) { |
297 | echo "SMTP -> FROM SERVER:" . $this->CRLF . $rply; |
298 | } |
299 | |
300 | if($code != 354) { |
301 | $this->error = |
302 | array("error" => "DATA command not accepted from server", |
303 | "smtp_code" => $code, |
304 | "smtp_msg" => substr($rply,4)); |
305 | if($this->do_debug >= 1) { |
306 | echo "SMTP -> ERROR: " . $this->error["error"] . |
307 | ": " . $rply . $this->CRLF; |
308 | } |
309 | return false; |
310 | } |
311 | |
312 | # the server is ready to accept data! |
313 | # according to rfc 821 we should not send more than 1000 |
314 | # including the CRLF |
315 | # characters on a single line so we will break the data up |
316 | # into lines by \r and/or \n then if needed we will break |
317 | # each of those into smaller lines to fit within the limit. |
318 | # in addition we will be looking for lines that start with |
319 | # a period '.' and append and additional period '.' to that |
320 | # line. NOTE: this does not count towards are limit. |
321 | |
322 | # normalize the line breaks so we know the explode works |
323 | $msg_data = str_replace("\r\n","\n",$msg_data); |
324 | $msg_data = str_replace("\r","\n",$msg_data); |
325 | $lines = explode("\n",$msg_data); |
326 | |
327 | # we need to find a good way to determine is headers are |
328 | # in the msg_data or if it is a straight msg body |
329 | # currently I am assuming rfc 822 definitions of msg headers |
330 | # and if the first field of the first line (':' sperated) |
331 | # does not contain a space then it _should_ be a header |
332 | # and we can process all lines before a blank "" line as |
333 | # headers. |
334 | $field = substr($lines[0],0,strpos($lines[0],":")); |
335 | $in_headers = false; |
336 | if(!empty($field) && !strstr($field," ")) { |
337 | $in_headers = true; |
338 | } |
339 | |
340 | $max_line_length = 998; # used below; set here for ease in change |
341 | |
342 | while(list(,$line) = @each($lines)) { |
343 | $lines_out = null; |
344 | if($line == "" && $in_headers) { |
345 | $in_headers = false; |
346 | } |
347 | # ok we need to break this line up into several |
348 | # smaller lines |
349 | while(strlen($line) > $max_line_length) { |
350 | $pos = strrpos(substr($line,0,$max_line_length)," "); |
351 | |
352 | # Patch to fix DOS attack |
353 | if(!$pos) { |
354 | $pos = $max_line_length - 1; |
355 | } |
356 | |
357 | $lines_out[] = substr($line,0,$pos); |
358 | $line = substr($line,$pos + 1); |
359 | # if we are processing headers we need to |
360 | # add a LWSP-char to the front of the new line |
361 | # rfc 822 on long msg headers |
362 | if($in_headers) { |
363 | $line = "\t" . $line; |
364 | } |
365 | } |
366 | $lines_out[] = $line; |
367 | |
368 | # now send the lines to the server |
369 | while(list(,$line_out) = @each($lines_out)) { |
370 | if(strlen($line_out) > 0) |
371 | { |
372 | if(substr($line_out, 0, 1) == ".") { |
373 | $line_out = "." . $line_out; |
374 | } |
375 | } |
376 | fputs($this->smtp_conn,$line_out . $this->CRLF); |
377 | } |
378 | } |
379 | |
380 | # ok all the message data has been sent so lets get this |
381 | # over with aleady |
382 | fputs($this->smtp_conn, $this->CRLF . "." . $this->CRLF); |
383 | |
384 | $rply = $this->get_lines(); |
385 | $code = substr($rply,0,3); |
386 | |
387 | if($this->do_debug >= 2) { |
388 | echo "SMTP -> FROM SERVER:" . $this->CRLF . $rply; |
389 | } |
390 | |
391 | if($code != 250) { |
392 | $this->error = |
393 | array("error" => "DATA not accepted from server", |
394 | "smtp_code" => $code, |
395 | "smtp_msg" => substr($rply,4)); |
396 | if($this->do_debug >= 1) { |
397 | echo "SMTP -> ERROR: " . $this->error["error"] . |
398 | ": " . $rply . $this->CRLF; |
399 | } |
400 | return false; |
401 | } |
402 | return true; |
403 | } |
404 | |
405 | /** |
406 | * Expand takes the name and asks the server to list all the |
407 | * people who are members of the _list_. Expand will return |
408 | * back and array of the result or false if an error occurs. |
409 | * Each value in the array returned has the format of: |
410 | * [ <full-name> <sp> ] <path> |
411 | * The definition of <path> is defined in rfc 821 |
412 | * |
413 | * Implements rfc 821: EXPN <SP> <string> <CRLF> |
414 | * |
415 | * SMTP CODE SUCCESS: 250 |
416 | * SMTP CODE FAILURE: 550 |
417 | * SMTP CODE ERROR : 500,501,502,504,421 |
418 | * @access public |
419 | * @return string array |
420 | */ |
421 | function Expand($name) { |
422 | $this->error = null; # so no confusion is caused |
423 | |
424 | if(!$this->connected()) { |
425 | $this->error = array( |
426 | "error" => "Called Expand() without being connected"); |
427 | return false; |
428 | } |
429 | |
430 | fputs($this->smtp_conn,"EXPN " . $name . $this->CRLF); |
431 | |
432 | $rply = $this->get_lines(); |
433 | $code = substr($rply,0,3); |
434 | |
435 | if($this->do_debug >= 2) { |
436 | echo "SMTP -> FROM SERVER:" . $this->CRLF . $rply; |
437 | } |
438 | |
439 | if($code != 250) { |
440 | $this->error = |
441 | array("error" => "EXPN not accepted from server", |
442 | "smtp_code" => $code, |
443 | "smtp_msg" => substr($rply,4)); |
444 | if($this->do_debug >= 1) { |
445 | echo "SMTP -> ERROR: " . $this->error["error"] . |
446 | ": " . $rply . $this->CRLF; |
447 | } |
448 | return false; |
449 | } |
450 | |
451 | # parse the reply and place in our array to return to user |
452 | $entries = explode($this->CRLF,$rply); |
453 | while(list(,$l) = @each($entries)) { |
454 | $list[] = substr($l,4); |
455 | } |
456 | |
457 | return $list; |
458 | } |
459 | |
460 | /** |
461 | * Sends the HELO command to the smtp server. |
462 | * This makes sure that we and the server are in |
463 | * the same known state. |
464 | * |
465 | * Implements from rfc 821: HELO <SP> <domain> <CRLF> |
466 | * |
467 | * SMTP CODE SUCCESS: 250 |
468 | * SMTP CODE ERROR : 500, 501, 504, 421 |
469 | * @access public |
470 | * @return bool |
471 | */ |
472 | function Hello($host="") { |
473 | $this->error = null; # so no confusion is caused |
474 | |
475 | if(!$this->connected()) { |
476 | $this->error = array( |
477 | "error" => "Called Hello() without being connected"); |
478 | return false; |
479 | } |
480 | |
481 | # if a hostname for the HELO was not specified determine |
482 | # a suitable one to send |
483 | if(empty($host)) { |
484 | # we need to determine some sort of appopiate default |
485 | # to send to the server |
486 | $host = "localhost"; |
487 | } |
488 | |
489 | // Send extended hello first (RFC 2821) |
490 | if(!$this->SendHello("EHLO", $host)) |
491 | { |
492 | if(!$this->SendHello("HELO", $host)) |
493 | return false; |
494 | } |
495 | |
496 | return true; |
497 | } |
498 | |
499 | /** |
500 | * Sends a HELO/EHLO command. |
501 | * @access private |
502 | * @return bool |
503 | */ |
504 | function SendHello($hello, $host) { |
505 | fputs($this->smtp_conn, $hello . " " . $host . $this->CRLF); |
506 | |
507 | $rply = $this->get_lines(); |
508 | $code = substr($rply,0,3); |
509 | |
510 | if($this->do_debug >= 2) { |
511 | echo "SMTP -> FROM SERVER: " . $this->CRLF . $rply; |
512 | } |
513 | |
514 | if($code != 250) { |
515 | $this->error = |
516 | array("error" => $hello . " not accepted from server", |
517 | "smtp_code" => $code, |
518 | "smtp_msg" => substr($rply,4)); |
519 | if($this->do_debug >= 1) { |
520 | echo "SMTP -> ERROR: " . $this->error["error"] . |
521 | ": " . $rply . $this->CRLF; |
522 | } |
523 | return false; |
524 | } |
525 | |
526 | $this->helo_rply = $rply; |
527 | |
528 | return true; |
529 | } |
530 | |
531 | /** |
532 | * Gets help information on the keyword specified. If the keyword |
533 | * is not specified then returns generic help, ussually contianing |
534 | * A list of keywords that help is available on. This function |
535 | * returns the results back to the user. It is up to the user to |
536 | * handle the returned data. If an error occurs then false is |
537 | * returned with $this->error set appropiately. |
538 | * |
539 | * Implements rfc 821: HELP [ <SP> <string> ] <CRLF> |
540 | * |
541 | * SMTP CODE SUCCESS: 211,214 |
542 | * SMTP CODE ERROR : 500,501,502,504,421 |
543 | * @access public |
544 | * @return string |
545 | */ |
546 | function Help($keyword="") { |
547 | $this->error = null; # to avoid confusion |
548 | |
549 | if(!$this->connected()) { |
550 | $this->error = array( |
551 | "error" => "Called Help() without being connected"); |
552 | return false; |
553 | } |
554 | |
555 | $extra = ""; |
556 | if(!empty($keyword)) { |
557 | $extra = " " . $keyword; |
558 | } |
559 | |
560 | fputs($this->smtp_conn,"HELP" . $extra . $this->CRLF); |
561 | |
562 | $rply = $this->get_lines(); |
563 | $code = substr($rply,0,3); |
564 | |
565 | if($this->do_debug >= 2) { |
566 | echo "SMTP -> FROM SERVER:" . $this->CRLF . $rply; |
567 | } |
568 | |
569 | if($code != 211 && $code != 214) { |
570 | $this->error = |
571 | array("error" => "HELP not accepted from server", |
572 | "smtp_code" => $code, |
573 | "smtp_msg" => substr($rply,4)); |
574 | if($this->do_debug >= 1) { |
575 | echo "SMTP -> ERROR: " . $this->error["error"] . |
576 | ": " . $rply . $this->CRLF; |
577 | } |
578 | return false; |
579 | } |
580 | |
581 | return $rply; |
582 | } |
583 | |
584 | /** |
585 | * Starts a mail transaction from the email address specified in |
586 | * $from. Returns true if successful or false otherwise. If True |
587 | * the mail transaction is started and then one or more Recipient |
588 | * commands may be called followed by a Data command. |
589 | * |
590 | * Implements rfc 821: MAIL <SP> FROM:<reverse-path> <CRLF> |
591 | * |
592 | * SMTP CODE SUCCESS: 250 |
593 | * SMTP CODE SUCCESS: 552,451,452 |
594 | * SMTP CODE SUCCESS: 500,501,421 |
595 | * @access public |
596 | * @return bool |
597 | */ |
598 | function Mail($from) { |
599 | $this->error = null; # so no confusion is caused |
600 | |
601 | if(!$this->connected()) { |
602 | $this->error = array( |
603 | "error" => "Called Mail() without being connected"); |
604 | return false; |
605 | } |
606 | |
607 | $useVerp = ($this->do_verp ? "XVERP" : ""); |
608 | fputs($this->smtp_conn,"MAIL FROM:<" . $from . ">" . $useVerp . $this->CRLF); |
609 | |
610 | $rply = $this->get_lines(); |
611 | $code = substr($rply,0,3); |
612 | |
613 | if($this->do_debug >= 2) { |
614 | echo "SMTP -> FROM SERVER:" . $this->CRLF . $rply; |
615 | } |
616 | |
617 | if($code != 250) { |
618 | $this->error = |
619 | array("error" => "MAIL not accepted from server", |
620 | "smtp_code" => $code, |
621 | "smtp_msg" => substr($rply,4)); |
622 | if($this->do_debug >= 1) { |
623 | echo "SMTP -> ERROR: " . $this->error["error"] . |
624 | ": " . $rply . $this->CRLF; |
625 | } |
626 | return false; |
627 | } |
628 | return true; |
629 | } |
630 | |
631 | /** |
632 | * Sends the command NOOP to the SMTP server. |
633 | * |
634 | * Implements from rfc 821: NOOP <CRLF> |
635 | * |
636 | * SMTP CODE SUCCESS: 250 |
637 | * SMTP CODE ERROR : 500, 421 |
638 | * @access public |
639 | * @return bool |
640 | */ |
641 | function Noop() { |
642 | $this->error = null; # so no confusion is caused |
643 | |
644 | if(!$this->connected()) { |
645 | $this->error = array( |
646 | "error" => "Called Noop() without being connected"); |
647 | return false; |
648 | } |
649 | |
650 | fputs($this->smtp_conn,"NOOP" . $this->CRLF); |
651 | |
652 | $rply = $this->get_lines(); |
653 | $code = substr($rply,0,3); |
654 | |
655 | if($this->do_debug >= 2) { |
656 | echo "SMTP -> FROM SERVER:" . $this->CRLF . $rply; |
657 | } |
658 | |
659 | if($code != 250) { |
660 | $this->error = |
661 | array("error" => "NOOP not accepted from server", |
662 | "smtp_code" => $code, |
663 | "smtp_msg" => substr($rply,4)); |
664 | if($this->do_debug >= 1) { |
665 | echo "SMTP -> ERROR: " . $this->error["error"] . |
666 | ": " . $rply . $this->CRLF; |
667 | } |
668 | return false; |
669 | } |
670 | return true; |
671 | } |
672 | |
673 | /** |
674 | * Sends the quit command to the server and then closes the socket |
675 | * if there is no error or the $close_on_error argument is true. |
676 | * |
677 | * Implements from rfc 821: QUIT <CRLF> |
678 | * |
679 | * SMTP CODE SUCCESS: 221 |
680 | * SMTP CODE ERROR : 500 |
681 | * @access public |
682 | * @return bool |
683 | */ |
684 | function Quit($close_on_error=true) { |
685 | $this->error = null; # so there is no confusion |
686 | |
687 | if(!$this->connected()) { |
688 | $this->error = array( |
689 | "error" => "Called Quit() without being connected"); |
690 | return false; |
691 | } |
692 | |
693 | # send the quit command to the server |
694 | fputs($this->smtp_conn,"quit" . $this->CRLF); |
695 | |
696 | # get any good-bye messages |
697 | $byemsg = $this->get_lines(); |
698 | |
699 | if($this->do_debug >= 2) { |
700 | echo "SMTP -> FROM SERVER:" . $this->CRLF . $byemsg; |
701 | } |
702 | |
703 | $rval = true; |
704 | $e = null; |
705 | |
706 | $code = substr($byemsg,0,3); |
707 | if($code != 221) { |
708 | # use e as a tmp var cause Close will overwrite $this->error |
709 | $e = array("error" => "SMTP server rejected quit command", |
710 | "smtp_code" => $code, |
711 | "smtp_rply" => substr($byemsg,4)); |
712 | $rval = false; |
713 | if($this->do_debug >= 1) { |
714 | echo "SMTP -> ERROR: " . $e["error"] . ": " . |
715 | $byemsg . $this->CRLF; |
716 | } |
717 | } |
718 | |
719 | if(empty($e) || $close_on_error) { |
720 | $this->Close(); |
721 | } |
722 | |
723 | return $rval; |
724 | } |
725 | |
726 | /** |
727 | * Sends the command RCPT to the SMTP server with the TO: argument of $to. |
728 | * Returns true if the recipient was accepted false if it was rejected. |
729 | * |
730 | * Implements from rfc 821: RCPT <SP> TO:<forward-path> <CRLF> |
731 | * |
732 | * SMTP CODE SUCCESS: 250,251 |
733 | * SMTP CODE FAILURE: 550,551,552,553,450,451,452 |
734 | * SMTP CODE ERROR : 500,501,503,421 |
735 | * @access public |
736 | * @return bool |
737 | */ |
738 | function Recipient($to) { |
739 | $this->error = null; # so no confusion is caused |
740 | |
741 | if(!$this->connected()) { |
742 | $this->error = array( |
743 | "error" => "Called Recipient() without being connected"); |
744 | return false; |
745 | } |
746 | |
747 | fputs($this->smtp_conn,"RCPT TO:<" . $to . ">" . $this->CRLF); |
748 | |
749 | $rply = $this->get_lines(); |
750 | $code = substr($rply,0,3); |
751 | |
752 | if($this->do_debug >= 2) { |
753 | echo "SMTP -> FROM SERVER:" . $this->CRLF . $rply; |
754 | } |
755 | |
756 | if($code != 250 && $code != 251) { |
757 | $this->error = |
758 | array("error" => "RCPT not accepted from server", |
759 | "smtp_code" => $code, |
760 | "smtp_msg" => substr($rply,4)); |
761 | if($this->do_debug >= 1) { |
762 | echo "SMTP -> ERROR: " . $this->error["error"] . |
763 | ": " . $rply . $this->CRLF; |
764 | } |
765 | return false; |
766 | } |
767 | return true; |
768 | } |
769 | |
770 | /** |
771 | * Sends the RSET command to abort and transaction that is |
772 | * currently in progress. Returns true if successful false |
773 | * otherwise. |
774 | * |
775 | * Implements rfc 821: RSET <CRLF> |
776 | * |
777 | * SMTP CODE SUCCESS: 250 |
778 | * SMTP CODE ERROR : 500,501,504,421 |
779 | * @access public |
780 | * @return bool |
781 | */ |
782 | function Reset() { |
783 | $this->error = null; # so no confusion is caused |
784 | |
785 | if(!$this->connected()) { |
786 | $this->error = array( |
787 | "error" => "Called Reset() without being connected"); |
788 | return false; |
789 | } |
790 | |
791 | fputs($this->smtp_conn,"RSET" . $this->CRLF); |
792 | |
793 | $rply = $this->get_lines(); |
794 | $code = substr($rply,0,3); |
795 | |
796 | if($this->do_debug >= 2) { |
797 | echo "SMTP -> FROM SERVER:" . $this->CRLF . $rply; |
798 | } |
799 | |
800 | if($code != 250) { |
801 | $this->error = |
802 | array("error" => "RSET failed", |
803 | "smtp_code" => $code, |
804 | "smtp_msg" => substr($rply,4)); |
805 | if($this->do_debug >= 1) { |
806 | echo "SMTP -> ERROR: " . $this->error["error"] . |
807 | ": " . $rply . $this->CRLF; |
808 | } |
809 | return false; |
810 | } |
811 | |
812 | return true; |
813 | } |
814 | |
815 | /** |
816 | * Starts a mail transaction from the email address specified in |
817 | * $from. Returns true if successful or false otherwise. If True |
818 | * the mail transaction is started and then one or more Recipient |
819 | * commands may be called followed by a Data command. This command |
820 | * will send the message to the users terminal if they are logged |
821 | * in. |
822 | * |
823 | * Implements rfc 821: SEND <SP> FROM:<reverse-path> <CRLF> |
824 | * |
825 | * SMTP CODE SUCCESS: 250 |
826 | * SMTP CODE SUCCESS: 552,451,452 |
827 | * SMTP CODE SUCCESS: 500,501,502,421 |
828 | * @access public |
829 | * @return bool |
830 | */ |
831 | function Send($from) { |
832 | $this->error = null; # so no confusion is caused |
833 | |
834 | if(!$this->connected()) { |
835 | $this->error = array( |
836 | "error" => "Called Send() without being connected"); |
837 | return false; |
838 | } |
839 | |
840 | fputs($this->smtp_conn,"SEND FROM:" . $from . $this->CRLF); |
841 | |
842 | $rply = $this->get_lines(); |
843 | $code = substr($rply,0,3); |
844 | |
845 | if($this->do_debug >= 2) { |
846 | echo "SMTP -> FROM SERVER:" . $this->CRLF . $rply; |
847 | } |
848 | |
849 | if($code != 250) { |
850 | $this->error = |
851 | array("error" => "SEND not accepted from server", |
852 | "smtp_code" => $code, |
853 | "smtp_msg" => substr($rply,4)); |
854 | if($this->do_debug >= 1) { |
855 | echo "SMTP -> ERROR: " . $this->error["error"] . |
856 | ": " . $rply . $this->CRLF; |
857 | } |
858 | return false; |
859 | } |
860 | return true; |
861 | } |
862 | |
863 | /** |
864 | * Starts a mail transaction from the email address specified in |
865 | * $from. Returns true if successful or false otherwise. If True |
866 | * the mail transaction is started and then one or more Recipient |
867 | * commands may be called followed by a Data command. This command |
868 | * will send the message to the users terminal if they are logged |
869 | * in and send them an email. |
870 | * |
871 | * Implements rfc 821: SAML <SP> FROM:<reverse-path> <CRLF> |
872 | * |
873 | * SMTP CODE SUCCESS: 250 |
874 | * SMTP CODE SUCCESS: 552,451,452 |
875 | * SMTP CODE SUCCESS: 500,501,502,421 |
876 | * @access public |
877 | * @return bool |
878 | */ |
879 | function SendAndMail($from) { |
880 | $this->error = null; # so no confusion is caused |
881 | |
882 | if(!$this->connected()) { |
883 | $this->error = array( |
884 | "error" => "Called SendAndMail() without being connected"); |
885 | return false; |
886 | } |
887 | |
888 | fputs($this->smtp_conn,"SAML FROM:" . $from . $this->CRLF); |
889 | |
890 | $rply = $this->get_lines(); |
891 | $code = substr($rply,0,3); |
892 | |
893 | if($this->do_debug >= 2) { |
894 | echo "SMTP -> FROM SERVER:" . $this->CRLF . $rply; |
895 | } |
896 | |
897 | if($code != 250) { |
898 | $this->error = |
899 | array("error" => "SAML not accepted from server", |
900 | "smtp_code" => $code, |
901 | "smtp_msg" => substr($rply,4)); |
902 | if($this->do_debug >= 1) { |
903 | echo "SMTP -> ERROR: " . $this->error["error"] . |
904 | ": " . $rply . $this->CRLF; |
905 | } |
906 | return false; |
907 | } |
908 | return true; |
909 | } |
910 | |
911 | /** |
912 | * Starts a mail transaction from the email address specified in |
913 | * $from. Returns true if successful or false otherwise. If True |
914 | * the mail transaction is started and then one or more Recipient |
915 | * commands may be called followed by a Data command. This command |
916 | * will send the message to the users terminal if they are logged |
917 | * in or mail it to them if they are not. |
918 | * |
919 | * Implements rfc 821: SOML <SP> FROM:<reverse-path> <CRLF> |
920 | * |
921 | * SMTP CODE SUCCESS: 250 |
922 | * SMTP CODE SUCCESS: 552,451,452 |
923 | * SMTP CODE SUCCESS: 500,501,502,421 |
924 | * @access public |
925 | * @return bool |
926 | */ |
927 | function SendOrMail($from) { |
928 | $this->error = null; # so no confusion is caused |
929 | |
930 | if(!$this->connected()) { |
931 | $this->error = array( |
932 | "error" => "Called SendOrMail() without being connected"); |
933 | return false; |
934 | } |
935 | |
936 | fputs($this->smtp_conn,"SOML FROM:" . $from . $this->CRLF); |
937 | |
938 | $rply = $this->get_lines(); |
939 | $code = substr($rply,0,3); |
940 | |
941 | if($this->do_debug >= 2) { |
942 | echo "SMTP -> FROM SERVER:" . $this->CRLF . $rply; |
943 | } |
944 | |
945 | if($code != 250) { |
946 | $this->error = |
947 | array("error" => "SOML not accepted from server", |
948 | "smtp_code" => $code, |
949 | "smtp_msg" => substr($rply,4)); |
950 | if($this->do_debug >= 1) { |
951 | echo "SMTP -> ERROR: " . $this->error["error"] . |
952 | ": " . $rply . $this->CRLF; |
953 | } |
954 | return false; |
955 | } |
956 | return true; |
957 | } |
958 | |
959 | /** |
960 | * This is an optional command for SMTP that this class does not |
961 | * support. This method is here to make the RFC821 Definition |
962 | * complete for this class and __may__ be implimented in the future |
963 | * |
964 | * Implements from rfc 821: TURN <CRLF> |
965 | * |
966 | * SMTP CODE SUCCESS: 250 |
967 | * SMTP CODE FAILURE: 502 |
968 | * SMTP CODE ERROR : 500, 503 |
969 | * @access public |
970 | * @return bool |
971 | */ |
972 | function Turn() { |
973 | $this->error = array("error" => "This method, TURN, of the SMTP ". |
974 | "is not implemented"); |
975 | if($this->do_debug >= 1) { |
976 | echo "SMTP -> NOTICE: " . $this->error["error"] . $this->CRLF; |
977 | } |
978 | return false; |
979 | } |
980 | |
981 | /** |
982 | * Verifies that the name is recognized by the server. |
983 | * Returns false if the name could not be verified otherwise |
984 | * the response from the server is returned. |
985 | * |
986 | * Implements rfc 821: VRFY <SP> <string> <CRLF> |
987 | * |
988 | * SMTP CODE SUCCESS: 250,251 |
989 | * SMTP CODE FAILURE: 550,551,553 |
990 | * SMTP CODE ERROR : 500,501,502,421 |
991 | * @access public |
992 | * @return int |
993 | */ |
994 | function Verify($name) { |
995 | $this->error = null; # so no confusion is caused |
996 | |
997 | if(!$this->connected()) { |
998 | $this->error = array( |
999 | "error" => "Called Verify() without being connected"); |
1000 | return false; |
1001 | } |
1002 | |
1003 | fputs($this->smtp_conn,"VRFY " . $name . $this->CRLF); |
1004 | |
1005 | $rply = $this->get_lines(); |
1006 | $code = substr($rply,0,3); |
1007 | |
1008 | if($this->do_debug >= 2) { |
1009 | echo "SMTP -> FROM SERVER:" . $this->CRLF . $rply; |
1010 | } |
1011 | |
1012 | if($code != 250 && $code != 251) { |
1013 | $this->error = |
1014 | array("error" => "VRFY failed on name '$name'", |
1015 | "smtp_code" => $code, |
1016 | "smtp_msg" => substr($rply,4)); |
1017 | if($this->do_debug >= 1) { |
1018 | echo "SMTP -> ERROR: " . $this->error["error"] . |
1019 | ": " . $rply . $this->CRLF; |
1020 | } |
1021 | return false; |
1022 | } |
1023 | return $rply; |
1024 | } |
1025 | |
1026 | /******************************************************************* |
1027 | * INTERNAL FUNCTIONS * |
1028 | ******************************************************************/ |
1029 | |
1030 | /** |
1031 | * Read in as many lines as possible |
1032 | * either before eof or socket timeout occurs on the operation. |
1033 | * With SMTP we can tell if we have more lines to read if the |
1034 | * 4th character is '-' symbol. If it is a space then we don't |
1035 | * need to read anything else. |
1036 | * @access private |
1037 | * @return string |
1038 | */ |
1039 | function get_lines() { |
1040 | $data = ""; |
1041 | while($str = @fgets($this->smtp_conn,515)) { |
1042 | if($this->do_debug >= 4) { |
1043 | echo "SMTP -> get_lines(): \$data was \"$data\"" . |
1044 | $this->CRLF; |
1045 | echo "SMTP -> get_lines(): \$str is \"$str\"" . |
1046 | $this->CRLF; |
1047 | } |
1048 | $data .= $str; |
1049 | if($this->do_debug >= 4) { |
1050 | echo "SMTP -> get_lines(): \$data is \"$data\"" . $this->CRLF; |
1051 | } |
1052 | # if the 4th character is a space then we are done reading |
1053 | # so just break the loop |
1054 | if(substr($str,3,1) == " ") { break; } |
1055 | } |
1056 | return $data; |
1057 | } |
1058 | |
1059 | } |
1060 | |
1061 | |
1062 | ?> |