phpCoreLib2
[ class tree: phpCoreLib2 ] [ index: phpCoreLib2 ] [ all elements ]

Class: DSMTPSendMail

Source Location: /Mails/DSmtpSendMail.php

Class Overview

DObject
   |
   --DMailingAbstract
      |
      --DSMTPSendMail

SMTP send mail class


Variables

Methods


Inherited Constants

Inherited Variables

Inherited Methods

Class: DMailingAbstract

DMailingAbstract::DMailingAbstract()
Constructor
DMailingAbstract::AddAddress()
Adds a "To" address.
DMailingAbstract::AddBCC()
Adds a "Bcc" address. Note: this function works with the SMTP mailer on win32, not with the "mail" mailer.
DMailingAbstract::AddCC()
Adds a "Cc" address. Note: this function works with the SMTP mailer on win32, not with the "mail" mailer.
DMailingAbstract::AddReplyTo()
Adds a "Reply-To" address.
DMailingAbstract::HeaderLine()
DMailingAbstract::_errorHandling()
Handling returned error

Class: DObject

DObject::__construct()
Constructor
DObject::debug()
Debig
DObject::getClassMembers()
Gets member variables of the instance
DObject::getClassMemberType()
Gets class member type
DObject::getClassMethods()
Gets classes of the class
DObject::getClassName()
Gets class name
DObject::PHPSerialize()
Gets serialized string of the class
DObject::trace()
Trace
DObject::__destruct()
Descructor
DObject::__toString()
Returns String equivalent of the object.

Class Details

[line 19]
SMTP send mail class



[ Top ]


Class Variables

$CRLF =  "\r\n"

[line 99]

SMTP reply line ending


Type:   string


[ Top ]

$doDebug =  0

[line 105]

Sets whether debugging is turned on


Type:   bool


[ Top ]

$doVerp =  false

[line 111]

Sets VERP use on/off (default is off)


Type:   bool


[ Top ]

$Helo =  ''

[line 46]

Sets the SMTP HELO of the message (Default is $Hostname).


Type:   string


[ Top ]

$Host =  'localhost'

[line 34]

Sets the SMTP hosts. All hosts must be separated by a semicolon. You can also specify a different port for each host by using this format: [hostname:port] (e.g. "smtp1.example.com:25;smtp2.example.com").

Hosts will be tried in order.



Type:   string


[ Top ]

$Password =  ''

[line 71]

Sets SMTP password.


Type:   string


[ Top ]

$Port =  25

[line 40]

Sets the default SMTP server port.


Type:   int


[ Top ]

$SingleTo =  false

[line 93]

Provides the ability to have the TO field process individual

emails, instead of sending to entire TO addresses



Type:   bool


[ Top ]

$SMTPAuth =  false

[line 59]

Sets SMTP authentication. Utilizes the Username and Password variables.


Type:   bool


[ Top ]

$SMTPKeepAlive =  false

[line 86]

Prevents the SMTP connection from being closed after each mail sending. If this is set to true then to close the connection requires an explicit call to SmtpClose().


Type:   bool


[ Top ]

$SMTPSecure =  ""

[line 53]

Sets connection prefix.

Options are "", "ssl" or "tls"



Type:   string


[ Top ]

$Timeout =  30

[line 78]

Sets the SMTP server timeout in seconds. This function will not work with the win32 version.


Type:   int


[ Top ]

$Username =  ''

[line 65]

Sets SMTP username.


Type:   string


[ Top ]



Class Methods


method Authenticate [line 205]

bool Authenticate( $username, $password)

Performs SMTP authentication. Must be run after running the Hello() method. Returns true if successfully authenticated.



Tags:

access:  public


Parameters:

   $username  
   $password  

[ Top ]

method Close [line 268]

void Close( )

Closes the socket and cleans up the state of the class.

It is not considered good to use this function without first trying to use QUIT.




Tags:

access:  public


[ Top ]

method Connect [line 150]

bool Connect( [ $host = ""], [ $port = 0], [ $tval = 0])

Connect to the server specified on the port specified.

If the port is not specified use the default SMTP_PORT. If tval is specified then a connection will try and be established with the server for that number of seconds. If tval is not specified the default is 30 seconds to try on the connection.

