forked from PHPMailer/PHPMailer
-
Notifications
You must be signed in to change notification settings - Fork 0
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Import PHPMailer 5.2.0 from apache project
- Loading branch information
Showing
63 changed files
with
7,418 additions
and
5,997 deletions.
There are no files selected for viewing
Large diffs are not rendered by default.
Oops, something went wrong.
Large diffs are not rendered by default.
Oops, something went wrong.
Large diffs are not rendered by default.
Oops, something went wrong.
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,17 @@ | ||
| NEW CALLBACK FUNCTION: | ||
| ====================== | ||
|
|
||
| We have had requests for a method to process the results of sending emails | ||
| through PHPMailer. In this new release, we have implemented a callback | ||
| function that passes the results of each email sent (to, cc, and/or bcc). | ||
| We have provided an example that echos the results back to the screen. The | ||
| callback function can be used for any purpose. With minor modifications, the | ||
| callback function can be used to create CSV logs, post results to databases, | ||
| etc. | ||
|
|
||
| Please review the test.php script for the example. | ||
|
|
||
| It's pretty straight forward. | ||
|
|
||
| Enjoy! | ||
| Andy |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,55 @@ | ||
| CREATE DKIM KEYS and DNS Resource Record: | ||
| ========================================= | ||
|
|
||
| To create DomainKeys Identified Mail keys, visit: | ||
| http://dkim.worxware.com/ | ||
| ... read the information, fill in the form, and download the ZIP file | ||
| containing the public key, private key, DNS Resource Record and instructions | ||
| to add to your DNS Zone Record, and the PHPMailer code to enable DKIM | ||
| digital signing. | ||
|
|
||
| /*** PROTECT YOUR PRIVATE & PUBLIC KEYS ***/ | ||
|
|
||
| You need to protect your DKIM private and public keys from being viewed or | ||
| accessed. Add protection to your .htaccess file as in this example: | ||
|
|
||
| # secure htkeyprivate file | ||
| <Files .htkeyprivate> | ||
| order allow,deny | ||
| deny from all | ||
| </Files> | ||
|
|
||
| # secure htkeypublic file | ||
| <Files .htkeypublic> | ||
| order allow,deny | ||
| deny from all | ||
| </Files> | ||
|
|
||
| (the actual .htaccess additions are in the ZIP file sent back to you from | ||
| http://dkim.worxware.com/ | ||
|
|
||
| A few notes on using DomainKey Identified Mail (DKIM): | ||
|
|
||
| You do not need to use PHPMailer to DKIM sign emails IF: | ||
| - you enable DomainKey support and add the DNS resource record | ||
| - you use your outbound mail server | ||
|
|
||
| If you are a third-party emailer that works on behalf of domain owners to | ||
| send their emails from your own server: | ||
| - you absolutely have to DKIM sign outbound emails | ||
| - the domain owner has to add the DNS resource record to match the | ||
| private key, public key, selector, identity, and domain that you create | ||
| - use caution with the "selector" ... at least one "selector" will already | ||
| exist in the DNS Zone Record of the domain at the domain owner's server | ||
| you need to ensure that the "selector" you use is unique | ||
| Note: since the IP address will not match the domain owner's DNS Zone record | ||
| you can be certain that email providers that validate based on DomainKey will | ||
| check the domain owner's DNS Zone record for your DNS resource record. Before | ||
| sending out emails on behalf of domain owners, ensure they have entered the | ||
| DNS resource record you provided them. | ||
|
|
||
| Enjoy! | ||
| Andy | ||
|
|
||
| PS. if you need additional information about DKIM, please see: | ||
| http://www.dkim.org/info/dkim-faq.html |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,23 @@ | ||
| If you are having problems connecting or sending emails through your SMTP server, please note: | ||
|
|
||
| 1. The new rewrite of class.smtp.php provides more information about the processing/errors taking place | ||
| 2. Use the debug functionality of class.smtp.php. To do that, in your own script add the debug level you wish to use. An example of that is: | ||
|
|
||
| $mail->SMTPDebug = 1; | ||
| $mail->IsSMTP(); // telling the class to use SMTP | ||
| $mail->SMTPAuth = true; // enable SMTP authentication | ||
| $mail->Port = 26; // set the SMTP port | ||
| $mail->Host = "mail.yourhost.com"; // SMTP server | ||
| $mail->Username = "name@yourhost.com"; // SMTP account username | ||
| $mail->Password = "your password"; // SMTP account password | ||
|
|
||
| Notes on this: | ||
| $mail->SMTPDebug = 0; ... will disable debugging (you can also leave this out completely, 0 is the default | ||
| $mail->SMTPDebug = 1; ... will echo errors and messages | ||
| $mail->SMTPDebug = 2; ... will echo messages only | ||
| ... and finally, the options are 0, 1, and 2 ... any number greater than 2 will be interpreted as 2 | ||
|
|
||
| And finally, don't forget to disable debugging before going into production. | ||
|
|
||
| Enjoy! | ||
| Andy |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,148 @@ | ||
| <html> | ||
| <head> | ||
| <title>Examples using phpmailer</title> | ||
| </head> | ||
|
|
||
| <body bgcolor="#FFFFFF"> | ||
|
|
||
| <h2>Examples using phpmailer</h2> | ||
|
|
||
| <h3>1. Advanced Example</h3> | ||
| <p> | ||
|
|
||
| This demonstrates sending out multiple email messages with binary attachments | ||
| from a MySQL database with multipart/alternative support.<p> | ||
| <table cellpadding="4" border="1" width="80%"> | ||
| <tr> | ||
| <td bgcolor="#CCCCCC"> | ||
| <pre> | ||
| require("class.phpmailer.php"); | ||
|
|
||
| $mail = new phpmailer(); | ||
|
|
||
| $mail->From = "list@example.com"; | ||
| $mail->FromName = "List manager"; | ||
| $mail->Host = "smtp1.example.com;smtp2.example.com"; | ||
| $mail->Mailer = "smtp"; | ||
|
|
||
| @MYSQL_CONNECT("localhost","root","password"); | ||
| @mysql_select_db("my_company"); | ||
| $query = "SELECT full_name, email, photo FROM employee WHERE id=$id"; | ||
| $result = @MYSQL_QUERY($query); | ||
|
|
||
| while ($row = mysql_fetch_array ($result)) | ||
| { | ||
| // HTML body | ||
| $body = "Hello <font size=\"4\">" . $row["full_name"] . "</font>, <p>"; | ||
| $body .= "<i>Your</i> personal photograph to this message.<p>"; | ||
| $body .= "Sincerely, <br>"; | ||
| $body .= "phpmailer List manager"; | ||
|
|
||
| // Plain text body (for mail clients that cannot read HTML) | ||
| $text_body = "Hello " . $row["full_name"] . ", \n\n"; | ||
| $text_body .= "Your personal photograph to this message.\n\n"; | ||
| $text_body .= "Sincerely, \n"; | ||
| $text_body .= "phpmailer List manager"; | ||
|
|
||
| $mail->Body = $body; | ||
| $mail->AltBody = $text_body; | ||
| $mail->AddAddress($row["email"], $row["full_name"]); | ||
| $mail->AddStringAttachment($row["photo"], "YourPhoto.jpg"); | ||
|
|
||
| if(!$mail->Send()) | ||
| echo "There has been a mail error sending to " . $row["email"] . "<br>"; | ||
|
|
||
| // Clear all addresses and attachments for next loop | ||
| $mail->ClearAddresses(); | ||
| $mail->ClearAttachments(); | ||
| } | ||
| </pre> | ||
| </td> | ||
| </tr> | ||
| </table> | ||
| <p> | ||
|
|
||
| <h3>2. Extending phpmailer</h3> | ||
| <p> | ||
|
|
||
| Extending classes with inheritance is one of the most | ||
| powerful features of object-oriented | ||
| programming. It allows you to make changes to the | ||
| original class for your | ||
| own personal use without hacking the original | ||
| classes. Plus, it is very | ||
| easy to do. I've provided an example: | ||
|
|
||
| <p> | ||
| Here's a class that extends the phpmailer class and sets the defaults | ||
| for the particular site:<br> | ||
| PHP include file: <b>mail.inc.php</b> | ||
| <p> | ||
|
|
||
| <table cellpadding="4" border="1" width="80%"> | ||
| <tr> | ||
| <td bgcolor="#CCCCCC"> | ||
| <pre> | ||
| require("class.phpmailer.php"); | ||
|
|
||
| class my_phpmailer extends phpmailer { | ||
| // Set default variables for all new objects | ||
| var $From = "from@example.com"; | ||
| var $FromName = "Mailer"; | ||
| var $Host = "smtp1.example.com;smtp2.example.com"; | ||
| var $Mailer = "smtp"; // Alternative to IsSMTP() | ||
| var $WordWrap = 75; | ||
|
|
||
| // Replace the default error_handler | ||
| function error_handler($msg) { | ||
| print("My Site Error"); | ||
| print("Description:"); | ||
| printf("%s", $msg); | ||
| exit; | ||
| } | ||
|
|
||
| // Create an additional function | ||
| function do_something($something) { | ||
| // Place your new code here | ||
| } | ||
| } | ||
| </td> | ||
| </tr> | ||
| </table> | ||
| <br> | ||
|
|
||
| Now here's a normal PHP page in the site, which will have all the defaults set | ||
| above:<br> | ||
| Normal PHP file: <b>mail_test.php</b> | ||
| <p> | ||
|
|
||
| <table cellpadding="4" border="1" width="80%"> | ||
| <tr> | ||
| <td bgcolor="#CCCCCC"> | ||
| <pre> | ||
| require("mail.inc.php"); | ||
|
|
||
| // Instantiate your new class | ||
| $mail = new my_phpmailer; | ||
|
|
||
| // Now you only need to add the necessary stuff | ||
| $mail->AddAddress("josh@example.com", "Josh Adams"); | ||
| $mail->Subject = "Here is the subject"; | ||
| $mail->Body = "This is the message body"; | ||
| $mail->AddAttachment("c:/temp/11-10-00.zip", "new_name.zip"); // optional name | ||
|
|
||
| if(!$mail->Send()) | ||
| { | ||
| echo "There was an error sending the message"; | ||
| exit; | ||
| } | ||
|
|
||
| echo "Message was sent successfully"; | ||
| </pre> | ||
| </td> | ||
| </tr> | ||
| </table> | ||
| </p> | ||
|
|
||
| </body> | ||
| </html> |
Oops, something went wrong.