SMTP CODE SUCCESS: 220 SMTP CODE FAILURE: 421




Tags:

access:  public


Parameters:

   $host  
   $port  
   $tval  

[ Top ]

method Data [line 348]

bool Data( strng $header, string $body)

Issues a data command and sends the msg_data to the server

finializing the mail transaction. $msg_data is the message that is to be send with the headers. Each header needs to be on a single line followed by a <CRLF> with the message headers and the message body being seperated by and additional <CRLF>.

Implements rfc 821: DATA <CRLF>

SMTP CODE INTERMEDIATE: 354 [data] <CRLF>.<CRLF> SMTP CODE SUCCESS: 250 SMTP CODE FAILURE: 552,554,451,452 SMTP CODE FAILURE: 451,554 SMTP CODE ERROR : 500,501,503,421




Tags:

access:  public


Parameters:

strng   $header  
string   $body  

[ Top ]

method Expand [line 485]

string Expand( $name)

Expand takes the name and asks the server to list all the people who are members of the _list_. Expand will return back and array of the result or false if an error occurs.

Each value in the array returned has the format of: [ <full-name> <sp> ] <path> The definition of <path> is defined in rfc 821

Implements rfc 821: EXPN <SP> <string> <CRLF>

SMTP CODE SUCCESS: 250 SMTP CODE FAILURE: 550 SMTP CODE ERROR : 500,501,502,504,421




Tags:

return:  array
access:  public


Parameters:

   $name  

[ Top ]

method Hello [line 529]

bool Hello( [ $host = ""])

Sends the HELO command to the smtp server.

This makes sure that we and the server are in the same known state.

Implements from rfc 821: HELO <SP> <domain> <CRLF>

SMTP CODE SUCCESS: 250 SMTP CODE ERROR : 500, 501, 504, 421




Tags:

access:  public


Parameters:

   $host  

[ Top ]

method Help [line 590]

string Help( [ $keyword = ""])

Gets help information on the keyword specified. If the keyword

is not specified then returns generic help, ussually contianing A list of keywords that help is available on. This function returns the results back to the user. It is up to the user to handle the returned data. If an error occurs then false is returned with $this->error set appropiately.

Implements rfc 821: HELP [ <SP> <string> ] <CRLF>

SMTP CODE SUCCESS: 211,214 SMTP CODE ERROR : 500,501,502,504,421




Tags:

access:  public


Parameters:

   $keyword  

[ Top ]

method Mail [line 630]

bool Mail( $from)

Starts a mail transaction from the email address specified in $from. Returns true if successful or false otherwise. If True the mail transaction is started and then one or more Recipient commands may be called followed by a Data command.

Implements rfc 821: MAIL <SP> FROM:<reverse-path> <CRLF>

SMTP CODE SUCCESS: 250 SMTP CODE SUCCESS: 552,451,452 SMTP CODE SUCCESS: 500,501,421




Tags:

access:  public


Parameters:

   $from  

[ Top ]

method Noop [line 662]

bool Noop( )

Sends the command NOOP to the SMTP server.

Implements from rfc 821: NOOP <CRLF>

SMTP CODE SUCCESS: 250 SMTP CODE ERROR : 500, 421




Tags:

access:  public


[ Top ]

method Quit [line 694]

bool Quit( [ $close_on_error = true])

Sends the quit command to the server and then closes the socket if there is no error or the $close_on_error argument is true.

Implements from rfc 821: QUIT <CRLF>

SMTP CODE SUCCESS: 221 SMTP CODE ERROR : 500




Tags:

access:  public


Parameters:

   $close_on_error  

[ Top ]

method Recipient [line 737]

bool Recipient( $to)

Sends the command RCPT to the SMTP server with the TO: argument of $to.

Returns true if the recipient was accepted false if it was rejected.

Implements from rfc 821: RCPT <SP> TO:<forward-path> <CRLF>

SMTP CODE SUCCESS: 250,251 SMTP CODE FAILURE: 550,551,552,553,450,451,452 SMTP CODE ERROR : 500,501,503,421




Tags:

access:  public


Parameters:

   $to  

[ Top ]

method Reset [line 770]

bool Reset( )

Sends the RSET command to abort and transaction that is currently in progress. Returns true if successful false otherwise.

Implements rfc 821: RSET <CRLF>

SMTP CODE SUCCESS: 250 SMTP CODE ERROR : 500,501,504,421




Tags:

access:  public


[ Top ]

method Send [line 807]

bool Send( $from)

Starts a mail transaction from the email address specified in

$from. Returns true if successful or false otherwise. If True the mail transaction is started and then one or more Recipient commands may be called followed by a Data command. This command will send the message to the users terminal if they are logged in.

Implements rfc 821: SEND <SP> FROM:<reverse-path> <CRLF>

SMTP CODE SUCCESS: 250 SMTP CODE SUCCESS: 552,451,452 SMTP CODE SUCCESS: 500,501,502,421




Tags:

access:  public


Parameters:

   $from  

[ Top ]

method SendAndMail [line 844]

bool SendAndMail( $from)

Starts a mail transaction from the email address specified in

$from. Returns true if successful or false otherwise. If True the mail transaction is started and then one or more Recipient commands may be called followed by a Data command. This command will send the message to the users terminal if they are logged in and send them an email.

Implements rfc 821: SAML <SP> FROM:<reverse-path> <CRLF>

SMTP CODE SUCCESS: 250 SMTP CODE SUCCESS: 552,451,452 SMTP CODE SUCCESS: 500,501,502,421




Tags:

access:  public


Parameters:

   $from  

[ Top ]

method SendOrMail [line 881]

bool SendOrMail( $from)

Starts a mail transaction from the email address specified in

$from. Returns true if successful or false otherwise. If True the mail transaction is started and then one or more Recipient commands may be called followed by a Data command. This command will send the message to the users terminal if they are logged in or mail it to them if they are not.

Implements rfc 821: SOML <SP> FROM:<reverse-path> <CRLF>

SMTP CODE SUCCESS: 250 SMTP CODE SUCCESS: 552,451,452 SMTP CODE SUCCESS: 500,501,502,421




Tags:

access:  public


Parameters:

   $from  

[ Top ]

method SMTP [line 126]

void SMTP( )

Initialize the class so that the data is in a known state.



Tags:

access:  public


[ Top ]

method Turn [line 915]

bool Turn( )

This is an optional command for SMTP that this class does not support. This method is here to make the RFC821 Definition complete for this class and __may__ be implimented in the future

Implements from rfc 821: TURN <CRLF>

SMTP CODE SUCCESS: 250 SMTP CODE FAILURE: 502 SMTP CODE ERROR : 500, 503




Tags:

access:  public


[ Top ]

method Verify [line 933]

int Verify( $name)

Verifies that the name is recognized by the server.

Returns false if the name could not be verified otherwise the response from the server is returned.

Implements rfc 821: VRFY <SP> <string> <CRLF>

SMTP CODE SUCCESS: 250,251 SMTP CODE FAILURE: 550,551,553 SMTP CODE ERROR : 500,501,502,421




Tags:

access:  public


Parameters:

   $name  

[ Top ]

method _cutDataToLimit [line 288]

array _cutDataToLimit( string $data, &$retData, [int $maxLineLength = 998], [string $tabIdenx = ""], array $retData)

Function for cut data to require number of chars



Parameters:

string   $data  
array   $retData  
int   $maxLineLength  
string   $tabIdenx  
   &$retData  

[ Top ]

method _errorHandling [line 995]

void _errorHandling( [string $message = ""], [string $code = ""], [string $retError = ""], [int $debug = 0], [string $debugMsg = ''])

Handling returned error



Overrides DMailingAbstract::_errorHandling() (Handling returned error)

Parameters:

string   $message  
string   $code  
string   $retError  
int   $debug  
string   $debugMsg  

[ Top ]

method _normalizeMessageData [line 314]

array _normalizeMessageData( string $allData, [string $tabIndex = ""], [int $maxLineLength = 998])

Normalise data to send



Parameters:

string   $allData  
string   $tabIndex  
int   $maxLineLength  

[ Top ]


Documentation generated on Sat, 17 Apr 2010 22:12:27 +0300 by phpDocumentor 1.4.3